The json-refs npm package is a utility for working with JSON references, which are pointers within JSON objects that reference other parts of the JSON document. It helps resolve these references and can be used to make JSON documents easier to understand and manipulate by consolidating linked data.

What are json-refs's main functionalities?

Resolving JSON References

This feature allows the resolution of JSON references within a JSON document. The code sample demonstrates how to resolve references in a JSON file located at a specified path, with an option to resolve circular references.

{
  "jsonRefs": require('json-refs'),
  "path": './somePath/to/json',
  "options": { resolveCirculars: true },
  "resolvedJson": function() {
    var root = jsonRefs.resolveRefsAt(this.path, this.options).then(function (results) {
      console.log(results.resolved);
    }).catch(function (err) {
      console.error(err.stack);
    });
    return root;
  }
}

Finding JSON References

This feature involves identifying all the JSON references in a given JSON object. The code sample shows how to find all references, including those that might be invalid, within a JSON object.

{
  "jsonRefs": require('json-refs'),
  "jsonObject": { /* some JSON object */ },
  "options": { includeInvalid: true },
  "foundRefs": function() {
    var refs = jsonRefs.findRefs(this.jsonObject, this.options);
    console.log(refs);
    return refs;
  }
}

Other packages similar to json-refs

Readme

Source

json-refs

json-refs is a simple library for interacting with JSON References and JSON Pointers. While the main purpose of this library is to provide JSON References features, since JSON References are a combination of Object structure and a JSON Pointer, this library also provides some features for JSON Pointers as well.

Project Badges

Build status:
Dependencies:
Developer dependencies:
Downloads:
Gitter:
License:
Version:

Documentation

The documentation for this project can be found at https://github.com/whitlockjc/json-refs/blob/master/docs/README.md. Specific documentation can be found here:

API documentation can be found at https://github.com/whitlockjc/json-refs/blob/master/docs/API.md
CLI can be found at https://github.com/whitlockjc/json-refs/blob/master/docs/CLI.md

Installation

json-refs is available for both Node.js and the browser. Installation instructions for each environment are below.

Browser

json-refs binaries for the browser are available in the dist/ directory:

json-refs.js: 2,292kb, full source source maps
json-refs-min.js: 148kb, minified, compressed and no sourcemap

Of course, these links are for the master builds so feel free to download from the release of your choice. Once you've gotten them downloaded, to use the standalone binaries, your HTML include might look like this:

<!-- ... -->
<script src="json-refs.js"></script>
<!-- ... -->

Node.js

Installation for Node.js applications can be done via NPM.

npm install json-refs --save

If you plan on using the json-refs CLI executable, you can install json-refs globally like this:

npm install json-refs --global

After this, feel free to run json-refs help to see what you can do or view the CLI documentation linked above

Keywords

json

FAQs

What is json-refs?

Is json-refs popular?

Is json-refs well maintained?

Last updated on 25 Feb 2020

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install