unified

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 118
  2. utility 114
  3. unist 110
  4. unist-util 24
  5. check 11
  6. test 6
  7. assert 4

unist-util-assert

Build Coverage Downloads Size Sponsors Backers Chat

unist utility to assert trees.

Install

npm:

npm install unist-util-assert

Use

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' ] }`

API

assert(tree)

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

assert.parent(tree)

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

assert.text(node)

Assert that node is a valid unist literal.

assert.void(node)

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

Extensions

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.

assert.wrap(fn)

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).

Contribute

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.

License

MIT © Titus Wormer