hast-util-to-parse5

What is hast-util-to-parse5?

The `hast-util-to-parse5` package is a utility that converts HAST (Hypertext Abstract Syntax Tree) to Parse5's AST (Abstract Syntax Tree). This is useful for working with HTML in a structured way, allowing for transformations, analysis, and other manipulations.

What are hast-util-to-parse5's main functionalities?

Convert HAST to Parse5 AST

This feature allows you to convert a HAST node to a Parse5 AST node. The code sample demonstrates converting a simple HAST node representing a <div> element into its Parse5 AST equivalent.

const toParse5 = require('hast-util-to-parse5');
const hast = { type: 'element', tagName: 'div', properties: {}, children: [] };
const parse5Ast = toParse5(hast);
console.log(parse5Ast);

Other packages similar to hast-util-to-parse5

rehype-parse

The `rehype-parse` package is used to parse HTML into HAST. While `hast-util-to-parse5` converts HAST to Parse5 AST, `rehype-parse` works in the opposite direction by converting HTML to HAST. This makes it useful for initial parsing of HTML content before any transformations.

rehype-stringify

The `rehype-stringify` package is used to serialize HAST back into HTML. It complements `hast-util-to-parse5` by providing the reverse functionality: while `hast-util-to-parse5` converts HAST to Parse5 AST, `rehype-stringify` converts HAST to HTML strings.

parse5

The `parse5` package is a comprehensive library for parsing and serializing HTML. It provides a full suite of tools for working with HTML, including parsing HTML into its own AST format and serializing it back. `hast-util-to-parse5` specifically bridges the gap between HAST and Parse5 AST, making it a more specialized tool compared to the broader functionality of `parse5`.

README

hast-util-to-parse5

hast utility to transform to a parse5 AST.

Contents

• What is this?
• When should I use this?
• Install
• Use
• API
  • toParse5(tree[, options])
  • Options
  • Space
• Types
• Compatibility
• Security
• Related
• Contribute
• License

What is this?

This package is a utility that can turn a hast syntax tree into a parse5 AST. Why not use a Parse5 adapter, you might ask? Well, because it’s more code weight to use adapters, and more fragile.

When should I use this?

This package is useful when working with parse5, and for some reason want to generate its AST again. The inverse utility, hast-util-from-parse5, is more likely what you want.

Install

This package is ESM only. In Node.js (version 16+), install with npm:

npm install hast-util-to-parse5

In Deno with esm.sh:

import {toParse5} from 'https://esm.sh/hast-util-to-parse5@8'

In browsers with esm.sh:

<script type="module">
  import {toParse5} from 'https://esm.sh/hast-util-to-parse5@8?bundle'
</script>

Use

import {toParse5} from 'hast-util-to-parse5'

const tree = toParse5({
  type: 'element',
  tagName: 'h1',
  properties: {},
  children: [{type: 'text', value: 'World!'}]
})

console.log(tree)

Yields:

{ nodeName: 'h1',
  tagName: 'h1',
  attrs: [],
  namespaceURI: 'http://www.w3.org/1999/xhtml',
  childNodes: [ { nodeName: '#text', value: 'World!', parentNode: [Circular] } ] }

API

This package exports the identifier toParse5. There is no default export.

toParse5(tree[, options])

Transform a hast tree to a parse5 AST.

Parameters

• tree (HastNode) — tree to transform
• options (Options, optional) — configuration

Returns

parse5 node (Parse5Node).

Options

Configuration (TypeScript type).

Fields

• space (Space, optional) — which space the document is in

Space

Namespace (TypeScript type).

Type

type Space = 'html' | 'svg'

Types

This package is fully typed with TypeScript. It exports the additional types Options and Space.

Compatibility

Projects maintained by the unified collective are compatible with maintained versions of Node.js.

When we cut a new major release, we drop support for unmaintained versions of Node. This means we try to keep the current release line, hast-util-to-parse5@^8, compatible with Node.js 16.

Security

Use of hast-util-to-parse5 can open you up to a cross-site scripting (XSS) attack if the hast tree is unsafe.

Related

• hast-util-from-parse5 — transform from Parse5’s AST to hast
• hast-util-to-nlcst — transform hast to nlcst
• hast-util-to-mdast — transform hast to mdast
• hast-util-to-xast — transform hast to xast
• mdast-util-to-hast — transform mdast to hast
• mdast-util-to-nlcst — transform mdast to nlcst

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