nickav / hibar

JavaScript's missing functions

hibar

JavaScript's missing functions.

Install

yarn add hibar

There are three ways of using it:

Magically

Hibar supports the magic lodash-styled syntax:

const _ = require('hibar')
console.log(_.clamp(0, 1, 2))

This will automagically call the right function. See Performance if that's a concern.

Manually

If you'd prefer not to override the base JavaScript classes, you can import and invoke these methods manually:

const { array } = require('hibar')
console.log(array.equals([1], [1]))

Polyfill

require('hibar/polyfill')
console.log(Math.clamp(0, 1, 2))

This will monkey-patch the base JavaScript classes. To see the full list of them see ./lib/polyfill.js.

Note: This approach is not reccommended because 1) it makes your code harder To read and 2) it makes your code rely on the polyfill being called before any of your other code is run.

Performance

Note when using the magic _ function, there is a slight performance hit for using functions with colliding names in the library (e.g. compact is both an array and an object function).

If you're doing some intense computation, you should manually import and invoke the method directly (as described in the Manually section).

Development

To publish a new version of the package, install np then run:

np