dotenv-multi v1.0.0
Welcome to dotenv-multi 👋
English | 中文文档
dotenv-multi
Use dotenv to parse and load variables from multiple env files to process.env, and distinguish between different modes.
Install
// with npm
npm install dotenv-multi
// with yarn
yarn add dotenv-multi
Usage
const dotenvMulti = require('dotenv-multi');
dotenvMulti.loadEnv({ dir: 'path/to/envFileDir', mode: 'myMode' });
API
loadEnv(options: LoadOptions): Result
loadEnv will parse and merge the following files into process.env
in the dir
folder.
Note:
1. Priority of the above files from low to high
2. The file will be skipped if the file does not exist
3. Will not overwrite the original value in process.env
4. The method used to merge the variables in the file is "Object.assign".
Example
Assume that there are some env files in the env/
folder
// .env
foo=foooooo
URL=api.default.com
endpoint=path/to/endpoint
// .env.dev
URL=api.dev.com
// .env.local
URL=api.dev-local.com
e1=some-local-var
//.env.stg
URL=api.stg.com
//.env.prd
bar=barrrrr
URL=api.prd.com
//.env.prd.local
URL=api.prd.com
enpoint=/another/path/to/endpoint
proxy=/another
Suppose we distinguish the modes through process.env.API
const dotenvMulti = require('dotenv-multi');
dotenvMulti.loadEnv({ dir: './env', mode: process.env.API });
Start the script in different ways as follows
# load .env、.env.local、.env.dev、.env.dev.local
$ cross-env API=dev npm run some-script
# load .env、.env.local、.env.stg、.env.stg.local
$ cross-env API=stg npm run some-script
# load .env、.env.local、.env.prd、.env.prd.local
$ cross-env API=prd npm run some-script
Then we can get the corresponding environment variables in the project
Interface
LoadOptions
Key | Type | Default | Required | Description |
---|---|---|---|---|
dir | string | process.cwd() | N | Directory path where env files are stored |
mode | string | process.env.NODE_ENV | N | current mode |
Result: ParseSuccess | ParseError
interface ParseSuccess {
parsed: { [props: string]: string };
error: null;
}
interface ParseError {
error: Error;
parsed: null;
}
Author
👤 render
- Website: http://render.ink
- Github: @zjcrender
Show your support
Give a ⭐️ if this project helped you!
4 years ago