Popularity
3.4
Declining
Activity
0.0
Declining
233
18
40

Code Quality Rank: L3
Monthly Downloads: 0
Programming language: JavaScript
License: BSD 2-clause "Simplified" License
Tags: JSON     Miscellaneous     Stringify     Object     Pretty     Format     Print     Type     Dump    
Latest version: v3.3.0

stringify-object alternatives and similar modules

Based on the "Miscellaneous" category

Do you think we are missing an alternative of stringify-object or a related project?

Add another 'Miscellaneous' Module

README

stringify-object Build Status

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 stringify-object

Usage

const stringifyObject = require('stringify-object');

const object = {
    foo: 'bar',
    'arr': [1, 2, 3],
    nested: {
        hello: "world"
    }
};

const pretty = stringifyObject(object, {
    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]".

Object keys are only quoted when necessary, for example, {'foo-bar': true}.

input

Type: object | Array

options

Type: object

indent

Type: string Default: \t

Preferred indentation.

singleQuotes

Type: boolean Default: true

Set to false to get double-quoted strings.

filter(object, property)

Type: Function

Expected to return a boolean of whether to include the property property of the object object in the output.

transform(object, property, originalResult)

Type: Function Default: undefined

Expected to return a string that transforms the string that resulted from stringifying object[property]. 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 stringifyObject = require('stringify-object');

const object = {
    user: 'becky',
    password: 'secret'
};

const pretty = stringifyObject(object, {
    transform: (object, property, originalResult) => {
        if (property === 'password') {
            return originalResult.replace(/\w/g, '*');
        }

        return originalResult;
    }
});

console.log(pretty);
/*
{
    user: 'becky',
    password: '******'
}
*/
inlineCharacterLimit

Type: number

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:

const stringifyObject = require('stringify-object');

const object = {
    foo: 'bar',
    'arr': [1, 2, 3],
    nested: {
        hello: "world"
    }
};

const pretty = stringifyObject(object, {
    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.


Get professional support for this package with a Tidelift subscription Tidelift helps make open source sustainable for maintainers while giving companiesassurances about security, maintenance, and licensing for their dependencies.