write-json-file

Stringify and write JSON to a file atomically


Keywords
write, json, stringify, file, fs, graceful, stable, sort, newline, indent, atomic, atomically
License
MIT
Install
npm install write-json-file@5.0.0

Documentation

write-json-file Build Status

Stringify and write JSON to a file atomically

Creates directories for you as needed.

Install

$ npm install write-json-file

Usage

const writeJsonFile = require('write-json-file');

(async () => {
	await writeJsonFile('foo.json', {foo: true});
})();

API

writeJsonFile(filePath, data, [options])

Returns a Promise.

writeJsonFile.sync(filePath, data, [options])

options

Type: object

indent

Type: string | number
Default: '\t'

Indentation as a string or number of spaces.

Pass in undefined for no formatting.

detectIndent

Type: boolean
Default: false

Detect indentation automatically if the file exists.

sortKeys

Type: boolean | Function
Default: false

Sort the keys recursively.
Optionally pass in a compare function.

replacer

Type: Function

Passed into JSON.stringify.

mode

Type: number
Default: 0o666

Mode used when writing the file.

Related

License

MIT © Sindre Sorhus