cycni

Cycni

Cycni is a collection manipulation tool. It enables the ability to get, set, remove, and interact with an infinite depth collection. It provides an interface/api to manipulate objects, arrays, and others (coming soon) in a seamless and consistent mannor.

See the test directory for examples.

Install

• npm install cycni --save
• UMD dist/cycni.js
• ESM import src/cycni.b.js

Api

Cycni.get

• collection Object, Array infinitely nested and combinations
• path String, Array key names to destination on object or array

Cycni.set

• collection Object, Array infinitely nested and combinations. If the path contains a key that does not exists Cycni will create an object, if the path contains a number that does not exists Cycni will create an array. Then will continue on to set the final path key/index to the value.
• path String, Array key names to destination on object or array to be assigned
• value Any the value to assign

Cycni.has

• collection Object, Array infinitely nested and combinations
• path String, Array key names to destination on object or array to compare values
• value Function, RegExp, Any the value to compare to the destination returns a boolean

Cycni.remove

• collection Object, Array infinitely nested and combinations
• path String, Array key names to destination on object or array to be removed

Cycni.traverse

• collection Object, Array infinitely nested and combinations
• path String, Array key names to destination on object or array to be removed
• callback Function arguments are the collection and key of the destination

Cycni.clone

• clones Object, Array, Date or returns the value of any another

Examples

Collection

var collection = {
	id: '0',
	name: 'Cake',
	batters: [{
		id: '0',
		type: 'Regular'
	}, {
		id: '1',
		type: 'Chocolate'
	}, {
		id: 'u',
		type: 'Blueberry'
	}],
	hello: ['bob']
};

Remove

var results = Cycni.remove(collection, 'batters.0');

console.log(collection);
/*
{ id: '0',
  name: 'Cake',
  batters:
   [ { id: '1', type: 'Chocolate' },
     { id: 'u', type: 'Blueberry' } ],
  hello: [ 'bob' ] }
*/

console.log(results);
/*
{ id: '0', type: 'Regular' }
*/