Get unlimited public & private packages + package-based permissions with npm Pro.Get started »

jsocrud

2.0.3 • Public • Published

jsocrud Build Status

Perform crud operations within a JavaScript object using a string representation of the path at which you wish perform operations.

View the wiki for function documentation.

Usage


Paths in JSOCRUD


A path is the route in the object you would use to access an element. This can be given in dot or bracket notation.

Examples of acceptable paths and their resulting locations in an object:

  • 'foo' -> object.foo
  • '.foo' -> object.foo
  • "['foo']" -> object.foo
  • '["foo"]' -> object.foo
  • 'foo.bar' -> object.foo.bar
  • 'foo bar.baz' -> object["foo bar"].baz
  • '.foo[1]['bar']' -> object.foo[1].bar

Code example


Here are some code examples of how you would use this package interact with JavaScript objects:

> var jsocrud = require('jsocrud');  // Require the package to start
 
// - Insert (Create) -
> var object = {};
undefined
> jsocrud.insert(object, 'foo', {});
{ foo: {} }
> jsocrud.insert(object, 'foo', []);
Error: An entity already exists at path: .foo
> jsocrud.insert(object, 'foo.baz[1]', 'hello');
Error: There was an error setting the given value at the given path
 
// - Get (Read) -
> var object = {'foo': [{'bar': 'baz'}], 'something here': 'hello'};
undefined
> jsocrud.get(object, 'something here');
'hello'
> jsocrud.get(object, 'foo[0].bar');
'baz'
> jsocrud.get(object, 'foo[1].bar');
Error: No entity exists in the given object at the given path
> jsocrud.get(object, 'foo[1].bar', 'Nothing there');
'Nothing there'
 
// - Set (Update) -
> var object = {'foo': [{'bar': 'baz'}]};
undefined
> jsocrud.set(object, 'foo[0].bar', 25);
{ foo: [ { bar: 25 } ] }
> jsocrud.set(object, 'foo[1].baz', 32);
Error: There was an error setting the given value at the given path
 
// - Remove (Delete) -
> var object = {'foo': [{'bar': 'baz'}]};
undefined
> jsocrud.remove(object, 'foo[0].bar');
{ foo: [ {} ] }
> jsocrud.remove(object, 'foo[1].bar');
Error: There was an error deleting from the given object at the given path

Setup for Development


Installing


npm install

Running Tests


npm test

Keywords

Install

npm i jsocrud

DownloadsWeekly Downloads

111

Version

2.0.3

License

none

Last publish

Collaborators

  • avatar