unist-util-inspect

What is unist-util-inspect?

The `unist-util-inspect` package is a utility for inspecting and visualizing the structure of Unist syntax trees. It provides a way to convert these trees into a human-readable string format, which is useful for debugging and understanding the tree structure.

What are unist-util-inspect's main functionalities?

Inspecting a Unist Tree

This feature allows you to inspect a Unist tree by converting it into a human-readable string format. The code sample demonstrates how to use the `inspect` function to visualize a simple Unist tree.

const inspect = require('unist-util-inspect');
const tree = {
  type: 'root',
  children: [
    { type: 'paragraph', children: [{ type: 'text', value: 'Hello, world!' }] }
  ]
};
console.log(inspect(tree));

Other packages similar to unist-util-inspect

unist-util-visit

The `unist-util-visit` package is used for tree traversal in Unist syntax trees. It allows you to visit nodes in a tree and perform operations on them. Unlike `unist-util-inspect`, which focuses on visualizing the tree, `unist-util-visit` is more about manipulating and traversing the tree.

unist-builder

The `unist-builder` package provides a way to create Unist syntax trees programmatically. It is useful for constructing trees from scratch, whereas `unist-util-inspect` is used for visualizing existing trees.

unist-util-map

The `unist-util-map` package allows you to transform Unist trees by applying a function to each node. This is different from `unist-util-inspect`, which is used for visualizing the tree structure rather than transforming it.

README

unist-util-inspect

Unist node inspector.

Installation

npm:

npm install unist-util-inspect

Component.js:

component install wooorm/unist-util-inspect

Bower:

bower install unist-util-inspect

Duo:

var inspect = require('wooorm/unist-util-inspect');

unist-util-inspect is also available for bower, component, duo, and for AMD, CommonJS, and globals (uncompressed and compressed).

Usage

var retext = require('retext');
var inspect = require('unist-util-inspect');

retext().use(function (cst) {
    console.log(inspect(cst));
}).process('Some simple text.');

Yields:

RootNode[1]
└─ ParagraphNode[1]
   └─ SentenceNode[6]
      ├─ WordNode[1]
      │  └─ TextNode: 'Some'
      ├─ WhiteSpaceNode[1]
      │  └─ TextNode: ' '
      ├─ WordNode[1]
      │  └─ TextNode: 'simple'
      ├─ WhiteSpaceNode[1]
      │  └─ TextNode: ' '
      ├─ WordNode[1]
      │  └─ TextNode: 'text'
      └─ PunctuationNode[1]
         └─ TextNode: '.'

API

inspect(node)

By default, color support is enabled on node and disabled anywhere else. See below on how to change that.

Parameters

• node (Node).

Returns string — String representing node.

inspect.<style>[.<style>...](node)

Where style is either color or noColor.

To explicitly add or remove ANSI sequences, use either inspect.color(node) or inspect.noColor(node).

License

MIT © Titus Wormer