Objekto
Objekto is a small utility to convert an object into a string ({a: 'foo', b: {c: {d: 'bar'}}} to 'a=foo;b|c|d=bar') and vice versa.
npm install --save objektoImport
Require:
var ots = require('objekto');
var objectToString = ots.objectToString;
var stringToObject = ots.stringToObject;var objectToString = require('objekto/ots');
var stringToObject = require('objekto/sto');ES6:
import { objectToString, stringToObject } from 'objekto';import objectToString from 'objekto/ots';
import stringToObject from 'objekto/sto';Usage
Convert an object into a string or vice versa:
var obj0 = {a: 'foo'};
var str0 = 'a=foo';
console.log(objectToString(obj0) === str0); // -> true
console.log(_.isEqual(stringToObject(str0), obj0)); // -> true
var obj1 = {a: 'foo', b: 'bar'};
var str1 = 'a=foo;b=bar';
console.log(objectToString(obj1) === str1); // -> true
console.log(_.isEqual(stringToObject(str1), obj1)); // -> true
var obj2 = {
a: 'foo',
b: 'bar',
c: {
d: 'foobar'
}
};
var str2 = 'a=foo;b=bar;c|d=foobar';
console.log(objectToString(obj2) === str2); // -> true
console.log(_.isEqual(stringToObject(str2), obj2)); // -> trueOptions:
var object = {
a: 'foo',
b: {
c: 'bar'
}
};
var string = 'a~foo||b.c~bar';
var options = {
keySeparator: '||',
keyValueSeparator: '~',
levelSeparator: '.'
};
console.log(objectToString(object, options) === string); // -> true
console.log(_.isEqual(stringToObject(string, options), object)); // -> true
See test cases for other examples.
Tests
npm testNotice on performance
You should note that on large and complex objects objectToString is about 3-4 times slower than JSON.stringify, stringToObject is about 2 times slower than JSON.parse. Run npm run benchmark to see for yourself. I suggest to use this utils only in case you really can't afford native JSON methods.
Changelog
- 1.1.3: Update merge.js and tests.
- 1.1.2: Added benchmark.
- 1.1.1: Removed lodash dependency.
- 1.1.0: Performance improvements.
- 1.0.0: Initial release.
License
P.S.
"Objekto" is an esperanto word for 'object' (which is pretty obvious, I guess).
