Object serialization library
Want to see pretty graphs? Log in now!
npm install icebox
|18||downloads in the last week|
|35||downloads in the last month|
|Last Published By|
|Version||0.1.8 last updated 4 months ago|
icebox.js - A simple object serialization library
icebox.js serializes object structures, which may be circular, into non-circular structures that can be stored or transmitted. When deserializating such structures, icebox.js re-establish constructor associations and circular links.
$ npm install icebox
Load the module
var icebox = require('icebox');
Freeze some data:
var frozen = icebox.freeze(data);
The frozen variable now contains a non-circular, annotated object tree that can be converted to JSON, stored in files or transmitted over a network connection.
Thaw the frozen representation to yield the same circular structure:
var data = icebox.thaw(frozen);
Whenever an object is restored from the frozen representation, its thawed() function is invoked, if it exists. The thawed() function can be used for bookkeeping, but it must not assume that anything beyond the current object has been thawed() yet.
Icebox tags each object that it serializes with an ID in order to resolve circles. These ids are not available outside of the serialization process, and applications must use their own object IDs, if desired, as icebox needs to have full control over its own ID space.