JavaScript object manipulation (get/set/del) using JSON Pointer (RFC6901) and JSON Reference paths.
npm install pointer-propsJavaScript object manipulation (get/set/del) using JSON Pointer (RFC6901) syntax, and optional resolution of JSON References.
The usual ways:
``shell`
npm install pointer-props
Get or set a property, either using the JSON Pointer string or with an array:
`js`
import { get, set } from 'pointer-props'
const obj = { foo: { bar: 3 } }
get(obj, '/foo/bar') // => 3
get(obj, [ 'foo', 'bar' ]) // => 3
set(obj, '/foo/bar', 4) // => { foo: { bar: 4 } }
set(obj, [ 'foo', 'bar' ], 5) // => { foo: { bar: 5 } }
Resolve JSON Reference paths to the final non-referenced path (as an array):
`js`
import { resolve } from 'pointer-props'
const obj = {
foo: { $ref: '#/fizz/buzz' },
fizz: { buzz: 3 }
}
resolve('#/foo/bar') // => [ 'fizz', 'buzz' ]
Handles escaped strings, as expected:
`js`
const obj = {
'f/o/o': {
'b~a~r': 3
}
}
get(obj, '/f~1o~1o/b~0a~0r') // => 3
Generate escaped strings from a list of tokens, or a list of tokens from a string:
`js`
import { toPointer, toTokens } from 'pointer-props'
toPointer([ 'a/b', 'c~d' ]) // => "/a~1b/c~0d"
toTokens('/a~1b/c~0d') // => [ "a/b", "c~d" ]
Under the hood, the get/set functions use the amazing dset and dlv,
which should be pretty familiar.
Get a property using either a JSON Pointer string, or an array of already-unescaped accessor tokens.
`js`
import { get } from 'pointer-props'
const obj = { foo: { bar: 3 } }
get(obj, '/foo/bar') // => 3
get(obj, [ 'foo', 'bar' ]) // => 3
Set a property using either a JSON Pointer string, or an array of already-unescaped accessor tokens.
For convenience, the modified object is also returned.
`js`
import { set } from 'pointer-props'
const obj = {}
set(obj, '/foo/bar', 3)
console.log(obj.foo.bar) // => 3
set(obj, [ 'foo', 'bar' ], 4)
console.log(obj.foo.bar) // => 4
Remove a property using either a JSON Pointer string, or an array of already-unescaped accessor tokens.
For convenience, the modified object is also returned.
`js`
import { set } from 'pointer-props'
const obj = {}
set(obj, '/foo/bar', 3)
console.log(obj.foo.bar) // => 3
set(obj, [ 'foo', 'bar' ], 4)
console.log(obj.foo.bar) // => 4
Convert a JSON Pointer string to a list of unescaped accessor tokens.
`js`
import { toTokens } from 'pointer-props'
toTokens('/a~1b/c~0d') // => [ "a/b", "c~d" ]
Convert a list of unescaped accessor tokens into a JSON Pointer string.
`js`
import { toPointer } from 'pointer-props'
toPointer([ 'a/b', 'c~d' ]) // => "/a~1b/c~0d"
Given a JSON Pointer string and an object potentially containing JSON References (e.g. $ref), resolve all references and return the final path.
`js``
import { resolve } from 'pointer-props'
const obj = {
foo: { $ref: '#/bar' },
bar: { $ref: '#/fizz' },
fizz: { $ref: '#/buzz' },
buzz: 3
}
resolve('#/foo') // => [ 'buzz' ]
Published and released under the Very Open License.
If you need a commercial license, contact me here.