Key-value pairs serialization (aka, www-form-encoding
) of objects for Underscore.js.
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');
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"
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" }
Copies and flattens a tree of sub-objects into namespaced keys on the target object.
_.collapseObject({ "foo":{ "bar":1 } })
// --> { "foo.bar":1 }
Inverse of _.collapseObject()
โ copies all keys onto the target object,
expanding any dot-namespaced keys found.
_.uncollapseObject({ "foo.bar":1 })
// --> { "foo":{ "bar":1 } }
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 [email protected].
--
underscore.kv
was written by David Schoonover; it is open-source software and freely available under the MIT License.