json-crawl

json-crawl

This package provides utility functions for crawling/cloning json objects like a tree

Purpose

The purpose of this package is to simplify the traversal and manipulation of complex JSON objects in a tree-like structure. It provides functions that allow you to iterate over each node of a JSON object, perform custom operations, and clone objects deeply while maintaining independence between the original and cloned objects. You can use crawl/syncCrawl to traverse a JSON object and perform custom operations, such as logging, data transformation, or validation, at each node. The hooks allow you to customize the behavior according to your specific requirements.

Features

• Crawling: The crawl/syncCrawl function allows you to traverse a JSON object, performing custom operations at each node using hooks.
• Cloning: The clone/syncClone function creates a deep copy of a JSON object, ensuring that nested objects and arrays are also cloned.
• Customizable Hooks: Both crawl and clone functions accept hooks, allowing you to provide custom logic for each node during crawling or cloning. Hooks can modify values, state, rules or perform any desired operations.
• Support for Async Hooks: The crawl and clone functions supports asynchronous hooks, allowing you to perform asynchronous operations during crawling.

Installation

npm install json-crawl --save

Usage

Nodejs

Crawls through a JSON object, performing custom operations at each node using the provided hooks.

import { syncClone, syncCrawl } from 'json-crawl'

const data = {
  // Your JSON object
};

const hooks = [
  ({ value, path, key, state, rules }) => {
    // Custom logic for each node

    // Modify value, state, or perform any desired operations
    return { 
      value: newValue,               // updated value of current node for next crawl steps
      state: newState,               // updated state for next crawl step
      rules: newRules                // updated rules for next crawl step
      exitHook,                      // on exit hook for current node
      terminate: true,               // crawl should be terminated
      done: true                     // crawl of current node should be terminated
    }
    // return void - if no operations are required
  },
  // Array of hooks for custom operations during cloning
];

const params = {
  state?: {
    // Initial state object for hooks (optional)
  },

  rules?: {
    // Crawl rules map (optional)
  }
};

// deep Clone
const cloned = syncClone(data, hooks, params)

// crawl
syncCrawl(data, hooks, params)

Contributing

When contributing, keep in mind that it is an objective of json-crawl to have no package dependencies. This may change in the future, but for now, no-dependencies.

Please run the unit tests before submitting your PR: npm test. Hopefully your PR includes additional unit tests to illustrate your change/modification!

License

MIT