File: README.md

package info (click to toggle)
node-obj-util 2.0.0-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, sid, trixie
  • size: 76 kB
  • sloc: javascript: 43; makefile: 2
file content (49 lines) | stat: -rw-r--r-- 1,218 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
# obj-util
> A simple helper to set/get keys from objects using a string path like 'some.key.here'

## Install

```bash
npm i --save obj-util
```

## Usage

### obj.getKeyValue 

Returns the value from the given object which matches the passed key
- **param** obj {Object} The object to get the values from
- **param** key {String} a string representing a key in the object. Subkeys are supported separating them with dots. i.e. `key1.subkey1.subsubkey1`
- **returns** {Mixed} the value of the given key in the passed obj

```javascript
var objUtil = require('obj-util');

var obj = {
  some: {
    key: 'some value'
  }
};

// getKeyValue
objUtil.getKeyValue(obj, 'some.key'); // 'some value'
```

### obj.setKeyValue

Sets a value in an object if a matching key is found inside the given object

- **param** obj {Object} the object where to set the value using if the key is found
- **param** key {String} a string that represents the key. Subkeys are supported by separating them with dots.
- **param** val the value to be set in the object

```javascript
var objUtil = require('obj-util');

var obj = {
};
objUtil.setKeyValue(obj, 'some.key', 'some value');
obj.some.key === 'some value' //==> true
```

That's it!