Get and set nested variables of an object, includes support for Backbone Models
// Import
import { setDeep, getDeep } from 'getsetdeep'
// Prepare
const obj = {
a: {
b: {
c: 3,
},
},
}
// Get
console.log(getDeep(obj, 'a.b.c')) // 3
console.log(setDeep(obj, 'a.b.c', 4)) // 4
console.log(getDeep(obj, 'a.b.c')) // 4
setDeep
also has a fourth argumentopts
for options, currently we support the options:onlyIfEmpty
defaults tofalse
, if specified totrue
thensetDeep
will only set the value if the current value isnull
orundefined
- We also work with getters
get(key)
and settersset(attrs, opts)
, enabling support for Backbone.js models as well as others
To satisfy the egos of some security researchers, just as you wouldn't do obj[prompt('some user input')] = 'value'
don't do setDeep(obj, prompt('some user input'), 'value')
, obviously. Rather than getsetdeep
preventing __proto__
access, we assume the consumers of this library are intelligent enough to do what they intend.
- Install:
npm install --save getsetdeep
- Import:
import * as pkg from ('getsetdeep')
- Require:
const pkg = require('getsetdeep')
import * as pkg from 'https://unpkg.com/getsetdeep@^4.15.0/edition-deno/index.ts'
<script type="module">
import * as pkg from '//cdn.skypack.dev/getsetdeep@^4.15.0'
</script>
<script type="module">
import * as pkg from '//unpkg.com/getsetdeep@^4.15.0'
</script>
<script type="module">
import * as pkg from '//dev.jspm.io/getsetdeep@4.15.0'
</script>
This package is published with the following editions:
getsetdeep/source/index.ts
is TypeScript source code with Import for modulesgetsetdeep/edition-browsers/index.js
is TypeScript compiled against ES2019 for web browsers with Import for modulesgetsetdeep
aliasesgetsetdeep/edition-esnext/index.js
getsetdeep/edition-esnext/index.js
is TypeScript compiled against ESNext for Node.js 10 || 12 || 14 || 15 with Require for modulesgetsetdeep/edition-esnext-esm/index.js
is TypeScript compiled against ESNext for Node.js 12 || 14 || 15 with Import for modulesgetsetdeep/edition-deno/index.ts
is TypeScript source code made to be compatible with Deno
Discover the release history by heading on over to the HISTORY.md
file.
Discover how you can contribute by heading on over to the CONTRIBUTING.md
file.
These amazing people are maintaining this project:
No sponsors yet! Will you be the first?
These amazing people have contributed code to this project:
Discover how you can contribute by heading on over to the CONTRIBUTING.md
file.
Unless stated otherwise all works are:
- Copyright © Bevry Pty Ltd
and licensed under: