Sha256: 616b96c67b6f66b5e0b4d98242dfd14783ddfae9e3efd1e5dad7dee397e1bc8f

Contents?: true

Size: 1.18 KB

Versions: 46

Compression:

Stored size: 1.18 KB

Contents

# readJson(file, [options, callback])

Reads a JSON file and then parses it into an object. `options` are the same
that you'd pass to [`jsonFile.readFile`](https://github.com/jprichardson/node-jsonfile#readfilefilename-options-callback).

**Alias:** `readJSON()`

- `file` `<String>`
- `options` `<Object>`
- `callback` `<Function>`

## Example:

```js
const fs = require('fs-extra')

fs.readJson('./package.json', (err, packageObj) => {
  if (err) console.error(err)

  console.log(packageObj.version) // => 0.1.3
})

// Promise Usage
fs.readJson('./package.json')
.then(packageObj => {
  console.log(packageObj.version) // => 0.1.3
})
.catch(err => {
  console.error(err)
})
```

---

`readJson()` can take a `throws` option set to `false` and it won't throw if the JSON is invalid. Example:

```js
const fs = require('fs-extra')

const file = '/tmp/some-invalid.json'
const data = '{not valid JSON'
fs.writeFileSync(file, data)

fs.readJson(file, { throws: false }, (err, obj) => {
  if (err) console.error(err)

  console.log(obj) // => null
})

// Promise Usage
fs.readJson(file, { throws: false })
.then(obj => {
  console.log(obj) // => null
})
.catch(err => {
  console.error(err) // Not called
})
```

Version data entries

46 entries across 46 versions & 2 rubygems

Version Path
govuk_publishing_components-17.8.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-17.7.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-17.6.1 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-17.6.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-17.5.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-17.4.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-17.3.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-17.2.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-17.1.1 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-17.1.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-17.0.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-16.29.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-16.28.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-16.27.1 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-16.27.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-16.26.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-16.25.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-16.24.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-16.23.0 node_modules/fs-extra/docs/readJson.md
govuk_publishing_components-16.22.0 node_modules/fs-extra/docs/readJson.md