Function readJson

  • Reads a JSON file and then parses it into an object.

    Parameters

    Returns void

    Example

    import * as fs from 'fs-extra'

    // With a callback:
    fs.readJson('./package.json', (err, packageObj) => {
    if (err) console.error(err)
    console.log(packageObj.version) // => 0.1.3
    })

    // With Promises:
    fs.readJson('./package.json')
    .then(packageObj => {
    console.log(packageObj.version) // => 0.1.3
    })
    .catch(err => {
    console.error(err)
    })

    // With async/await:
    async function asyncAwait () {
    try {
    const packageObj = await fs.readJson('./package.json')
    console.log(packageObj.version) // => 0.1.3
    } catch (err) {
    console.error(err)
    }
    }

    asyncAwait()

    // `readJsonSync()` can take a `throws` option set to `false` and it won't throw if the JSON is invalid. Example:
    const file = '/tmp/some-invalid.json'
    const data = '{not valid JSON'
    fs.writeFileSync(file, data)

    // With a callback:
    fs.readJson(file, { throws: false }, (err, obj) => {
    if (err) console.error(err)
    console.log(obj) // => null
    })

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

    // With async/await:
    async function asyncAwaitThrows () {
    const obj = await fs.readJson(file, { throws: false })
    console.log(obj) // => null
    }

    asyncAwaitThrows()

    See

    https://github.com/jprichardson/node-jsonfile#readfilefilename-options-callback

  • Parameters

    Returns void

  • Parameters

    Returns Promise<any>

Generated using TypeDoc