A minimalist, functional utility library designed for embedding into another small program.
npm install uu.js is a minimalist, functional utility library designed for embedding into another small program.
* Collection utilities that work on both Arrays and Objects (reduce, map)
* Copying/extending Objects
* Binding function scope
* Serializing and deserializing query-string KV pairs
* Optional polyfills in future.js for the most important JS features
missing from older browsers (e.g., Array.map(), Object.keys())
That's it.1 u.js has no dependencies and works in
any browser. The code has seen extensive production use, but the tests were part of a bigger
project and have not yet been ported.
u.js is ideal for building a bootstrapper. Several of my projects have been embeddable tools.
When your code is going to run in hostile territory, versioning is especially important, but it
requires some way to get your versioned code on the page in the first place: a bootstrapper.
A tiny bootstrapper gives your users the flexibility to choose a version, but gives you the power to
smooth over implementation assumptions (like changing configuration parameters, embedding-code, or
the inevitable bug pasted onto someone's page). So I needed something tiny primarily to parse
querystring values and work with collections. It had to come prior to the main program, as the
program version could be overriden by configuration!
As Array.prototype.reduce(), but for both Object and Arrays.
Invokes acc = fn.call(cxt, acc, v, k, o) for each value in the collection, returning the final
value of the accumulator. For Arrays, k will be the index.
As Array.prototype.map(), but for both Object and Arrays.
Invokes fn.call(cxt, v, k, o) for each value in the collection, returning a new collection with
the mapped values. (The collection will be an Object or Array based on the type of the input
collection.)
Copies all keys from each donor onto the target object, and then returns it.
Stub for Function.prototype.bind(): returns a function (...more_args) that when invoked,
calls the original function with the supplied context and arguments from both invocations
concatenated together:
fn.apply( context, args.concat(more_args) )
Returns whether the input object is an Array; calls Array.isArray(o) if it exists, and a polyfill
otherwise.
Returns the string with leading and trailing whitespace removed.
Serializes an object into a string of "form-encoded" key-value pairs, applying one layer of
URL-encoding.
Deserializes "form-encoded" key-value pairs (removing one layer of URL-encoding), and returning an
object of their values. Note that repeated values in the serialized string will clobber each other.
Sets a cookie, returning an updated map from cookie key to value.
By default, the cookie will be set for all paths on the current domain using the current document,
expiring on a distant date:
- expires: 'Sun, 24-Mar-2024 11:11:11 GMT'
- path: '/'
- domain: doc.domain
- doc: window.document
Open a ticket at github, or send me email.
[1]: u.js does not provide any DOM manipulation; check out Zepto.js if you
need to fiddle with DOM elements.