Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

unist-util-remove

Package Overview
Dependencies
Maintainers
2
Versions
14
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

unist-util-remove - npm Package Compare versions

Comparing version 1.0.1 to 1.0.2

license

25

package.json
{
"name": "unist-util-remove",
"version": "1.0.1",
"version": "1.0.2",
"description": "Remove nodes from Unist tree",

@@ -24,3 +24,3 @@ "license": "MIT",

"Eugene Sharygin <eush77@gmail.com>",
"Titus Wormer <tituswormer@gmail.com> (http://wooorm.com)"
"Titus Wormer <tituswormer@gmail.com> (https://wooorm.com)"
],

@@ -34,12 +34,12 @@ "files": [

"devDependencies": {
"nyc": "^12.0.1",
"prettier": "^1.13.3",
"remark-cli": "^5.0.0",
"remark-preset-wooorm": "^4.0.0",
"tape": "^4.4.0",
"nyc": "^14.0.0",
"prettier": "^1.0.0",
"remark-cli": "^6.0.0",
"remark-preset-wooorm": "^5.0.0",
"tape": "^4.0.0",
"unist-builder": "^1.0.0",
"xo": "^0.21.1"
"xo": "^0.24.0"
},
"scripts": {
"format": "remark . -qfo && prettier --write '**/*.js' && xo --fix",
"format": "remark . -qfo && prettier --write \"**/*.js\" && xo --fix",
"test-api": "node test",

@@ -65,8 +65,3 @@ "test-coverage": "nyc --reporter lcov tape test.js",

"prettier": true,
"esnext": false,
"rules": {
"guard-for-in": "off",
"no-var": "off",
"prefer-arrow-callback": "off"
}
"esnext": false
},

@@ -73,0 +68,0 @@ "remarkConfig": {

121

readme.md

@@ -1,7 +0,15 @@

# unist-util-remove [![Build Status][build-badge]][build-page] [![Coverage Status][coverage-badge]][coverage-page]
# unist-util-remove
Modify the given [unist][] tree to remove all nodes that pass the given test.
[![Build][build-badge]][build]
[![Coverage][coverage-badge]][coverage]
[![Downloads][downloads-badge]][downloads]
[![Size][size-badge]][size]
[**unist**][unist] utility to modify the given tree by removing all nodes that
pass the given test.
## Install
[npm][]:
```sh

@@ -15,3 +23,3 @@ npm install unist-util-remove

var u = require('unist-builder')
var remove = require('.')
var remove = require('unist-util-remove')

@@ -31,6 +39,6 @@ var tree = u('root', [

console.log(tree)
console.dir(tree, {depth: null})
```
Yields: (note the parent of `5` is also removed, due to `opts.cascade`)
Yields: (note the parent of `5` is also removed, due to `options.cascade`)

@@ -40,12 +48,10 @@ ```js

type: 'root',
children: [{
type: 'node',
children: [{
children: [
{
type: 'node',
children: [{
type: 'other',
value: '4'
}]
}]
}]
children: [
{ type: 'node', children: [ { type: 'other', value: '4' } ] }
]
}
]
}

@@ -56,6 +62,7 @@ ```

### `remove(tree, [opts], test)`
### `remove(tree[, options][, test])`
Mutate `tree` by removing all nodes that pass `test`.
The tree is filtered in [preorder][].
Mutate the given [tree][] by removing all nodes that pass `test`.
The tree is walked in [preorder][] (NLR), visiting the node itself, then its
[head][], etc.

@@ -65,29 +72,65 @@ ###### Parameters

* `tree` ([`Node?`][node])
— Tree to filter
* `opts.cascade` (`boolean`, default: `true`)
— Whether to drop parent nodes if they had children, but all their
children were filtered out
* `test`
— See [`unist-util-is`][is] for details
— [Tree][] to filter
* `options.cascade` (`boolean`, default: `true`)
— Whether to drop parent nodes if they had children, but all their children
were filtered out
* `test` ([`Test`][is], optional) — [`is`][is]-compatible test (such as a
[type][])
###### Returns
The given `tree` ([`Node?`][node]) with nodes for which `test` returned `true`
removed. `null` is returned if `tree` itself didn’t pass the test, or is
cascaded away.
[`Node?`][node] — The given `tree` with nodes for which `test` passed removed.
`null` is returned if `tree` itself didn’t pass the test, or is cascaded away.
## Related
* [`unist-util-filter`](https://github.com/syntax-tree/unist-util-filter)
— Create a new tree with all nodes that pass the given function
* [`unist-util-flatmap`](https://gitlab.com/staltz/unist-util-flatmap)
— Create a new tree by expanding a node into many
* [`unist-util-map`](https://github.com/syntax-tree/unist-util-map)
— Create a new tree by mapping nodes
* [`unist-util-select`](https://github.com/syntax-tree/unist-util-select)
— Select nodes with CSS-like selectors
* [`unist-util-visit`](https://github.com/syntax-tree/unist-util-visit)
— Recursively walk over nodes
* [`unist-builder`](https://github.com/syntax-tree/unist-builder)
— Creating trees
## Contribute
See [`contributing.md` in `syntax-tree/unist`][contributing] for ways to get
See [`contributing.md` in `syntax-tree/.github`][contributing] for ways to get
started.
See [`support.md`][support] for ways to get help.
This organisation has a [Code of Conduct][coc]. By interacting with this
repository, organisation, or community you agree to abide by its terms.
This project has a [Code of Conduct][coc].
By interacting with this repository, organisation, or community you agree to
abide by its terms.
## License
[MIT][] © Eugene Sharygin
[MIT][license] © Eugene Sharygin
[mit]: LICENSE
<!-- Definitions -->
[build-badge]: https://img.shields.io/travis/syntax-tree/unist-util-filter.svg
[build]: https://travis-ci.org/syntax-tree/unist-util-filter
[coverage-badge]: https://img.shields.io/codecov/c/github/syntax-tree/unist-util-filter.svg
[coverage]: https://codecov.io/github/syntax-tree/unist-util-filter
[downloads-badge]: https://img.shields.io/npm/dm/unist-util-filter.svg
[downloads]: https://www.npmjs.com/package/unist-util-filter
[size-badge]: https://img.shields.io/bundlephobia/minzip/unist-util-filter.svg
[size]: https://bundlephobia.com/result?p=unist-util-filter
[npm]: https://docs.npmjs.com/cli/install
[license]: license
[unist]: https://github.com/syntax-tree/unist

@@ -97,16 +140,16 @@

[is]: https://github.com/syntax-tree/unist-util-is
[tree]: https://github.com/syntax-tree/unist#tree
[preorder]: https://en.wikipedia.org/wiki/Tree_traversal
[preorder]: https://www.geeksforgeeks.org/tree-traversals-inorder-preorder-and-postorder/
[build-page]: https://travis-ci.org/syntax-tree/unist-util-remove
[head]: https://github.com/syntax-tree/unist#head
[build-badge]: https://travis-ci.org/syntax-tree/unist-util-remove.svg?branch=master
[type]: https://github.com/syntax-tree/unist#type
[coverage-page]: https://codecov.io/github/syntax-tree/unist-util-remove?branch=master
[is]: https://github.com/syntax-tree/unist-util-is
[coverage-badge]: https://img.shields.io/codecov/c/github/syntax-tree/unist-util-remove.svg?branch=master
[contributing]: https://github.com/syntax-tree/.github/blob/master/contributing.md
[contributing]: https://github.com/syntax-tree/unist/blob/master/contributing.md
[support]: https://github.com/syntax-tree/.github/blob/master/support.md
[coc]: https://github.com/syntax-tree/unist/blob/master/code-of-conduct.md
[coc]: https://github.com/syntax-tree/.github/blob/master/code-of-conduct.md
SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc