2016-10-10 03:43:44 +02:00
# stringify-object [![Build Status](https://secure.travis-ci.org/yeoman/stringify-object.svg?branch=master)](http://travis-ci.org/yeoman/stringify-object)
2017-08-14 05:01:11 +02:00
> Stringify an object/array like JSON.stringify just without all the double-quotes
2016-10-10 03:43:44 +02:00
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
```js
2017-08-14 05:01:11 +02:00
const stringifyObject = require('stringify-object');
const obj = {
2016-10-10 03:43:44 +02:00
foo: 'bar',
'arr': [1, 2, 3],
nested: { hello: "world" }
};
2017-08-14 05:01:11 +02:00
const pretty = stringifyObject(obj, {
2016-10-10 03:43:44 +02:00
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
2017-08-14 05:01:11 +02:00
Type: `Object` `Array`
2016-10-10 03:43:44 +02:00
#### options
##### indent
2017-08-14 05:01:11 +02:00
Type: `string` < br >
2016-10-10 03:43:44 +02:00
Default: `'\t'`
2017-08-14 05:01:11 +02:00
Preferred indentation.
2016-10-10 03:43:44 +02:00
##### singleQuotes
2017-08-14 05:01:11 +02:00
Type: `boolean` < br >
2016-10-10 03:43:44 +02:00
Default: `true`
Set to false to get double-quoted strings.
##### filter(obj, prop)
2017-08-14 05:01:11 +02:00
Type: `Function`
Expected to return a `boolean` of whether to include the property `prop` of the object `obj` in the output.
##### transform(obj, prop, originalResult)
Type: `Function` < br >
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":
```js
const obj = {
user: 'becky',
password: 'secret'
}
const pretty = stringifyObject(obj, {
transform: (obj, prop, originalResult) => {
if (prop === 'password') {
return originalResult.replace(/\w/g, '*');
} else {
return originalResult;
}
}
});
console.log(pretty);
/*
{
user: 'becky',
password: '******'
}
*/
```
2016-10-10 03:43:44 +02:00
##### inlineCharacterLimit
Type: `number`
2017-08-14 05:01:11 +02:00
When set, will inline values up to `inlineCharacterLimit` length for the sake of more terse output.
2016-10-10 03:43:44 +02:00
For example, given the example at the top of the README:
```js
2017-08-14 05:01:11 +02:00
const obj = {
2016-10-10 03:43:44 +02:00
foo: 'bar',
'arr': [1, 2, 3],
nested: { hello: "world" }
};
2017-08-14 05:01:11 +02:00
const pretty = stringifyObject(obj, {
2016-10-10 03:43:44 +02:00
indent: ' ',
singleQuotes: false,
inlineCharacterLimit: 12
});
console.log(pretty);
/*
{
foo: "bar",
arr: [1, 2, 3],
nested: {
hello: "world"
}
}
*/
```
2017-08-14 05:01:11 +02:00
As you can see, `arr` was printed as a one-liner because its string was shorter than 12 characters.
2016-10-10 03:43:44 +02:00
## License
[BSD license ](http://opensource.org/licenses/bsd-license.php ) © Yeoman Team