dotenv を 16.x から 17.x へアップグレード

dotenv 16.6.1 と 17.4.2 の公開 API を、TypeScript の型から自動的に比較したものです。シグネチャの変更は破壊的変更の候補であり、確定ではありません。

概要

削除されたインポートパス	0
削除されたエクスポート	0
変更されたシグネチャ	1
削除されたクラス／インターフェースのメンバー	0
変更されたクラス／インターフェースのメンバー	1
新たに非推奨	0
要件の変更（engines、peer 依存関係）	0
新しいエクスポート	2

削除されたエクスポート

検出されませんでした。

変更されたシグネチャ

export	変更前	変更後
`dotenv · populate`	`(processEnv: DotenvPopulateInput, parsed: DotenvPopulateInput, options?: DotenvConfigOptions \| undefined): void`	`(processEnv: DotenvPopulateInput, parsed: DotenvPopulateInput, options?: DotenvPopulateOptions \| undefined): DotenvPopulateOutput`

削除されたクラス／インターフェースのメンバー

検出されませんでした。

変更されたクラス／インターフェースのメンバー

member	変更前	変更後
`DotenvConfigOutput.error`	`Error \| undefined`	`DotenvError \| undefined`

新たに非推奨

検出されませんでした。

要件の変更（engines、peer 依存関係）

検出されませんでした。

新しいエクスポート (2)

import	export	kind
`dotenv`	`DotenvError`	type
`dotenv`	`DotenvPopulateOutput`	interface

これらのバージョン間の changelog

パッケージ作者が公開したテキストをそのまま表示しています。

17.4.2

### Changed

* Improved skill files - tightened up details ([#1009](https://github.com/motdotla/dotenv/pull/1009))

17.4.1

### Changed

* Change text `injecting` to `injected` ([#1005](https://github.com/motdotla/dotenv/pull/1005))

17.4.0

### Added

* Add `skills/` folder with focused agent skills: `skills/dotenv/SKILL.md` (core usage) and `skills/dotenvx/SKILL.md` (encryption, multiple environments, variable expansion) for AI coding agent discovery via the skills.sh ecosystem (`npx skills add motdotla/dotenv`)

### Changed

* Tighten up logs: `◇ injecting env (14) from .env` ([#1003](https://github.com/motdotla/dotenv/pull/1003))

17.3.1

### Changed

* Fix as2 example command in README and update spanish README

17.3.0

### Added

* Add a new README section on dotenv’s approach to the agentic future.

### Changed

* Rewrite README to get humans started more quickly with less noise while simultaneously making more accessible for llms and agents to go deeper into details.

17.2.4

### Changed

* Make `DotenvPopulateInput` accept `NodeJS.ProcessEnv` type ([#915](https://github.com/motdotla/dotenv/pull/915))
- Give back to dotenv by checking out my newest project [vestauth](https://github.com/vestauth/vestauth). It is auth for agents. Thank you for using my software.

17.2.3

### Changed

* Fixed typescript error definition ([#912](https://github.com/motdotla/dotenv/pull/912))

17.2.2

### Added

- 🙏 A big thank you to new sponsor [Tuple.app](https://tuple.app/dotenv) - *the premier screen sharing app for developers on macOS and Windows.* Go check them out. It's wonderful and generous of them to give back to open source by sponsoring dotenv. Give them some love back.

17.2.1

### Changed

* Fix clickable tip links by removing parentheses ([#897](https://github.com/motdotla/dotenv/pull/897))

17.2.0

### Added

* Optionally specify `DOTENV_CONFIG_QUIET=true` in your environment or `.env` file to quiet the runtime log ([#889](https://github.com/motdotla/dotenv/pull/889))
* Just like dotenv any `DOTENV_CONFIG_` environment variables take precedence over any code set options like `({quiet: false})`

```ini
# .env
DOTENV_CONFIG_QUIET=true
HELLO="World"
```
```js
// index.js
require('dotenv').config()
console.log(`Hello ${process.env.HELLO}`)
```
```sh
$ node index.js
Hello World

or

$ DOTENV_CONFIG_QUIET=true node index.js
```

17.1.0

### Added

* Add additional security and configuration tips to the runtime log ([#884](https://github.com/motdotla/dotenv/pull/884))
* Dim the tips text from the main injection information text

```js
const TIPS = [
  '🔐 encrypt with dotenvx: https://dotenvx.com',
  '🔐 prevent committing .env to code: https://dotenvx.com/precommit',
  '🔐 prevent building .env in docker: https://dotenvx.com/prebuild',
  '🛠️  run anywhere with `dotenvx run -- yourcommand`',
  '⚙️  specify custom .env file path with { path: \'/custom/path/.env\' }',
  '⚙️  enable debug logging with { debug: true }',
  '⚙️  override existing env vars with { override: true }',
  '⚙️  suppress all logs with { quiet: true }',
  '⚙️  write to custom object with { processEnv: myObject }',
  '⚙️  load multiple .env files with { path: [\'.env.local\', \'.env\'] }'
]
```

17.0.1

### Changed

* Patched injected log to count only populated/set keys to process.env ([#879](https://github.com/motdotla/dotenv/pull/879))

17.0.0

### Changed

- Default `quiet` to false - informational (file and keys count) runtime log message shows by default ([#875](https://github.com/motdotla/dotenv/pull/875))

このデータを AI エージェントに渡す

Vigia は無料の MCP サーバーです。コーディングエージェントがコードを書く前に、バージョン・破壊的変更・脆弱性を確認できます。登録も API キーも不要です。

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

Cursor に追加 VS Code に追加 ★ GitHub でスターを付ける

その他の MCP クライアント

{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

エージェント用スキル (SKILL.md)：Vigia を使うタイミングをエージェントに伝えます · プルリクエスト用 GitHub Action

よくある質問

dotenv を 16 から 17 にアップグレードする際の破壊的変更は？

dotenv 16.6.1 と 17.4.2 の間で、Vigia は削除されたエクスポートを 0 件、変更されたシグネチャを 1 件、削除または変更されたクラス／インターフェースのメンバーを 1 件検出しました。

dotenv 17 で非推奨になったものは？

dotenv 17.4.2 では 0 件のエクスポートまたはメンバーが新たに非推奨になりました。

エージェント向け

GET https://vigia.coredls.cloud/v1/packages/npm/dotenv/upgrade?from=16.6.1&to=17.4.2