ObjectArray

Example:

 var doa = new ObjectArray();
 var doa = new ObjectArray({
  key1: value1,
  key2: value2
 });

Test:

• ObjectArray constructor

Returns the underlying _data object for raw reading

Test:

• Data getter and setter

See:

• _data

Import data into ObjectArray.

This setter is an alias to import method.

The inner data object

Global memorizer for automated working on a subset.

It defaults to false.

Global switcher for defining if ObjectArray should return undefined or throw an exception when an undefined key is requested.

It is not set at ObjectArray initialization.

Returns a camelized string (without uppercase leading character) Replace dashes and spaces

Test:

• Camel and dash

Check the value for a given key in the ObjectArray

Returns the delevl down key for a given dotted key

Returns a clone with same data of the current ObjectArray

Test:

• Cloning ObjectArray

Returns a dashed string Replace Uppercases and spaces

Test:

• Camel and dash

Returns dataset for the key. If no key is provided, the whole dataset is returned

Throw:

Coalesce method to define a default value if a key is not set.

Never use if you want to store undefined as values.

This method is obviously useless if the ObjectArray is set to throw an exception when encountering an undefined key

Test:

• ObjectArray define function

Empty the ObjectArray data. It can also be used as an alias for ObjectArray~remove

Throw:

Test:

• Empty ObjectArray or remove subset

Flattens the object and replace data.

Each object in the dataset is recursively explored to extract data and bring it a top level.

With default behaviour, if two or more properties have same name under subkeys, the last explored one will replace the previous one.

If the method is called with true as first parameter, the resulting data keys will be dotted, preventing duplication. In that case, you must access new keys with dataset method or by calling the data key property with [] (e.g. doa.data['my.key']);

Flatten may be run on a subdataset by providing a key as second parameter.

Throw:

Test:

• Cloning ObjectArray

Runs a callback on each entry at the key level

Throw:

Test:

• ObjectArray iterations

Returns a string suitable for a form-url-encoded query string

Throw:

Shortcut for getter/setter syntax. It can also be used to import data.

Throw:

Example:

 // Getter mode
 i.getset(); // returns all data
 i.getset('a'); // returns data for key a
 i.getset('c'); // will throw a TypeError exception if key c doesn't exist
 i.getset('c', undefined, '', false) // returns undefined
 // Better use
 i.pull('c', '', false); // returns undefined

 // Setter mode
 i.getset('a', 'valueA'); // Set 'valueA' to key a
 i.getset('b', 'valueB', 'a'); // set 'valueB' to key a.b

 // Import mode
 i.getset({a: 'valueA', 'a.b': 'valueB'}); // Import key/values at root level
 i.getset({'b', 'valueB'}, 'a'); // Import key/values at key a

Check if a given key exists in the ObjectArray

Import an object as data

Returns keys of a given dataset in the ObjectArray If no key is provided, it will output the keys of the root data object

Throw:

Returns length of a given dataset in the ObjectArray If no key is provided, it will output the length of the root data object

Throw:

Test:

• Length

Set the parent key global memorizer. it works like giving a pKey argument to methods

Test:

• Parent key memorizer

Returns e level up key for a given dotted key

Alias for dataset method.

Throw:

See:

• dataset

Push a new key/value pair

Throw:

Reduce the ObjectArray data given a callback

Throw:

Test:

• ObjectArray iterations

Remove key/value data

Throw:

Imports a string from a style attribute. ObjectArray will camelize key from spaces and/or dashes

Returns a string suitable for a style attribute. ObjectArray will convert camel-cased key to dashed key.

Throw:

Overrides all throwable params settings of the object array

You can revert back to no effect by setting it to undefined

Test:

• Global throwing behaviour override

Returns a string suitable for a URI query string

Throw:

Returns values of a given dataset in the ObjectArray If no key is provided, it will output the values of the root data object

Throw:

Returns a joined dotted key from key and parent key.

If not parent key is provided, it will try to use global parent key memorizer

If the global _throw trigger is set, it will overrides any throwable parameter. Use it with care !

Throw:

Test:

• Key constructor

See:

• pKey
• throwing

Private method to recurse flatten