@jsonhero/parser v1.0.9

JSON Hero Parser

A parser that walks through a JSON file and for each value determines the path to it, the type and paths to any children. It also builds a model of the structure of the data.

How to install

npm install @jsonhero/parser

Getting started

Importing

You can require

const { parse } = require('@jsonhero/parser');

Or if you're using TypeScript:

import { parse } from '@jsonhero/parser';

How to parse

Sample object

Given the following JSON variable called employees

let employees = {
  people: [
    {
      name: 'Matt',
      age: 36,
    },
    {
      name: 'James',
      age: 39,
    },
  ],
  count: 2,
};

Parsing

You parse a JSON object like this:

let structure = parse(employees);

Values and Structure

There are two top-level objects called values and structure.

Values has details for every single value from the parsed object. Structure groups together details to represent the actual data structure.

They have the following properties for each element:

The output

This produces an object that looks like this:

{
  "values": {
    "rootPath": "$",
    "values": {
      "$": {
        "path": "$",
        "name": "Root",
        "displayName": "Root",
        "value": {
          "people": [
            { "name": "Matt", "age": 36 },
            { "name": "James", "age": 39 }
          ],
          "count": 2
        },
        "type": {
          "name": "object",
          "value": {
            "people": [
              { "name": "Matt", "age": 36 },
              { "name": "James", "age": 39 }
            ],
            "count": 2
          }
        },
        "children": ["$.people", "$.count"]
      },
      "$.people": {
        "path": "$.people",
        "name": "people",
        "displayName": "People",
        "value": [
          { "name": "Matt", "age": 36 },
          { "name": "James", "age": 39 }
        ],
        "type": {
          "name": "array",
          "value": [
            { "name": "Matt", "age": 36 },
            { "name": "James", "age": 39 }
          ]
        },
        "children": ["$.people.0", "$.people.1"]
      },
      "$.people.0": {
        "path": "$.people.0",
        "name": "people 0",
        "displayName": "People 0",
        "value": { "name": "Matt", "age": 36 },
        "type": { "name": "object", "value": { "name": "Matt", "age": 36 } },
        "children": ["$.people.0.name", "$.people.0.age"]
      },
      "$.people.0.name": {
        "path": "$.people.0.name",
        "name": "name",
        "displayName": "Name",
        "value": "Matt",
        "type": { "name": "string", "value": "Matt" },
        "children": null
      },
      "$.people.0.age": {
        "path": "$.people.0.age",
        "name": "age",
        "displayName": "Age",
        "value": 36,
        "type": { "name": "int", "value": 36 },
        "children": null
      },
      "$.people.1": {
        "path": "$.people.1",
        "name": "people 1",
        "displayName": "People 1",
        "value": { "name": "James", "age": 39 },
        "type": { "name": "object", "value": { "name": "James", "age": 39 } },
        "children": ["$.people.1.name", "$.people.1.age"]
      },
      "$.people.1.name": {
        "path": "$.people.1.name",
        "name": "name",
        "displayName": "Name",
        "value": "James",
        "type": { "name": "string", "value": "James" },
        "children": null
      },
      "$.people.1.age": {
        "path": "$.people.1.age",
        "name": "age",
        "displayName": "Age",
        "value": 39,
        "type": { "name": "int", "value": 39 },
        "children": null
      },
      "$.count": {
        "path": "$.count",
        "name": "count",
        "displayName": "Count",
        "value": 2,
        "type": { "name": "int", "value": 2 },
        "children": null
      }
    }
  },
  "structure": {
    "rootPath": "$",
    "values": {
      "$": {
        "path": "$",
        "name": "Root",
        "displayName": "Root",
        "type": {
          "name": "object",
          "value": {
            "people": [
              { "name": "Matt", "age": 36 },
              { "name": "James", "age": 39 }
            ],
            "count": 2
          }
        },
        "children": ["$.people", "$.count"]
      },
      "$.people": {
        "path": "$.people",
        "name": "people",
        "displayName": "People",
        "type": {
          "name": "array",
          "value": [
            { "name": "Matt", "age": 36 },
            { "name": "James", "age": 39 }
          ]
        },
        "children": ["$.people.*"]
      },
      "$.people.*": {
        "path": "$.people.*",
        "name": "people",
        "displayName": "People",
        "type": { "name": "object", "value": { "name": "Matt", "age": 36 } },
        "children": ["$.people.*.name", "$.people.*.age"]
      },
      "$.people.*.name": {
        "path": "$.people.*.name",
        "name": "name",
        "displayName": "Name",
        "type": { "name": "string", "value": "Matt" },
        "children": null
      },
      "$.people.*.age": {
        "path": "$.people.*.age",
        "name": "age",
        "displayName": "Age",
        "type": { "name": "int", "value": 36 },
        "children": null
      },
      "$.count": {
        "path": "$.count",
        "name": "count",
        "displayName": "Count",
        "type": { "name": "int", "value": 2 },
        "children": null
      }
    }
  }
}