Gets the job done when JSON.stringify can't
Switch branches/tags
Clone or download
Pull request Compare This branch is 6 commits ahead, 13 commits behind Rich-Harris:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
scripts initial commit Mar 10, 2018
src feat: env vars to adjust warning behaviour (#2) Oct 15, 2018
test fix: properly log message for symbolic keys (#3) Oct 15, 2018
.gitignore initial commit Mar 10, 2018
.travis.yml just use stable Sep 15, 2018 -> v1.0.4 Jul 31, 2018
LICENSE Warn using consola instead of throwing Error (#1) Oct 4, 2018
appveyor.yml just use stable Sep 15, 2018
mocha.opts initial commit Mar 10, 2018
package.json 1.1.0 Nov 2, 2018
rollup.config.js feat: env vars to adjust warning behaviour (#2) Oct 15, 2018
tsconfig.json initial commit Mar 10, 2018
yarn.lock feat: update consola to 2.x Nov 2, 2018


Forked from devalue to log errors on non serializable properties rather than Error. And added support for objects with toJSON methods

Like JSON.stringify, but handles

  • cyclical references (obj.self = obj)
  • repeated references ([value, value])
  • undefined, Infinity, NaN, -0
  • regular expressions
  • dates
  • Map and Set

Try it out on



  • Human-readable output
  • Stringifying functions or non-POJOs


import devalue from '@nuxtjs/devalue';

let obj = { a: 1, b: 2 };
obj.c = 3;

devalue(obj); // '{a:1,b:2,c:3}'

obj.self = obj;
devalue(obj); // '(function(a){a.a=1;a.b=2;a.c=3;a.self=a;return a}({}))'

If devalue encounters a function or a non-POJO, it will throw an error.

XSS mitigation

Say you're server-rendering a page and want to serialize some state, which could include user input. JSON.stringify doesn't protect against XSS attacks:

const state = {
  userinput: `</script><script src=''>`

const template = `
  var preloaded = ${JSON.stringify(state)};

Which would result in this:

  var preloaded = {"userinput":"</script><script src=''>"};

Using devalue, we're protected against that attack:

const template = `
  var preloaded = ${devalue(state)};
  var preloaded = {userinput:"\\u003C\\u002Fscript\\u003E\\u003Cscript src=\'https:\\u002F\\\\u002Fmwahaha.js\'\\u003E"};

This, along with the fact that devalue bails on functions and non-POJOs, stops attackers from executing arbitrary code. Strings generated by devalue can be safely deserialized with eval or new Function:

const value = (0,eval)('(' + str + ')');

Other security considerations

While devalue prevents the XSS vulnerability shown above, meaning you can use it to send data from server to client, you should not send user data from client to server using the same method. Since it has to be evaluated, an attacker that successfully submitted data that bypassed devalue would have access to your system.

When using eval, ensure that you call it indirectly so that the evaluated code doesn't have access to the surrounding scope:

  const sensitiveData = 'Setec Astronomy';
  eval('sendToEvilServer(sensitiveData)'); // pwned :(
  (0,eval)('sendToEvilServer(sensitiveData)'); // nice try, evildoer!

Using new Function(code) is akin to using indirect eval.

See also