# stringify-object

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

Latest version **7.0.0** (published 2026-07-02) · BSD-2-Clause license · 0 weekly downloads

## Install

```sh
npm install stringify-object
pnpm add stringify-object
yarn add stringify-object
bun add stringify-object
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 7.0.0 |
| Published | 2026-07-02 |
| First published | 2012-12-11 |
| Weekly downloads | 0 |
| License | BSD-2-Clause |
| TypeScript types | bundled |
| Module format | ESM |
| Node | >=22 |
| Dependencies | 5 |
| Unpacked size | 12.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 325 |
| Author | Sindre Sorhus |
| Maintainers | sindresorhus |
| Keywords | object, stringify, pretty, print, dump, format, type, json |

## Links

- npm: https://www.npmjs.com/package/stringify-object
- Repository: https://github.com/sindresorhus/stringify-object
- Homepage: https://github.com/sindresorhus/stringify-object#readme
- Issues: https://github.com/sindresorhus/stringify-object/issues
- Funding: https://github.com/sponsors/sindresorhus
- npm.io page: https://npm.io/package/stringify-object

## Dependencies (5)

- [is-obj](https://npm.io/package/is-obj.md) ^3.0.0
- [is-regexp](https://npm.io/package/is-regexp.md) ^3.1.0
- [is-identifier](https://npm.io/package/is-identifier.md) ^1.0.1
- [quote-js-string](https://npm.io/package/quote-js-string.md) ^0.1.0
- [get-own-enumerable-keys](https://npm.io/package/get-own-enumerable-keys.md) ^1.0.0

## Alternatives

- [@mapbox/jsonlint-lines-primitives](https://npm.io/package/@mapbox/jsonlint-lines-primitives.md) — 5.3M weekly downloads
- [reftools](https://npm.io/package/reftools.md) — 3.5M weekly downloads
- [@hey-api/openapi-ts](https://npm.io/package/@hey-api/openapi-ts.md) — 3.5M weekly downloads
- [@mapbox/geojson-rewind](https://npm.io/package/@mapbox/geojson-rewind.md) — 2.4M weekly downloads
- [turbo-stream](https://npm.io/package/turbo-stream.md) — 1.7M weekly downloads

## Recent versions

- 7.0.0 (latest) — 2026-07-02
- 6.0.0 — 2025-09-07
- 5.0.0 — 2023-01-16
- 4.0.1 — 2022-02-15
- 4.0.0 — 2021-08-22
- 3.3.0 — 2018-10-16
- 3.2.2 — 2018-02-05
- 3.2.1 — 2017-09-23
- 3.2.0 — 2017-03-15
- 3.1.0 — 2016-11-24
- 3.0.0 — 2016-11-08
- 2.4.0 — 2016-06-13
- 2.3.1 — 2015-11-07
- 2.3.0 — 2015-07-28
- 2.2.0 — 2015-07-07
- … 15 more at https://npm.io/package/stringify-object/versions

## README

# stringify-object

> 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

```sh
npm install stringify-object
```

## Usage

```js
import stringifyObject from '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"
  }
}
*/

// Also works with Map and Set
const map = new Map([['key', 'value']]);
console.log(stringifyObject(map));
//=> new Map([
//=>   ['key', 'value']
//=> ])
```

## API

### stringifyObject(input, options?)

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

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

An own `__proto__` key is never included in the output, as emitting it would set the prototype instead of creating a property when the output is evaluated.

#### input

Type: `object | Array | Map | Set`

#### 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`.

When stringifying a `Map` or `Set`, `object` is the `Map`/`Set`, `property` is the entry's key (`Map`) or value (`Set`), and `originalResult` is the stringified value.

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

```js
import stringifyObject from '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:

```js
import stringifyObject from '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.

---
_Source: https://npm.io/package/stringify-object · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._