immutable-class

Immutable Class

A little library to facilitate creating and testing serializable, immutable classes.

This library is really just a set of templates and testing tools to allow for quick construction of immutable classes.

Templates

An object is considered a immutable class of it meats the following criteria:

• It is a JS 'class' that starts with an uppercase letter
• It has a static ClassName.isClassName method for checking if something is an instance of the given class
• It has a static ClassName.fromJS method for deserializing classes
• It has an instance valueOf method that return a minimally serialized object (preserving all sub classes as immutable classes)
• It has an instance toJS method that return a fully serialized object (recursively serializing all sub classes)
• It has an instance toJSON method that returns the same as the toJS method allowing the object to be passed into JSON.stringify
• It has an instance toString method that is implemented in some way (and returns a string)
• It has an instance equals method that can be used to compare this object to other classes to check for equivalence.

Testing tools

Immutable Class provides one testing function for testing potential immutable classes: testImmutableClass

It is used like so:

testImmutableClass(MyImmutableClassConstructor, [
  { "potential": 1 }
  { "distinct": 2 }
  { "js": 3 }
  { "immutable classes": 4 }
]);

This function will then try to call fromJS on each candidate and run it through a series of tests to ensure that it corresponds to the rules above. It will also do an equality check of every object with every other object and make sure that it only equals itself.

For an example of the usage of this library look at these files: source, tests.