@jsonurl/jsonurl

JSON→URL

About

RFC8259 describes the JSON data model and interchange format, which is widely used in application-level protocols including RESTful APIs. It is common for applications to request resources via the HTTP POST method, with JSON entities. However, POST is suboptimal for requests which do not modify a resource's state. JSON→URL defines a text format for the JSON data model suitable for use within a URL/URI.

Usage

JSON→URL is available as a commonjs module (suitable for use in Node), ES6 module, or a script that may be used directly in a browser.

NPM install

npm install @jsonurl/jsonurl --save

CJS

const JsonURL = require("@jsonurl/jsonurl");

ES6 (Node + Babel)

import JsonURL from "@jsonurl/jsonurl";

Browser script tag

<script
    src="https://cdn.jsdelivr.net/npm/@jsonurl/jsonurl@1.0.1"
    integrity="sha384-X9eggnze0lccwuooEyVZu+LN9+HDcchxa9L9K1NObZelfMNcGSzT822Ikr2eZ3WD"
    crossorigin="anonymous"></script>

The JavaScript API

Once included, the API is the same for all three.

let p = new JsonURL();
let value = p.parse( "(Hello:World!)" );

There are options available, but that's all you need to get started.

JSON→URL has no runtime dependencies.

Security

The parser is designed to parse untrusted input. It supports limits on the number of parsed values and depth of nested arrays or objects. When the limit is exceeded an Error is thrown, and sane limit values are set by default.

License

Changelog

v1.0.2

Added

• Add support for x-www-form-urlencoded style separators view commit

Changed

• update: Fix edge case of apos followed by string literal view commit
• doc: Mark non-exported classes as private view commit
• upgrade @babel/cli to 7.11.6
• upgrade eslint to 7.9.0
• upgrade eslint-plugin-jest to 23.18.0
• upgrade jest to 26.4.2
• upgrade jsdoc to 3.6.6
• upgrade prettier to 2.1.2
• upgrade rollup to 2.28.1
• upgrade @rollup/plugin-babel to 5.2.1
• upgrade rollup-plugin-terser to 7.0.2