Skip to content
A fancy little map/reducer for complex JavaScript data objects.
JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE
README.md
safeobj.js
safeobj.test.js

README.md

SafeObj

JavaScript requires you to test every value in a nested object, which can add a lot of bloated tests for "undefined" if you're dealing with deeply nested objects. This is a fancy little map/reducer for complex JavaScript data objects. Check out the tests file to see all the features.

Works client-side on most major browsers without any polyfills. Great for use with your favorite javascript chart library!

This work is public domain, free for use and modification without restriction.

let SafeObj = require('./safeobj.js');

var myData = new SafeObj({
  a: {
    b: {
      c0: 17,
      c1: [
        { total: 1 },
        { total: 5 },
        { total: 7 }
      ],
      c2: {
        d1: { total: 1 },
        d2: { total: 3 },
        d3: { total: 6 }
      }
    }
  }
})

myData.get('a.b.c0'); // 17
myData.get('a.b.f.total'); // null

myData.get('a.b.c1',[0,1],'total'); // [1,5]
myData.get('a.b.c1.[*].total'); // [1,5,7]

myData.get('a.b.c2.{d1,d2}.total'); // {d1:1, d2:3}
myData.get('a.b.c2.{*}.total'); // {d1:1, d2:3, d3: 6}

myData.sum('a.b.c1',[1,2],'total'); // 12

See the tests file for full usage examples.

You can’t perform that action at this time.