A (cryptically-named) component that exposes the ability to serialize a JS object from a series of key/value pairs where the keys use square-bracket notation. (with some limited dot notation support)
A (cryptically-named) component that exposes the ability to serialize a JS
object from a series of key/value pairs where the keys use square-bracket
notation. (with some limited dot notation support)
I'll be following this spec, and if
we start seeing browser support this library will follow that direction.
This API is really low-level, and is meant to be plugged into some other library that
determines what elements need to be serialized.
(see dominicbarnes/form-serialize)
API
square.parse(name)
Parses a key name and splits it into the various layers of the key name. The result is
an Array of either String names or false which indicates an array.
// get the value in a nested objectvar o = { user: { name: 'Matt' } };var ret = square.get(o, 'user.name');assert('Matt' == ret);// get a specific value from an array of objectsvar o = { tags: [{ name: 'a' }, { name: 'b' }, { name: 'c' }] };var ret = square.get(o, 'tags[1].name');assert.deepEqual(ret, 'b');// get an array of values from an array of objectsvar o = { tags: [{ name: 'a' }, { name: 'b' }, { name: 'c' }] };var
square.set(obj, key, value)
Takes a source obj and augments it by setting the given value at the given key.
Examples: (it's long, but meant to illustrate the process)