util~ Configuration

A configuration utility object.

Properties can be get/set by using the module:util~Configuration#value function.

Constructor

new Configuration(initialMap)

Constructor.

For any properties passed on initialMap, module:util~Configuration#value will be called so those properties are defined on this instance.

Parameters:
NameTypeDescription
initialMapobject

the optional initial properties to store

Methods

enabled(key) → {boolean}

Test if a key is truthy.

Parameters:
NameTypeDescription
keystring

the key to test

Returns:

true if the key is enabled

Type: 
boolean

toggle(key, enabled) → {module:util~Configuration}

Set or toggle the enabled status of a given key.

If the `enabled` parameter is not passed, then the enabled status will be toggled to its opposite value.

Parameters:
NameTypeDescription
keystring

they key to set

enabledboolean

the optional enabled value to set

Returns:

this object to allow method chaining

Type: 
module:util~Configuration

value(key, newValueopt) → {object}

Get or set a configuration value.

Parameters:
NameTypeAttributesDescription
keystring

The key to get or set the value for

newValueobject<optional>

If defined, the new value to set for the given key. If null then the value will be removed.

Returns:

If called as a getter, the associated value for the given key, otherwise this object.

Type: 
object

values(newMapopt) → {object}

Get or set multiple properties.

Parameters:
NameTypeAttributesDescription
newMapobject<optional>

a map of values to set

Returns:

if called as a getter, all properties of this object copied into a simple object; otherwise this object

Type: 
object