u.js — minimalist utilities
u.js is a minimalist, functional utility library designed for embedding into another small program.
- Collection utilities that work on both Arrays and Objects (
- Copying/extending Objects
- Binding function scope
- Serializing and deserializing query-string KV pairs
- Optional polyfills in
future.jsfor the most important JS features missing from older browsers (e.g.,
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!
u.reduce(o, fn, [acc], [cxt=o])
Array.prototype.reduce(), but for both Object and Arrays.
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.
u.map(o, fn, cxt=o)
Array.prototype.map(), but for both Object and Arrays.
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
u.extend(target, ...donors) -> target
Copies all keys from each
donor onto the
target object, and then returns it.
u.bind(fn, context, ...args) -> Function
Function.prototype.bind(): returns a function
(...more_args) that when invoked,
calls the original function with the supplied context and arguments from both invocations
fn.apply( context, args.concat(more_args) )
u.isArray(o) -> Boolean
Returns whether the input object is an Array; calls
Array.isArray(o) if it exists, and a polyfill
u.trim(s) -> String
Returns the string with leading and trailing whitespace removed.
u.toKV(o, delimiter='&') -> String
Serializes an object into a string of "form-encoded" key-value pairs, applying one layer of URL-encoding.
u.fromKV(q, delimiter='&') -> Object
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.
u.setCookie(k, v, [expires, [path, [domain, [doc]]]]) -> Object
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:
'Sun, 24-Mar-2024 11:11:11 GMT'