stringify-object-es5

stringify-object

This fork of yeoman/stringify-object is ES5 compatible

Stringify an object/array like JSON.stringify just without all the double-quotes.

Useful for when you want to get the string representation of an object in a formatted way.

It also handles circular references and lets you specify quote type.

Install

$ npm install --save stringify-object

Usage

var obj = {
    foo: 'bar',
    'arr': [1, 2, 3],
    nested: { hello: "world" }
};
 
var pretty = stringifyObject(obj, {
    indent: '  ',
    singleQuotes: false
});
 
console.log(pretty);
/*
{
    foo: "bar",
    arr: [
        1,
        2,
        3
    ],
    nested: {
        hello: "world"
    }
}
*/

API

stringifyObject(input, [options])

Circular references will be replaced with "[Circular]".

input

Required
Type: object, array

options

indent

Type: string
Default: '\t'

Choose the indentation you prefer.

singleQuotes

Type: boolean
Default: true

Set to false to get double-quoted strings.

filter(obj, prop)

Type: function

Expected to return a boolean of whether to keep the object.

transform(obj, prop, originalResult)

Type: Function
Default: undefined

Expected to return a string that transforms the string that resulted from stringifying obj[prop]. This can be used to detect special types of objects that need to be stringified in a particular way. The transform function might return an alternate string in this case, otherwise returning the originalResult.

Here's an example that uses the transform option to mask fields named "password":

const obj = {
    user: 'becky',
    password: 'secret'
}
 
const pretty = stringifyObject(obj, {
    transform: function (obj, prop, originalResult) {
        if (prop === 'password') {
            return originalResult.replace(/\w/g,'*');
        } else {
            return originalResult;
        }
    }
});
 
console.log(pretty);
/*
{
    user: 'becky',
    password: '******'
}
*/

inlineCharacterLimit

Type: number Default: undefined

When set, will inline values up to inlineCharacterLimit length for the sake of more terse output.

For example, given the example at the top of the README:

var obj = {
    foo: 'bar',
    'arr': [1, 2, 3],
    nested: { hello: "world" }
};
 
var pretty = stringifyObject(obj, {
    indent: '  ',
    singleQuotes: false,
    inlineCharacterLimit: 12
});
 
console.log(pretty);
/*
{
    foo: "bar",
    arr: [1, 2, 3],
    nested: {
        hello: "world"
    }
}
*/

As you can see, arr was printed as a one-liner because its string was shorter than 12 characters.

License

BSD license © Yeoman Team