Node-config comes with a handy set of utilities necessary for implementing node-config. These utilities are exposed in theconfig.util object for use in your own applications.

Below is a list of these utilities, in order of general usefulness - your mileage may vary.

Extend an object (and any object it contains) with one or more objects (and objects contained in them).

This does not replace deep objects as other extend functions do,but dives into them extending individual elements instead. If more than oneof the extending objects define the same key, then:

• if all the respective values are objects, they are merged recursively by calling the same function.
• if none of the respective values are objects, then the latest one is respected.
• avoid mixing objects and non-objects for the same key as it can lead to unexpected behaviour.

The following example merges the contents of two objects into a new object.

varnewObject=config.util.extendDeep({},baseObject,anotherObject);

Return a deep copy of the specified object.

This returns a new object with all elements copied from the specifiedobject. Deep copies are made of objects and arrays so you can do anythingwith the returned object without affecting the input object.

Example:

varcopy=config.util.cloneDeep(fromObject);

Return true if two objects have equal contents.

Example:

varcustomerCopy=config.util.cloneDeep(myCustomer);varsame=config.util.equalsDeep(myCustomer,customerCopy);// <-- truecustomerCopy.creditLimit=7000;varsame=config.util.equalsDeep(myCustomer,customerCopy);// <-- false

Returns an object containing all elements that differ between two objects.

It works best when object2 originated by deep copying object1, thenchanges were made to object2, and you want an object that would give youthe changes made to object1 which resulted in object2.

Make a javascript object property immutable (assuring it cannot be changed from the current value).

If the propertyName isn't supplied, all properties of the object are made immutable.

Properties which themselves are objects are called recursively, making sub-objects immutable.

New properties can be added to this (and sub) objects, and those properties will not be immutable unless this method is called after adding the properties.

This operation cannot be undone.

Example:

vara={hello:'world'};config.util.makeImmutable(a);a.hello='there';console.log('Sorry, hello is still '+a.hello);

Make an object property hidden so it doesn't appear when enumerating elements of the object.

The property still exists and can be read from and written to, but it won't show up infor ... in loops,Object.keys(), orJSON.stringify() type methods.

Example:

vara={hello:'world'};console.log('Before hiding: '+JSON.stringify(a));config.util.makeHidden(a,'hello');console.log('After hiding: '+JSON.stringify(a));console.log('Hidden, but still there: '+a.hello);

Get the current value of a config environment variable

This method returns the value of the specified config environment variable,including any defaults or overrides.

Environment variables that you can inspect includeNODE_ENV,NODE_CONFIG_DIR,NODE_CONFIG,HOSTNAME,NODE_APP_INSTANCE, and others listed in theenvironment variables wiki page.

Example:

console.log('Configuration directory: '+config.util.getEnv('NODE_CONFIG_DIR'));

Reads the given directory using the same conventions as the main config directory (including environment variable reading, except forNODE_CONFIG) and returns an object with the result.

If no directory is given, reads the standard config directory and parsesNODE_CONFIG.

This is useful for using with submodules, e.g.

importconfigfrom'config'constourConfigDir=path.join(__dirname,'config')constbaseConfig=config.util.loadFileConfigs(ourConfigDir)config.util.setModuleDefaults('MyModule',baseConfig)

By default, all sources parsed as part of this operations are added to the global list of configuration Sources, despite not being added to the global configuration.

This may, in turn, increase the memory footprint of your application if the utility is called repeatedly. You can disable this behaviour by passing an options object with theskipConfigSources flag set totrue

importconfigfrom'config'constourConfigDir=path.join(__dirname,'config')constoptions={skipConfigSources:true}constbaseConfig=config.util.loadFileConfigs(ourConfigDir,options)config.util.setModuleDefaults('MyModule',baseConfig)

Returns a raw version of the current config object, or any part of the config if provided, deeply copied without theget,has andutil functions.

If config is not provided (undefined), the current config object is dumped in its entirety.

varresult=config.util.toObject(config.get('db'));