Project: syntax-tree/unist-util-remove

Package: unist-util-remove@3.1.0

  1. Dependents: 81
  2. unist utility to remove nodes from a tree
  1. util 144
  2. utility 140
  3. unist 129
  4. tree 41
  5. ast 34
  6. unist-util 25
  7. node 25
  8. remove 10
  9. delete 3
  10. squeeze 3
  11. strip 2


Build Coverage Downloads Size Sponsors Backers Chat

unist utility to modify the given tree by removing all nodes that pass the given test.


This package is ESM only: Node 12+ is needed to use it and it must be imported instead of required.


npm install unist-util-remove


import {u} from 'unist-builder'
import {remove} from 'unist-util-remove'

const tree = u('root', [
  u('leaf', '1'),
  u('node', [
    u('leaf', '2'),
    u('node', [u('leaf', '3'), u('other', '4')]),
    u('node', [u('leaf', '5')])
  u('leaf', '6')

// Remove all nodes of type `leaf`.
remove(tree, 'leaf')

console.dir(tree, {depth: null})

Yields: (note the parent of 5 is also removed, due to options.cascade)

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


This package exports the following identifiers: remove. There is no default export.

remove(tree[, options], test)

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.


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.


See contributing.md in syntax-tree/.github for ways to get started. See support.md for ways to get help.

This project has a Code of Conduct. By interacting with this repository, organisation, or community you agree to abide by its terms.


MIT © Eugene Sharygin