deepdash
Version:
โ ๐eep standalone lib / ๐odash extension: โ eachDeep โ filterDeep โ mapDeep โ reduceDeep โ pickDeep โ omitDeep โ keysDeep โ index โ condenseDeep โฎ Parents stack โฎ Circular check โฎ Leaves only mode โฎ Children mode โฎ cherry-pick โฎ esm
1,299 lines (1,166 loc) โข 38.7 kB
Markdown
<img src="deepdash.svg?sanitize=true" width="64px"/>
## Deepdash
eachDeep, filterDeep, findDeep, someDeep, omitDeep, pickDeep, keysDeep etc..
Tree traversal library written in Underscore/Lodash fashion.
Standalone or as a Lodash mixin extension
> Deepdash lib is used in [PlanZed.org](https://planzed.org/) - awesome cloud mind map app created by the author of deepdash.
Plz check it, it's free and I need [feedback](https://github.com/YuriGor/PlanZed.org) ๐
[](#contributors-)
[](https://snyk.io/test/npm/deepdash) [](https://travis-ci.org/YuriGor/deepdash) [](https://coveralls.io/github/YuriGor/deepdash?branch=master) <br>
[](https://nodei.co/npm/deepdash/)
### Installation
#### In a browser
Load [script](https://cdn.jsdelivr.net/npm/deepdash/browser/deepdash.min.js) after Lodash, then pass a lodash instance to the deepdash function:
```html
<script src="https://cdn.jsdelivr.net/npm/lodash/lodash.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/deepdash/browser/deepdash.min.js"></script>
<script>
deepdash(_);
console.log(_.eachDeep); // --> new methods mixed into Lodash
</script>
```
If you don't use Lodash - there is a standalone version:
```html
<script src="https://cdn.jsdelivr.net/npm/deepdash/browser/deepdash.standalone.min.js"></script>
<script>
console.log(deepdash.eachDeep); // --> all the methods just work
</script>
```
Standalone Deepdash weighs more then "dry" version, because it includes some of cherry-picked Lodash methods it depends on.
But it's better to use Standalone version, than include full Lodash just as dependency, if you don't need Lodash.
#### Using npm:
```
npm i --save deepdash
```
In Node.js:
```js
// load Lodash if you need it
const _ = require('lodash');
//mixin all the methods into Lodash object
require('deepdash')(_);
// or cherry-pick method you only need and mix it into lodash
require('deepdash/addFilterDeep')(_);
// or cherry-pick method separately if you don't want to mutate Lodash instance
const filterDeep = require('deepdash/getFilterDeep')(_);
// If you don't need Lodash - there is standalone version
const deepdash = require('deepdash/standalone'); // full
const filterDeep = require('deepdash/filterDeep'); // or separate standalone methods
```
There is also deepdash as ES6 module
```
npm i --save deepdash-es
```
```js
import lodash from 'lodash-es';
import deepdash from 'deepdash-es';
const _ = deepdash(lodash);
```
in the ES package there are same cherry-pick and/or standalone methods as in the main package.
```js
import filterDeep from 'deepdash-es/filterDeep';
```
or
```js
import { filterDeep } from 'deepdash-es/standalone';
```
or
```js
import _ from 'lodash-es';
import getFilterDeep from 'deepdash-es/getFilterDeep';
const filterDeep = getFilterDeep(_);
```
or
```js
import _ from 'lodash-es';
import addFilterDeep from 'deepdash-es/addFilterDeep';
addFilterDeep(_);// --> _.filterDeep
```
## Demo
[Example react+redux app](https://codesandbox.io/s/github/YuriGor/deepdash-example-comments/) with nested comments filtered by Deepdash.([source is here](https://github.com/YuriGor/deepdash-example-comments/tree/master/))
## Methods
### eachDeep (forEachDeep)
โบ iterate over all the children and sub-children [๐ see docs](https://deepdash.io/#eachdeep-foreachdeep)
<details>
<summary>expand example</summary>
<details>
<summary> let children = [/* expand to see */];</summary>
```js
let children = [
{
description: 'description for node 1',
comment: 'comment for node 1',
note: 'note for node 1',
name: 'node 1',
bad: false,
children: [
{
description: 'description for node 1.1',
comment: 'comment for node 1.1',
note: 'note for node 1.1',
name: 'node 1.1',
bad: false,
},
{
description: 'description for node 1.2',
comment: 'comment for node 1.2',
note: 'note for node 1.2',
name: 'node 1.2',
good: true,
},
{
description: 'description for node 1.3',
comment: 'comment for node 1.3',
note: 'note for node 1.3',
name: 'node 1.3',
bad: true,
good: false,
},
],
},
{
description: 'description for node 2',
comment: 'comment for node 2',
note: 'note for node 2',
name: 'node 2',
good: true,
children: [
{
description: 'description for node 2.1',
comment: 'comment for node 2.1',
note: 'note for node 2.1',
name: 'node 2.1',
bad: false,
},
{
description: 'description for node 2.2',
comment: 'comment for node 2.2',
note: 'note for node 2.2',
name: 'node 2.2',
good: true,
},
{
description: 'description for node 2.3',
comment: 'comment for node 2.3',
note: 'note for node 2.3',
name: 'node 2.3',
bad: true,
good: false,
},
],
},
{
description: 'description for node 3',
comment: 'comment for node 3',
note: 'note for node 3',
name: 'node 3',
bad: true,
good: false,
children: [
{
description: 'description for node 3.1',
comment: 'comment for node 3.1',
note: 'note for node 3.1',
name: 'node 3.1',
bad: false,
},
{
description: 'description for node 3.2',
comment: 'comment for node 3.2',
note: 'note for node 3.2',
name: 'node 3.2',
good: true,
},
{
description: 'description for node 3.3',
comment: 'comment for node 3.3',
note: 'note for node 3.3',
name: 'node 3.3',
bad: true,
good: false,
},
],
},
];
```
</details>
```js
function displayField(val, key, parent, context) {
if (_.isArray(parent)) {
key = '[' + key + ']';
}
console.log(
_.repeat(' ', context.depth) +
'โ ' +
key +
': ' +
(_.isArray(val)
? '[' + val.length + ']'
: _.isObject(val)
? '{' + (val.name || '') + '}'
: val)
);
}
console.log('\n = Iterate over tree (each child object) = \n');
_.eachDeep(children, displayField, { childrenPath: 'children' });
console.log('\n = Iterate over object (each field) = \n');
_.eachDeep(children, displayField);
```
<details>
<summary>Console: </summary>
```
= Iterate over tree (each child object) =
โ [0]: {node 1}
โ [0]: {node 1.1}
โ [1]: {node 1.2}
โ [2]: {node 1.3}
โ [1]: {node 2}
โ [0]: {node 2.1}
โ [1]: {node 2.2}
โ [2]: {node 2.3}
โ [2]: {node 3}
โ [0]: {node 3.1}
โ [1]: {node 3.2}
โ [2]: {node 3.3}
= Iterate over object (each field) =
โ [0]: {node 1}
โ description: description for node 1
โ comment: comment for node 1
โ note: note for node 1
โ name: node 1
โ bad: false
โ children: [3]
โ [0]: {node 1.1}
โ description: description for node 1.1
โ comment: comment for node 1.1
โ note: note for node 1.1
โ name: node 1.1
โ bad: false
โ [1]: {node 1.2}
โ description: description for node 1.2
โ comment: comment for node 1.2
โ note: note for node 1.2
โ name: node 1.2
โ good: true
โ [2]: {node 1.3}
โ description: description for node 1.3
โ comment: comment for node 1.3
โ note: note for node 1.3
โ name: node 1.3
โ bad: true
โ good: false
โ [1]: {node 2}
โ description: description for node 2
โ comment: comment for node 2
โ note: note for node 2
โ name: node 2
โ good: true
โ children: [3]
โ [0]: {node 2.1}
โ description: description for node 2.1
โ comment: comment for node 2.1
โ note: note for node 2.1
โ name: node 2.1
โ bad: false
โ [1]: {node 2.2}
โ description: description for node 2.2
โ comment: comment for node 2.2
โ note: note for node 2.2
โ name: node 2.2
โ good: true
โ [2]: {node 2.3}
โ description: description for node 2.3
โ comment: comment for node 2.3
โ note: note for node 2.3
โ name: node 2.3
โ bad: true
โ good: false
โ [2]: {node 3}
โ description: description for node 3
โ comment: comment for node 3
โ note: note for node 3
โ name: node 3
โ bad: true
โ good: false
โ children: [3]
โ [0]: {node 3.1}
โ description: description for node 3.1
โ comment: comment for node 3.1
โ note: note for node 3.1
โ name: node 3.1
โ bad: false
โ [1]: {node 3.2}
โ description: description for node 3.2
โ comment: comment for node 3.2
โ note: note for node 3.2
โ name: node 3.2
โ good: true
โ [2]: {node 3.3}
โ description: description for node 3.3
โ comment: comment for node 3.3
โ note: note for node 3.3
โ name: node 3.3
โ bad: true
โ good: false
```
</details>
</details>
[Try it yourself โบโบโบ](https://codepen.io/yurigor/pen/BeBEqx?editors=0010)
### filterDeep
โบ deep filter object [๐ see docs](https://deepdash.io/#filterdeep)
<details>
<summary>expand example</summary>
<details>
<summary> let children = [/* expand to see */];</summary>
```js
let children = [
{
description: 'description for node 1',
comment: 'comment for node 1',
note: 'note for node 1',
name: 'node 1',
bad: false,
children: [
{
description: 'description for node 1.1',
comment: 'comment for node 1.1',
note: 'note for node 1.1',
name: 'node 1.1',
bad: false,
},
{
description: 'description for node 1.2',
comment: 'comment for node 1.2',
note: 'note for node 1.2',
name: 'node 1.2',
good: true,
},
{
description: 'description for node 1.3',
comment: 'comment for node 1.3',
note: 'note for node 1.3',
name: 'node 1.3',
bad: true,
good: false,
},
],
},
{
description: 'description for node 2',
comment: 'comment for node 2',
note: 'note for node 2',
name: 'node 2',
good: true,
children: [
{
description: 'description for node 2.1',
comment: 'comment for node 2.1',
note: 'note for node 2.1',
name: 'node 2.1',
bad: false,
},
{
description: 'description for node 2.2',
comment: 'comment for node 2.2',
note: 'note for node 2.2',
name: 'node 2.2',
good: true,
},
{
description: 'description for node 2.3',
comment: 'comment for node 2.3',
note: 'note for node 2.3',
name: 'node 2.3',
bad: true,
good: false,
},
],
},
{
description: 'description for node 3',
comment: 'comment for node 3',
note: 'note for node 3',
name: 'node 3',
bad: true,
good: false,
children: [
{
description: 'description for node 3.1',
comment: 'comment for node 3.1',
note: 'note for node 3.1',
name: 'node 3.1',
bad: false,
},
{
description: 'description for node 3.2',
comment: 'comment for node 3.2',
note: 'note for node 3.2',
name: 'node 3.2',
good: true,
},
{
description: 'description for node 3.3',
comment: 'comment for node 3.3',
note: 'note for node 3.3',
name: 'node 3.3',
bad: true,
good: false,
},
],
},
];
```
</details>
```js
console.log('\n = Filter tree (good children) = \n');
console.log(
_.filterDeep(children, 'good', { childrenPath: 'children' })
);
console.log('\n = Filter object (names of good children) = \n');
console.log(
_.filterDeep(children, (val, key, parent) => {
if (key == 'name' && parent.good) return true;
})
);
```
<details>
<summary>Console:</summary>
```
= Filter tree (good children) =
[
{
"description": "description for node 1",
"comment": "comment for node 1",
"note": "note for node 1",
"name": "node 1",
"bad": false,
"children": [
{
"description": "description for node 1.2",
"comment": "comment for node 1.2",
"note": "note for node 1.2",
"name": "node 1.2",
"good": true
}
]
},
{
"description": "description for node 2",
"comment": "comment for node 2",
"note": "note for node 2",
"name": "node 2",
"good": true,
"children": [
{
"description": "description for node 2.2",
"comment": "comment for node 2.2",
"note": "note for node 2.2",
"name": "node 2.2",
"good": true
}
]
},
{
"description": "description for node 3",
"comment": "comment for node 3",
"note": "note for node 3",
"name": "node 3",
"bad": true,
"good": false,
"children": [
{
"description": "description for node 3.2",
"comment": "comment for node 3.2",
"note": "note for node 3.2",
"name": "node 3.2",
"good": true
}
]
}
]
= Filter object (names of good children) =
[
{
"children": [
{
"name": "node 1.2"
}
]
},
{
"name": "node 2",
"children": [
{
"name": "node 2.2"
}
]
},
{
"children": [
{
"name": "node 3.2"
}
]
}
]
```
</details>
</details>
[Try it yourself โบโบโบ](https://codepen.io/yurigor/pen/eaOaQg?editors=0010)
### findDeep
โบ find first matching deep meta-value [๐ see docs](https://deepdash.io/#finddeep)
<details>
<summary>example a bit later</summary>
<details>
<summary> let children = [/* expand to see */];</summary>
```js
// next time
```
</details>
```js
// sorry
```
<details>
<summary>Console:</summary>
```
โค๏ธ
```
</details>
</details>
[Try it yourself (no yet) โบโบโบ](https://codepen.io/yurigor)
### findValueDeep
โบ find first matching deep value [๐ see docs](https://deepdash.io/#findvaluedeep)
<details>
<summary>example a bit later</summary>
<details>
<summary> let children = [/* expand to see */];</summary>
```js
// next time
```
</details>
```js
// sorry
```
<details>
<summary>Console:</summary>
```
โค๏ธ
```
</details>
</details>
[Try it yourself (no yet) โบโบโบ](https://codepen.io/yurigor)
### findPathDeep
โบ find the path of the first matching deep value [๐ see docs](https://deepdash.io/#findpathdeep)
<details>
<summary>example a bit later</summary>
<details>
<summary> let children = [/* expand to see */];</summary>
```js
// next time
```
</details>
```js
// sorry
```
<details>
<summary>Console:</summary>
```
โค๏ธ
```
</details>
</details>
[Try it yourself (no yet) โบโบโบ](https://codepen.io/yurigor)
### mapDeep
โบ get array of values processed by iteratee. [๐ see docs](https://deepdash.io/#mapdeep)
<details>
<summary>expand example</summary>
```js
let res = _.mapDeep(
{ hello: { from: { the: 'deep world', and: 'deepdash' } } },
(v) => v.toUpperCase(),
{ leavesOnly: true }
);
// res -> ['DEEP WORLD','DEEPDASH']
```
</details>
[Try it yourself (no yet) โบโบโบ](https://codepen.io/yurigor)
### mapValuesDeep
โบ get the object with same structure, but transformed values. [๐ see docs](https://deepdash.io/#mapvaluesdeep)
<details>
<summary>expand example</summary>
```js
let res = _.mapValuesDeep(
{ hello: { from: { the: 'deep world' } } },
(v) => v.toUpperCase(),
{ leavesOnly: true }
);
// res -> { hello: { from: { the: 'DEEP WORLD' } } }
```
</details>
[Try it yourself โบโบโบ](https://codepen.io/yurigor/pen/yWBzGV?editors=0010)
### mapKeysDeep
โบ get the object with same values, but transformed keys. [๐ see docs](https://deepdash.io/#mapkeysdeep)
<details>
<summary>expand example</summary>
```js
let res = _.mapKeysDeep(
{ hello: { from: { the: 'deep world' } } },
(v, k) => k.toUpperCase()
);
// res -> { HELLO: { FROM: { THE: 'deep world' } } }
```
</details>
[Try it yourself (no yet) โบโบโบ](https://codepen.io/yurigor/)
### reduceDeep
โบ like reduce, but deep [๐ see docs](https://deepdash.io/#reducedeep)
<details>
<summary>expand example</summary>
```js
let max = _.reduceDeep({ a: 2, b: 3, c: { d: 6, e: [1, 5, 8] } },
(acc, value, key, parent, ctx) => {
if (typeof value == 'number' && (typeof acc != 'number' || value > acc))
return value;
return undefined;
}
);
// max == 8
```
</details>
[Try it yourself โบโบโบ](https://codepen.io/yurigor/pen/ZNzmmR?editors=0010)
### someDeep
โบ returns true if some matching deep value found [๐ see docs](https://deepdash.io/#somedeep)
<details>
<summary>example a bit later</summary>
<details>
<summary> let children = [/* expand to see */];</summary>
```js
// next time
```
</details>
```js
// sorry
```
<details>
<summary>Console:</summary>
```
โค๏ธ
```
</details>
</details>
[Try it yourself (no yet) โบโบโบ](https://codepen.io/yurigor)
### pickDeep
โบ pick values by paths specified by endings or regexes [๐ see docs](https://deepdash.io/#pickdeep)
<details>
<summary>expand example</summary>
<details>
<summary> let children = [/* expand to see */];</summary>
```js
let children = [
{
description: 'description for node 1',
comment: 'comment for node 1',
note: 'note for node 1',
name: 'node 1',
bad: false,
children: [
{
description: 'description for node 1.1',
comment: 'comment for node 1.1',
note: 'note for node 1.1',
name: 'node 1.1',
bad: false,
},
{
description: 'description for node 1.2',
comment: 'comment for node 1.2',
note: 'note for node 1.2',
name: 'node 1.2',
good: true,
},
{
description: 'description for node 1.3',
comment: 'comment for node 1.3',
note: 'note for node 1.3',
name: 'node 1.3',
bad: true,
good: false,
},
],
},
{
description: 'description for node 2',
comment: 'comment for node 2',
note: 'note for node 2',
name: 'node 2',
good: true,
children: [
{
description: 'description for node 2.1',
comment: 'comment for node 2.1',
note: 'note for node 2.1',
name: 'node 2.1',
bad: false,
},
{
description: 'description for node 2.2',
comment: 'comment for node 2.2',
note: 'note for node 2.2',
name: 'node 2.2',
good: true,
},
{
description: 'description for node 2.3',
comment: 'comment for node 2.3',
note: 'note for node 2.3',
name: 'node 2.3',
bad: true,
good: false,
},
],
},
{
description: 'description for node 3',
comment: 'comment for node 3',
note: 'note for node 3',
name: 'node 3',
bad: true,
good: false,
children: [
{
description: 'description for node 3.1',
comment: 'comment for node 3.1',
note: 'note for node 3.1',
name: 'node 3.1',
bad: false,
},
{
description: 'description for node 3.2',
comment: 'comment for node 3.2',
note: 'note for node 3.2',
name: 'node 3.2',
good: true,
},
{
description: 'description for node 3.3',
comment: 'comment for node 3.3',
note: 'note for node 3.3',
name: 'node 3.3',
bad: true,
good: false,
},
],
},
];
```
</details>
```js
console.log('\n = Pick name and description only = \n');
console.log(
_.pickDeep(children, ['name', 'description'])
);
```
<details>
<summary>Console:</summary>
```
= Pick name and description only =
[
{
"description": "description for node 1",
"name": "node 1",
"children": [
{
"description": "description for node 1.1",
"name": "node 1.1"
},
{
"description": "description for node 1.2",
"name": "node 1.2"
},
{
"description": "description for node 1.3",
"name": "node 1.3"
}
]
},
{
"description": "description for node 2",
"name": "node 2",
"children": [
{
"description": "description for node 2.1",
"name": "node 2.1"
},
{
"description": "description for node 2.2",
"name": "node 2.2"
},
{
"description": "description for node 2.3",
"name": "node 2.3"
}
]
},
{
"description": "description for node 3",
"name": "node 3",
"children": [
{
"description": "description for node 3.1",
"name": "node 3.1"
},
{
"description": "description for node 3.2",
"name": "node 3.2"
},
{
"description": "description for node 3.3",
"name": "node 3.3"
}
]
}
]
```
</details>
</details>
[Try it yourself โบโบโบ](https://codepen.io/yurigor/pen/zQOVBR?editors=0010)
### omitDeep
โบ get object without paths specified by endings or regexes [๐ see docs](https://deepdash.io/#omitdeep)
<details>
<summary>expand example</summary>
<details>
<summary> let children = [/* expand to see */];</summary>
```js
let children = [
{
description: 'description for node 1',
comment: 'comment for node 1',
note: 'note for node 1',
name: 'node 1',
bad: false,
children: [
{
description: 'description for node 1.1',
comment: 'comment for node 1.1',
note: 'note for node 1.1',
name: 'node 1.1',
bad: false,
},
{
description: 'description for node 1.2',
comment: 'comment for node 1.2',
note: 'note for node 1.2',
name: 'node 1.2',
good: true,
},
{
description: 'description for node 1.3',
comment: 'comment for node 1.3',
note: 'note for node 1.3',
name: 'node 1.3',
bad: true,
good: false,
},
],
},
{
description: 'description for node 2',
comment: 'comment for node 2',
note: 'note for node 2',
name: 'node 2',
good: true,
children: [
{
description: 'description for node 2.1',
comment: 'comment for node 2.1',
note: 'note for node 2.1',
name: 'node 2.1',
bad: false,
},
{
description: 'description for node 2.2',
comment: 'comment for node 2.2',
note: 'note for node 2.2',
name: 'node 2.2',
good: true,
},
{
description: 'description for node 2.3',
comment: 'comment for node 2.3',
note: 'note for node 2.3',
name: 'node 2.3',
bad: true,
good: false,
},
],
},
{
description: 'description for node 3',
comment: 'comment for node 3',
note: 'note for node 3',
name: 'node 3',
bad: true,
good: false,
children: [
{
description: 'description for node 3.1',
comment: 'comment for node 3.1',
note: 'note for node 3.1',
name: 'node 3.1',
bad: false,
},
{
description: 'description for node 3.2',
comment: 'comment for node 3.2',
note: 'note for node 3.2',
name: 'node 3.2',
good: true,
},
{
description: 'description for node 3.3',
comment: 'comment for node 3.3',
note: 'note for node 3.3',
name: 'node 3.3',
bad: true,
good: false,
},
],
},
];
```
</details>
```js
console.log('\n = Omit paths not ending with "e" = \n');
console.log(
_.omitDeep(children, /[^e]$/i, { onMatch: { skipChildren: false } }),
);
```
<details>
<summary>Console:</summary>
```
= Omit paths not ending with "e" =
[
{
"note": "note for node 1",
"name": "node 1",
"children": [
{
"note": "note for node 1.1",
"name": "node 1.1"
},
{
"note": "note for node 1.2",
"name": "node 1.2"
},
{
"note": "note for node 1.3",
"name": "node 1.3"
}
]
},
{
"note": "note for node 2",
"name": "node 2",
"children": [
{
"note": "note for node 2.1",
"name": "node 2.1"
},
{
"note": "note for node 2.2",
"name": "node 2.2"
},
{
"note": "note for node 2.3",
"name": "node 2.3"
}
]
},
{
"note": "note for node 3",
"name": "node 3",
"children": [
{
"note": "note for node 3.1",
"name": "node 3.1"
},
{
"note": "note for node 3.2",
"name": "node 3.2"
},
{
"note": "note for node 3.3",
"name": "node 3.3"
}
]
}
]
```
</details>
</details>
[Try it yourself โบโบโบ](https://codepen.io/yurigor/pen/YbKoNM?editors=0010)
### index
โบ get an object with all the paths as keys and corresponding values [๐ see docs](https://deepdash.io/#index)
<details>
<summary>expand example</summary>
```js
let index = _.index(
{
a: {
b: {
c: [1, 2, 3],
'hello world': {},
},
},
},
{ leavesOnly: true }
);
console.log(index);
```
Console:
```
{ 'a.b.c[0]': 1,
'a.b.c[1]': 2,
'a.b.c[2]': 3,
'a.b["hello world"]': {} }
```
</details>
[Try it yourself โบโบโบ](https://codepen.io/yurigor/pen/rgBzdB?editors=0010)
### paths (keysDeep)
โบ get an array of paths [๐ see docs](https://deepdash.io/#paths-keysdeep)
<details>
<summary>expand example</summary>
```js
let paths = _.paths(
{
a: {
b: {
c: [1, 2, 3],
'hello world': {},
},
},
},
{ leavesOnly: false }
);
console.log(paths);
```
Console:
```
[ 'a',
'a.b',
'a.b.c',
'a.b.c[0]',
'a.b.c[1]',
'a.b.c[2]',
'a.b["hello world"]' ]
```
</details>
[Try it yourself โบโบโบ](https://codepen.io/yurigor/pen/mYbByL?editors=0010)
### condense
โบ condense sparse array [๐ see docs](https://deepdash.io/#condense)
<details>
<summary>expand example</summary>
```js
let arr = ['a', 'b', 'c', 'd', 'e'];
delete arr[1];
console.log(arr);
delete arr[3];
console.log(arr);
_.condense(arr);
console.log(arr);
```
Console:
```
[ 'a', <1 empty item>, 'c', 'd', 'e' ]
[ 'a', <1 empty item>, 'c', <1 empty item>, 'e' ]
[ 'a', 'c', 'e' ]
```
</details>
[Try it yourself โบโบโบ](https://codepen.io/yurigor/pen/oOKGXE?editors=0010)
### condenseDeep
โบ condense all the nested arrays [๐ see docs](https://deepdash.io/#condensedeep)
<details>
<summary>expand example</summary>
```js
let obj = { arr: ['a', 'b', { c: [1, , 2, , 3] }, 'd', 'e'] };
delete obj.arr[1];
delete obj.arr[3];
_.condenseDeep(obj);
console.log(obj);
```
Console:
```
{ arr: [ 'a', { c: [ 1, 2, 3 ] }, 'e' ] }
```
</details>
[Try it yourself โบโบโบ](https://codepen.io/yurigor/pen/mgNBOa?editors=0010)
### exists
โบ like a `_.has` but returns `false` for empty array slots [๐ see docs](https://deepdash.io/#exists)
<details>
<summary>expand example</summary>
```js
var obj = [, { a: [, 'b'] }];
console.log(_.exists(obj, 0)); // false
console.log(_.exists(obj, 1)); // true
console.log(_.exists(obj, '[1].a[0]')); // false
console.log(_.exists(obj, '[1].a[1]')); // true
```
</details>
[Try it yourself โบโบโบ](https://codepen.io/yurigor/pen/MRNOQB?editors=0010)
### pathToString
โบ convert an array to string path (opposite to _.toPath) [๐ see docs](https://deepdash.io/#pathtostring)
<details>
<summary>expand example</summary>
```js
console.log(_.pathToString(['a', 'b', 'c', 'defg', 0, '1', 2.3]
,'prefix1', 'prefix2', '[3]'));
// prefix1.prefix2[3].a.b.c.defg[0][1]["2.3"]
console.log(_.pathToString(['"', '"', '"']));
// ["\\""]["\\""]["\\""]
console.log(_.pathToString('it.s.a.string'));
// it.s.a.string
```
</details>
[Try it yourself โบโบโบ](https://codepen.io/yurigor/pen/joNXGv?editors=0010)
### See [full docs](https://deepdash.io) for details.
## Contributors โจ
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
<tr>
<td align="center"><a href="https://github.com/raz-sinay"><img src="https://avatars3.githubusercontent.com/u/15093043?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Raz Sinay</b></sub></a><br /><a href="https://github.com/YuriGor/Deepdash/commits?author=raz-sinay" title="Code">๐ป</a> <a href="#userTesting-raz-sinay" title="User Testing">๐</a> <a href="#ideas-raz-sinay" title="Ideas, Planning, & Feedback">๐ค</a></td>
<td align="center"><a href="http://www.florent-grandval.fr"><img src="https://avatars3.githubusercontent.com/u/5641890?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Florent</b></sub></a><br /><a href="https://github.com/YuriGor/Deepdash/issues?q=author%3Afgrandval" title="Bug reports">๐</a> <a href="#userTesting-fgrandval" title="User Testing">๐</a></td>
<td align="center"><a href="https://github.com/JoeSchr"><img src="https://avatars3.githubusercontent.com/u/8218910?v=4?s=100" width="100px;" alt=""/><br /><sub><b>JoeSchr</b></sub></a><br /><a href="#ideas-JoeSchr" title="Ideas, Planning, & Feedback">๐ค</a> <a href="#userTesting-JoeSchr" title="User Testing">๐</a></td>
<td align="center"><a href="https://github.com/mattblackdev"><img src="https://avatars3.githubusercontent.com/u/5210361?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Matt Black</b></sub></a><br /><a href="#ideas-mattblackdev" title="Ideas, Planning, & Feedback">๐ค</a></td>
<td align="center"><a href="https://github.com/simlu"><img src="https://avatars1.githubusercontent.com/u/1539747?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Lukas Siemon</b></sub></a><br /><a href="#ideas-simlu" title="Ideas, Planning, & Feedback">๐ค</a> <a href="#userTesting-simlu" title="User Testing">๐</a> <a href="https://github.com/YuriGor/Deepdash/commits?author=simlu" title="Code">๐ป</a> <a href="#talk-simlu" title="Talks">๐ข</a> <a href="https://github.com/YuriGor/Deepdash/commits?author=simlu" title="Tests">โ ๏ธ</a></td>
<td align="center"><a href="https://github.com/crapthings"><img src="https://avatars2.githubusercontent.com/u/1147704?v=4?s=100" width="100px;" alt=""/><br /><sub><b>crapthings</b></sub></a><br /><a href="#ideas-crapthings" title="Ideas, Planning, & Feedback">๐ค</a></td>
<td align="center"><a href="http://masciugo.github.io/"><img src="https://avatars2.githubusercontent.com/u/454321?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Corrado Masciullo</b></sub></a><br /><a href="https://github.com/YuriGor/Deepdash/issues?q=author%3Amasciugo" title="Bug reports">๐</a> <a href="#ideas-masciugo" title="Ideas, Planning, & Feedback">๐ค</a></td>
</tr>
<tr>
<td align="center"><a href="https://github.com/jedrichards"><img src="https://avatars0.githubusercontent.com/u/1078571?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jed Richards</b></sub></a><br /><a href="#infra-jedrichards" title="Infrastructure (Hosting, Build-Tools, etc)">๐</a></td>
<td align="center"><a href="https://github.com/ArSn"><img src="https://avatars3.githubusercontent.com/u/2803693?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Kolja Zuelsdorf</b></sub></a><br /><a href="https://github.com/YuriGor/Deepdash/issues?q=author%3AArSn" title="Bug reports">๐</a> <a href="#userTesting-ArSn" title="User Testing">๐</a> <a href="#example-ArSn" title="Examples">๐ก</a></td>
<td align="center"><a href="https://stackoverflow.com/users/1467988"><img src="https://avatars3.githubusercontent.com/u/982868?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Noval Agung Prayogo</b></sub></a><br /><a href="#question-novalagung" title="Answering Questions">๐ฌ</a></td>
<td align="center"><a href="https://github.com/MrKumaPants"><img src="https://avatars3.githubusercontent.com/u/39394314?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Nathan Tomsic</b></sub></a><br /><a href="#ideas-MrKumaPants" title="Ideas, Planning, & Feedback">๐ค</a></td>
<td align="center"><a href="https://github.com/madflow"><img src="https://avatars0.githubusercontent.com/u/183248?v=4?s=100" width="100px;" alt=""/><br /><sub><b>madflow</b></sub></a><br /><a href="#question-madflow" title="Answering Questions">๐ฌ</a></td>
<td align="center"><a href="https://github.com/ventralnet"><img src="https://avatars3.githubusercontent.com/u/686309?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Matthew Kirkley</b></sub></a><br /><a href="https://github.com/YuriGor/Deepdash/issues?q=author%3Aventralnet" title="Bug reports">๐</a> <a href="#ideas-ventralnet" title="Ideas, Planning, & Feedback">๐ค</a></td>
<td align="center"><a href="https://github.com/GaborTorma"><img src="https://avatars0.githubusercontent.com/u/11255009?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Torma Gรกbor</b></sub></a><br /><a href="https://github.com/YuriGor/Deepdash/issues?q=author%3AGaborTorma" title="Bug reports">๐</a> <a href="#ideas-GaborTorma" title="Ideas, Planning, & Feedback">๐ค</a> <a href="#userTesting-GaborTorma" title="User Testing">๐</a></td>
</tr>
<tr>
<td align="center"><a href="http://richtera.org"><img src="https://avatars2.githubusercontent.com/u/708186?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Andreas Richter</b></sub></a><br /><a href="https://github.com/YuriGor/Deepdash/issues?q=author%3Arichtera" title="Bug reports">๐</a> <a href="#userTesting-richtera" title="User Testing">๐</a></td>
<td align="center"><a href="https://github.com/jwhitmarsh"><img src="https://avatars2.githubusercontent.com/u/8026009?v=4?s=100" width="100px;" alt=""/><br /><sub><b>James</b></sub></a><br /><a href="https://github.com/YuriGor/Deepdash/issues?q=author%3Ajwhitmarsh" title="Bug reports">๐</a> <a href="https://github.com/YuriGor/Deepdash/commits?author=jwhitmarsh" title="Code">๐ป</a> <a href="https://github.com/YuriGor/Deepdash/commits?author=jwhitmarsh" title="Documentation">๐</a> <a href="#userTesting-jwhitmarsh" title="User Testing">๐</a></td>
<td align="center"><a href="http://blog.rxliuli.com"><img src="https://avatars2.githubusercontent.com/u/24560368?v=4?s=100" width="100px;" alt=""/><br /><sub><b>rxliuli</b></sub></a><br /><a href="https://github.com/YuriGor/Deepdash/issues?q=author%3Arxliuli" title="Bug reports">๐</a> <a href="https://github.com/YuriGor/Deepdash/commits?author=rxliuli" title="Code">๐ป</a> <a href="https://github.com/YuriGor/Deepdash/commits?author=rxliuli" title="Documentation">๐</a></td>
<td align="center"><a href="https://github.com/TeleMediaCC"><img src="https://avatars3.githubusercontent.com/u/66513308?v=4?s=100" width="100px;" alt=""/><br /><sub><b>TeleMediaCC</b></sub></a><br /><a href="https://github.com/YuriGor/Deepdash/issues?q=author%3ATeleMediaCC" title="Bug reports">๐</a></td>
<td align="center"><a href="https://nicolas-coutin.com"><img src="https://avatars1.githubusercontent.com/u/6564012?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Nicolas Coutin</b></sub></a><br /><a href="#financial-Ilshidur" title="Financial">๐ต</a> <a href="#userTesting-Ilshidur" title="User Testing">๐</a></td>
<td align="center"><a href="https://github.com/barrct"><img src="https://avatars1.githubusercontent.com/u/13442267?v=4?s=100" width="100px;" alt=""/><br /><sub><b>barrct</b></sub></a><br /><a href="https://github.com/YuriGor/Deepdash/issues?q=author%3Abarrct" title="Bug reports">๐</a> <a href="https://github.com/YuriGor/Deepdash/commits?author=barrct" title="Documentation">๐</a></td>
<td align="center"><a href="https://github.com/casamia918"><img src="https://avatars0.githubusercontent.com/u/8295005?v=4?s=100" width="100px;" alt=""/><br /><sub><b>casamia918</b></sub></a><br /><a href="https://github.com/YuriGor/Deepdash/issues?q=author%3Acasamia918" title="Bug reports">๐</a> <a href="https://github.com/YuriGor/Deepdash/commits?author=casamia918" title="Code">๐ป</a> <a href="https://github.com/YuriGor/Deepdash/commits?author=casamia918" title="Documentation">๐</a></td>
</tr>
<tr>
<td align="center"><a href="https://github.com/ferreirix"><img src="https://avatars3.githubusercontent.com/u/10561360?v=4?s=100" width="100px;" alt=""/><br /><sub><b>ferreirix</b></sub></a><br /><a href="#ideas-ferreirix" title="Ideas, Planning, & Feedback">๐ค</a></td>
<td align="center"><a href="https://cloverxuesongzhou.com/"><img src="https://avatars1.githubusercontent.com/u/5461045?v=4?s=100" width="100px;" alt=""/><br /><sub><b>John Camden</b></sub></a><br /><a href="https://github.com/YuriGor/Deepdash/issues?q=author%3Ajcamden" title="Bug reports">๐</a></td>
<td align="center"><a href="https://github.com/JoshuaM1995"><img src="https://avatars2.githubusercontent.com/u/26679919?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Joshua</b></sub></a><br /><a href="https://github.com/YuriGor/Deepdash/commits?author=JoshuaM1995" title="Code">๐ป</a> <a href="https://github.com/YuriGor/Deepdash/commits?author=JoshuaM1995" title="Documentation">๐</a></td>
</tr>
</table>
<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!