1.3 kb minified, 0.6 kb minified and gzipped
npm install object-subscribe
Create an object:
var person = {
name: 'Joey',
age: 3
};Subscribe to changes made to the object:
Obj.subscribe(person, function(newPersonObject, whatChanged) {
console.log(newPersonObject);
}, true); // Pass true to execute callback now.The callback passed to Obj.subscribe is called every time one of the following is called, unless a truthy value is passed as the third argument:
Obj.setObj.unsetObj.resetObj.changed
Use those functions like this:
Obj.set(person, {age: 11, height: 50, favoriteColor: 'rainbow'});
//=> {name: 'Joey', age: 11, height: 50, favoriteColor: 'rainbow'}
Obj.unset(person, ['favoriteColor']);
//=> {name: 'Joey', age: 11, height: 50}
Obj.reset(person, {name: 'Bob', age: 6});
//=> {name: 'Bob', age: 6}
person.age++;
Obj.changed(person);
//=> {name: 'Bob', age: 7}Obj.unsubscribe(person); // Unsubscribe all
Obj.unsubscribe(person, [fn1, fn2]); // Unsubscribe one or more functionsobj.js comes with four helper functions. Obj.has for safe hasOwnProperty checks and Obj.keys which returns an array of an object's keys, Obj.type as a more robust typeof, and Obj.extend for cloning and extending simple objects and arrays. Obj.keys uses the native Object.keys if available.
Obj.has(person, 'name'); //=> true
Obj.keys(person); //=> ['name', 'age']
Obj.type([]); //=> 'array'
Obj.extend({height: 50}, person); //=> {name: 'Bob', age: 7, height: 50}// Clone an object or an array:
var clonedObjOrArray = Obj.extend(objectOrArray);
// Extend objectB with objectA's properties:
Obj.extend(objectA, objectB);
// Add the items in arrayA to the end of arrayB:
Obj.extend(arrayA, arrayB);All the code is very modular, so you can easily delete the parts you don't use.
You can also add your own methods:
Obj.increment = function(obj, key) {
obj[key]++;
Obj.changed(obj); // Notify subscribers of change
};
Obj.increment(person, 'age');