aboutsummaryrefslogtreecommitdiff
path: root/node_modules/fs-extra/docs/readJson.md
diff options
context:
space:
mode:
authorDimitri Staessens <[email protected]>2019-10-06 21:37:45 +0200
committerDimitri Staessens <[email protected]>2019-10-06 21:37:45 +0200
commit3c51c3be85bb0d1bdb87ea0d6632f1c256912f27 (patch)
treec7ccc8279b12c4f7bdbbb4270d617e48f51722e4 /node_modules/fs-extra/docs/readJson.md
parent412c104bebc507bea9c94fd53b5bdc4b64cbfe31 (diff)
downloadwebsite-3c51c3be85bb0d1bdb87ea0d6632f1c256912f27.tar.gz
website-3c51c3be85bb0d1bdb87ea0d6632f1c256912f27.zip
build: Add some required modules for node
Diffstat (limited to 'node_modules/fs-extra/docs/readJson.md')
-rw-r--r--node_modules/fs-extra/docs/readJson.md58
1 files changed, 58 insertions, 0 deletions
diff --git a/node_modules/fs-extra/docs/readJson.md b/node_modules/fs-extra/docs/readJson.md
new file mode 100644
index 0000000..6edc329
--- /dev/null
+++ b/node_modules/fs-extra/docs/readJson.md
@@ -0,0 +1,58 @@
+# 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
+})
+```