Super simple and non-recursive JSON parse/stringify library

Downloads in past


4201.0.37 years ago9 years agoMinified + gzip package size for vuvuzela in KB


vuvuzela Build Status
Simple and non-recursive JSON parse/stringify library.


  • No recursion
- Avoids the "too much recursion" or "maximum call stack" errors that the native JSON.parse and JSON.stringify methods may throw if an object is deeply nested.
  • Simplicity
- No functions-within-functions, just a while loop and a stack.
  • Small footprint
- ~1 KB minified and gzipped


vuvuzela, courtesy of Berndt Meyer via the Wikipedia page
The vuvuzela is a coarse instrument, but it's lightweight, and it gets the job done.
This module will use up tons of memory, but unlike the native JSON methods or json3, it'll never throw a "maximum call stack size exceeded" exception. Your JSON objects can be as deeply nested as you like.
This is not a streaming library, so unlike oboe/clarinet, it reads the whole thing into memory at once. It's also quite a bit slower than the native JSON methods. Use at your own risk!


$ npm install vuvuzela
var vuvuzela = require('vuvuzela')

var asString = vuvuzela.stringify({hello: 'world'}); // '{"hello":"world"}'

var asJson = vuvuzela.parse('{"hello": "world"}'); // {hello: 'world'}

Browser builds are available in the dist/ folder. They'll create a window.vuvuzela object you can use.


At the top level, it will currently only parse objects and arrays, not arbitrary values like booleans, strings, numbers, and null.


Unit tests:
$ npm test
Coverage tests:
$ npm run coverage


$ npm run build