Module provides API to access, set and unset environment variables via exported env object.

var { env } = require('api-utils/environment');

You can get the value of an environment variable, by accessing property that has name of desired variable:

var PATH = env.PATH;

You can check existence of an environment variable by checking if property with such variable name exists:

console.log('PATH' in env); // true
console.log('FOO' in env);  // false

You can set value of an environment variable by setting a property:

env.FOO = 'foo';
env.PATH += ':/my/path/'

You can unset environment variable by deleting a property:

delete env.FOO;

Limitations

There is no way to enumerate existing environment variables, also env won't have any enumerable properties:

console.log(Object.keys(env)); // []

Environment variable will be unset, show up as non-existing if it's set to null, undefined or ''.

env.FOO = null;
console.log('FOO' in env);  // false
env.BAR = '';
console.log(env.BAR);       // undefined