jsonuri

Use URI path to get or set data

Last updated 6 months ago by haozime .

MIT · Repository · Bugs · Original npm · Tarball · package.json

$ npm install jsonuri

SYNC missed versions from official npm registry.

JSON URI

Use URI style methods to operate data. All operations friendly support Vue-like frameworks.

Use

$ npm install jsonuri --save

import * as jsonuri from 'jsonuri'
// or
import { get, set, ... } from 'jsonuri' // recommended practice, friendly to tree-shaking

Example Data:

{
  "menu": {
    "id": 123,
    "list": [0, 1, 2, 3, 4],
    "popup": {
      "menuitem": [{
          "value": "New",
          "onclick": "CreateNewDoc()"
        },
        {
          "value": "Open",
          "onclick": "OpenDoc()"
        },
        {
          "value": "Close",
          "onclick": "CloseDoc()"
        }
      ]
    }
  }
}

Methods:

get (data, path)

Get the value of the specified data for the path.

Example:

jsonuri.get(data, 'menu/id')
// return 123

jsonuri.get(data, 'menu/popup/menuitem/0/value')
// return 'New'

jsonuri.get(data, 'menu/popup/menuitem/0/value/..')
// {value: "New", onclick: "CreateNewDoc()"}

set (data, path, value)

Set the value of the specified data for the path.

Example:

jsonuri.set(data, 'menu/id/', 789)
jsonuri.get(data, 'menu/id')
//789

rm (data, path)

Remove the value of the specified data for the path.

Example:

jsonuri.rm(data, 'menu/id')
jsonuri.get(data, 'menu/id') // undefined

mv (data, pathA, pathB, sequence)

Data A moved to target B before or after.

Example:

jsonuri.mv(data, 'menu/list/0', 'menu/list/3')
jsonuri.get(data, 'menu/list') // [1, 2, 3, 0, 4]
[see more](test/spec/mv_spec.js)


jsonuri.set(data, 'menu/list/',[0,1,2,3,4])
jsonuri.mv(data, 'menu/list/0', 'menu/list/3', 'before')
jsonuri.get(data, 'menu/list') // [1, 2, 0, 3, 4]

swap (data, pathA, pathB)

Data swap in an array.

Example:

jsonuri.swap(data, 'menu/list/0', 'menu/list/4')
jsonuri.get(data, 'menu/list') // [4, 1, 2, 3, 0]

jsonuri.swap(data, 'menu/list/0', 'menu/list/4')
jsonuri.get(data, 'menu/list') // [4, 1, 2, 3, 0]

insert (data, pathA, value, direction)

Insert data into an array that is described in the path.

Example:

jsonuri.insert(data, 'menu/list/0', 9999, 'before') // [9999, 0, 1, 2, 3, 4]

up(data, path, gap)

down(data, path, gap)

walk(data, descentionFn, ascentionFn)

Traverse each data of each node and value.

Example:

jsonuri.walk({a:{a1:'x'}}, (value, key, parent, { path }) => {
  console.log(value, key, parent, path)
})

// { a1: 'x' } 'a' { a: { a1: 'x' } } 'a'
// x a1 { a1: 'x' } 'a/a1'

normalizePath(path1, path2, ...)

Example:

jsonuri.normalizePath('a', 'b') // a/b

jsonuri.normalizePath(['a', 'b', '../'], 'c') // a/c

isCircular(obj)

Example:

jsonuri.isCircular({}) // return false
jsonuri.isCircular(window) // return true

var a = {}
jsonuri.set(a, '/b/c/d/e/f/g', a)
jsonuri.isCircular(a) // return true

Current Tags

3.4.5 ... latest (6 months ago)

85 Versions

Maintainers (2)

Downloads

Total 0

Today 0

This Week 0

This Month 0

Last Day 0

Last Week 0

Last Month 0

Dependencies (1)

idmp *

Dev Dependencies (21)

@babel/preset-env ^7.24.5
@babel/preset-typescript ^7.24.1
@types/jest ^29.5.12
@types/node ^20.12.8
@typescript-eslint/eslint-plugin ^7.8.0
codecov ^3.8.3
eslint ^9.2.0
eslint-config-standard-with-typescript ^43.0.1
eslint-plugin-import ^2.29.1
eslint-plugin-n ^17.4.0
eslint-plugin-node ^11.1.0
eslint-plugin-prefer-arrow ^1.2.3
eslint-plugin-promise ^6.1.1
gh-pages ^6.1.1
ghooks ^2.0.4
imod ^1.5.0
jest ^29.7.0
multi-shell ^2.0.0-alpha.1
rimraf ^5.0.5
tslib ^2.6.2
typescript ^5.4.5

Dependents (3)

© 2010 - cnpmjs.org x YWFE | Home | YWFE