Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including canonical-json with all npm packages installed. Try it out:

var canonicalJson = require("canonical-json")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

canonical-json v0.0.4

a canonical json implementation

#Canonical JSON

The goal of this module is to implement a version of JSON.stringify that returns a canonical JSON format.

Canonical JSON means that the same object should always be stringified to the exact same string.
JavaScripts native JSON.stringify does not guarantee any order for object keys when serializing:

Properties of non-array objects are not guaranteed to be stringified in any particular order. Do not rely on ordering of properties within the same object within the stringification.


This module implements two alternative solutions to this problem:

  • index.js is based on Douglas Crockford's json2.js. I modified it to serialize object keys sorted on the fly.
  • index2.js recursively creates a copy of the object to sort its keys. The copy is then simply passed to native JSON.stringify

It currently exports the index.js version.

##Performance comparison I compared the performance of native JSON.stringify and the two alternative implementations that output keys sorted:

  • native JSON.stringify: 75 ms
  • js JSON.stringify with sorted keys (implementation): 308 ms
  • copy and native JSON.stringify with sorted keys (implementation: 291 ms

The tests were run in Node.js on a 2011 MacBook Pro.
Performance test source: test/performance.js

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free