Objix

Objix is a delightfully convienient, high performance, zero dependency and super lightweight utility which extends the javascript standard library to sugar many common use cases for working with any objects.

The functions are all non enumerable and include copies of Object class methods and Array prototype methods applied to the values of the object as well others to delete keys, stringify, promisify, memoize, compare, split/join objects, check types, log messages and trapping/observing property assignments.

This library is highly optimised with zero copy operations where possible. The source is only 3.7kb (2.8kb minified) which allows for fast loading and easy integration without additional compilation or tree shaking. Performance in most cases is significantly faster than lodash equivalents especially when working with small objects. For example ob._map(fn) is typically over 65% faster than _.mapValues(ob, fn) and some operations such as pick can be several thousand times quicker according to simple benchmarks.

Interactive docs and demos are availble on https://objix.dev/#/docs/api.

Upgrading from 1.0

Objix 2.0 now prefixes all prototype methods with '_'. This avoids name clashes with built in methods and reduces unwanted side effects and compatibility issues inherent in the 1.x releases.

The _size() method is now renamied to _len().

Getting Started - Node

• Install:

  1> npm i -save objix

• Require:

  1require('objix')
  2var o = { a: 1 }._map(v => v + 1)._log()

Getting Started - Browser

1<script src="https://cdn.jsdelivr.net/gh/mattaylor/objix@main/objix.min.js"></script>
2
3<script>
4  var o = { a: 1 }._map(v => v + 1)._log()
5</script>

Prototype Methods

The following methods are availble to all Objects via protoype inheritence, unless overwritten by a subclass.

Fluent Method Chaining

Most of these function return objects including those modifying this and so can be fluently chained together.

1var o = { a: 0, b: 1, c: 2 }
2  ._pick(v => v > 0)
3  ._log('POSITIVE') // 2022-10-07T00:00 POSITIVE { b: 1, c: 2 }
4  ._map(v => v + 1)
5  ._log('INCREMENT') // 2022-10-07T00:00 INCREMENT { b: 2, c: 3 }

Function Aliases

All functions documented below are also callable with a '_' prefix to the function name. This can help ensure that the function is callable when overwritten by other object property assignments.

1var o = { a: 1 }._len() == { a: 1 }._len() //true
2var o = { a: 1 }._find(v => v) == { a: 1 }._find(v => v) //true

Simple Classes

Any object can act as a class from which new objects can be derived. All properties of this are inherited - including traps!!

1var Person = { firstName: 'john', lastName: 'doe' }
2  ._trap(v => new Date(v).getDate(), 'Invalid date', 'dob')
3  ._bind('age', t => Math.floor((Date.now() - new Date(t.dob)) / 31536000000))
4  ._bind('name', t => t.firstName + ' ' + t.lastName)
5
6var p1 = Person._new({ firstName: 'jane' })
7p1.name() // 'jane doe'
8p1._try(
9  p => (p.dob = 'foobar'),
10  e => e._log()
11) // Uncaught 'Invalid date [dob, foobar]'
12p1.dob = '10/10/2000'
13p1.age() // 22

Module Exports

All functions listed below are also available using traditional module exports, where the first argument of the function will be the object that the function is targeting as this if called via the object O.p.

1const _ = require('objix')
2
3_.len({ a: 1 }) == { a: 1 }._len() // true
4_.find({ a: 1 }, v => v) == { a: 1 }._find(v => v) //true