lib: add json() function

The json function allows parsing JSON strings into structured data.

Signed-off-by: Jo-Philipp Wich <jo@mein.io>

1 files changed, 10 insertions, 0 deletions

diff --git a/README.md b/README.md
index 07b384f..d3bf8da 100644
--- a/README.md
+++ b/README.md
@@ -945,3 +945,13 @@ replace("barfoobaz", /(.)(.)(.)/g, function(m, c1, c2, c3) {
     return c3 + c2 + c1;
 })                                                          // raboofzab
 ```
+
+#### 6.49. `json(str)`
+
+Parse the given string as JSON and return the resulting value. Throws an
+exception on parse errors, trailing garbage or premature EOF.
+
+```javascript
+json('{"a":true, "b":123}')   // { "a": true, "b": 123 }
+json('[1,2,')                 // Throws exception
+```