madson

madson is a binary serialization library for javascript.

Supports recursive self references.

Installation

npm install --save madson

Usage

  var madson = require('madson');

  var obj1 = {
    n: 1,
    s: 'string',
    a: [3, {z: 4}],
    r: /av[sx]*/gi,
    d: new Date(),
    o: { p: 1, q: 2, z: false },
    b: true
  };
  JSON.stringify(obj1) // -> string (111 bytes)

  obj1.self = obj1;
  // JSON.stringify(obj1) -> TypeError: Converting circular structure to JSON


  var buf = madson.encode(obj1); // -> Buffer [75 bytes]

  var obj2 = madson.decode(buf);
  // obj1 != obj2
  // obj2.self == obj2
  // obj2.r instanceof RegExp
  // obj2.d instanceof Date

Custom Class Types

var madson = require("madson");

var preset = madson.codec.preset;
preset.addExtPacker(0x3F, MyClass, MyClassPacker);
preset.addExtUnpacker(0x3F, MyClassUnpacker);

function MyClass(x, y) {
  this.x = x;
  this.y = y;
}

function MyClassPacker(c) {
  var array = [c.x, c.y];

  // return serialized Buffer
  return madson.encode(array);
}

function MyClassUnpacker(buffer) {
  var array = madson.decode(buffer);

  // return deserialized Object
  return new MyClass(array[0], array[1]);
}


var data = new MyClass(1, 2);
var encoded = madson.encode(data);
console.log(encoded);

var decoded = madson.decode(encoded);
console.log(decoded);