underscore.kv

Key-value pairs serialization (aka, www-form-encoding) of objects for Underscore.js.

Usage

For usage in node.js, install it via npm: npm install underscore.kv.

You can use underscore.kv as a stand-alone library, though it depends on Underscore. Most people mix it into the Underscore namespace, which gains you the chaining wrappers.

// standalone
var _kv = require('underscore.kv');

// mixin
var _ = require('underscore');
_.mixin require('underscore.kv');

API

_.toKV( object [, item_delim='&' [, kv_delim='=' ]] )

Transforms an object to a string of URL-encoded KV-pairs (aka "www-form-encoding"). You may optionally override the delimiter inserted between items (& by default), or the delimiter inserted between keys and values (=).

Note:

• All values end up as a string, implying all type information is lost.
• Both keys and values are URL-encoded once.

_.toKV({ "foo":"bar", "feh":1, "lol":true })
// --> "foo=bar&feh=1&lol=true"

_.fromKV( string [, item_delim='&' [, kv_delim='=' ]])

Restores an object from a string of URL-encoded KV-pairs (aka "www-form-encoding"). You may optionally override the delimiter inserted between items (& by default), or the delimiter inserted between keys and values (=).

Note:

• All resulting values will be strings as all type information is lost.
• Both keys and values will be URL-decoded once.

_.fromKV("foo=bar&feh=1&lol=true")
// --> { "foo":"bar", "feh":"1", "lol":"true" }

_.collapseObject( source [, target={} [, prefix='' ]])

Copies and flattens a tree of sub-objects into namespaced keys on the target object.

_.collapseObject({ "foo":{ "bar":1 } })
// --> { "foo.bar":1 }

_.uncollapseObject( source [, target={} ])

Inverse of _.collapseObject() — copies all keys onto the target object, expanding any dot-namespaced keys found.

_.uncollapseObject({ "foo.bar":1 })
// --> { "foo":{ "bar":1 } }

Feedback

Find a bug or want to contribute? Open a ticket (or fork the source!) on github. You're also welcome to send me email at dsc@less.ly.

--

underscore.kv was written by David Schoonover; it is open-source software and freely available under the MIT License.