Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

object-traversed

chantouch7MIT0.0.6TypeScript support: included

Parse, check and traverse javascript objects via string path

deep, bean, path, object, traverse, traversed, deep-object, object traverse, object traversed

readme

Object Traversed

============== Build Status view on npm Software License npm npm

A very simple, lightweight utility on traversing object graphs using a string.

How to use

npm install --save object-traversed
yarn add  object-traversed

If using via normal javascript include, then it is exported as window.objectTraverse.

API

var traversed = require('object-traversed');

var graph = {  
   field : {
      deep : {
         x : 1,
         y: 2
      }
   },
   field2: [],
   deepFunc : { someFunc: function(arg) {} }

};
//get a value
traversed(graph).get('field.deep');
//get with a default
traversed(graph).get('field.deep','default return val if not found'); 

//check if something is defined
traversed(graph).has('field.deep.missing');

//sets a value
traversed(graph).set('field.deep.z',5);

//helpers
traversed(graph).isArray('field2');
traversed(graph).isString('field2');
traversed(graph).isObject('field2');
traversed(graph).isNumber('field2');

//exec
traversed(graph).exec('deepFunc.someFunc','arg');         

//delete
traversed(graph).delete('field.deep.x');

//push - add vall to the array, will create if it doesn't exists
traversed(graph).push('a.b.c',val);

//create create the given path if it doesn't exists, will skip none object types
traversed(graph).create('a.b.c');
traversed(graph).get('a.b.c'); //{ a : { b : { c: {} } }

🔑 License

MIT © ChantouchSek