Project: syntax-tree/unist-util-assert

Package: unist-util-assert@2.0.1

  1. Dependencies: 2·Dependents: 4
  2. unist utility to assert nodes
  1. util 130
  2. utility 126
  3. unist 120
  4. unist-util 27
  5. check 11
  6. test 6
  7. assert 4


Build Coverage Downloads Size Sponsors Backers Chat

unist utility to assert trees.



npm install unist-util-assert


var assert = require('unist-util-assert')

assert({type: 'root', children: []})
assert({type: 'break'})
assert({type: 'element', properties: {}, children: []})
// All OK.

assert({children: []})
// AssertionError: node should have a type: `{ children: [] }`

assert.parent({type: 'break'})
// AssertionError: parent should have `children`: `{ type: 'break' }`

assert({type: 'element', properties: function() {}})
// AssertionError: non-specced property `properties` should be JSON: `{ type: 'element', properties: [Function] }`

assert.void({type: 'text', value: 'Alpha'})
// AssertionError: void should not have `value`: `{ type: 'text', value: 'Alpha' }`

assert({type: 'paragraph', children: ['foo']})
// AssertionError: node should be an object: `'foo'` in `{ type: 'paragraph', children: [ 'foo' ] }`



Assert that tree is a valid unist node. If tree is a parent, all children will be asserted as well.


Assert that tree is a valid unist parent. All children will be asserted as well.


Assert that node is a valid unist literal.


Assert that node is a valid unist node, but neither parent nor literal.


This module can be used as a base to test subsets of unist (for an example, see mdast-util-assert). All functions that are exposed from such a module, and functions used internally to test children, should be wrapped in assert.wrap, which adds an inspectable string of the respective node, and its parent when available, to the exposed error message.


Wraps fn (which is passed a node, and an optional parent node), so that any errors thrown inside it will contain information regarding the node (and the parent, when given).


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, organization, or community you agree to abide by its terms.


MIT © Titus Wormer