?HAMA

Navigation

Breadcrumbs

Create

Edit File Size: 1.38 KB

/home/byroehnu/.trash/node_modules11/undefsafe/README.md

Text Base64

# 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'));
```

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
.github DIR	-	drwxr-xr-x	2026-02-03 15:06:46	Edit Download recursive recursive
lib DIR	-	drwxr-xr-x	2026-02-03 15:06:46	Edit Download recursive recursive
.jscsrc	364 B	lrw-r--r--	2026-02-03 15:06:44	Edit Download recursive recursive
.jshintrc	240 B	lrw-r--r--	2026-02-03 15:06:44	Edit Download recursive recursive
.travis.yml	283 B	lrw-r--r--	2026-02-03 15:06:46	Edit Download recursive recursive
example.js	245 B	lrw-r--r--	2026-02-03 15:06:46	Edit Download recursive recursive
LICENSE	1.09 KB	lrw-r--r--	2026-02-03 15:06:46	Edit Download recursive recursive
package.json	784 B	lrw-r--r--	2026-02-03 15:06:46	Edit Download recursive recursive
README.md	1.38 KB	lrw-r--r--	2026-02-03 15:06:46	Edit Download recursive recursive

Directory Contents