e5d578a849
Disable the confirmation dialog when deleting files in the VS Code explorer to streamline the development workflow and reduce friction during file management operations.
64 lines
1.4 KiB
Markdown
64 lines
1.4 KiB
Markdown
# undefsafe
|
|
|
|
Simple *function* for retrieving deep object properties without getting "Cannot read property 'X' of undefined"
|
|
|
|
Can also be used to safely set deep values.
|
|
|
|
## Usage
|
|
|
|
```js
|
|
var object = {
|
|
a: {
|
|
b: {
|
|
c: 1,
|
|
d: [1,2,3],
|
|
e: 'remy'
|
|
}
|
|
}
|
|
};
|
|
|
|
console.log(undefsafe(object, 'a.b.e')); // "remy"
|
|
console.log(undefsafe(object, 'a.b.not.found')); // undefined
|
|
```
|
|
|
|
Demo: [https://jsbin.com/eroqame/3/edit?js,console](https://jsbin.com/eroqame/3/edit?js,console)
|
|
|
|
## Setting
|
|
|
|
```js
|
|
var object = {
|
|
a: {
|
|
b: [1,2,3]
|
|
}
|
|
};
|
|
|
|
// modified object
|
|
var res = undefsafe(object, 'a.b.0', 10);
|
|
|
|
console.log(object); // { a: { b: [10, 2, 3] } }
|
|
console.log(res); // 1 - previous value
|
|
```
|
|
|
|
## Star rules in paths
|
|
|
|
As of 1.2.0, `undefsafe` supports a `*` in the path if you want to search all of the properties (or array elements) for a particular element.
|
|
|
|
The function will only return a single result, either the 3rd argument validation value, or the first positive match. For example, the following github data:
|
|
|
|
```js
|
|
const githubData = {
|
|
commits: [{
|
|
modified: [
|
|
"one",
|
|
"two"
|
|
]
|
|
}, /* ... */ ]
|
|
};
|
|
|
|
// first modified file found in the first commit
|
|
console.log(undefsafe(githubData, 'commits.*.modified.0'));
|
|
|
|
// returns `two` or undefined if not found
|
|
console.log(undefsafe(githubData, 'commits.*.modified.*', 'two'));
|
|
```
|