hast-util-to-parse5

!Buildbuild-badgebuild !Coveragecoverage-badgecoverage !Downloadsdownloads-badgedownloads !Sizesize-badgesize !Sponsorssponsors-badgecollective !Backersbackers-badgecollective !Chatchat-badgechat
hast utility to generate parse5parse5s ASTparse5-node.

Contents

• What is this?
• When should I use this?
• Install
• Use
• API

*   [`toParse5(tree[, space|options])`](#toparse5tree-spaceoptions)
*   [`Options`](#options)
*   [`Space`](#space)

• Types
• Compatibility
• Security
• Related
• Contribute
• License

What is this?

This package is a utility that can turn a hast syntax tree into parse5s 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-parse5hast-util-from-parse5, is more likely what you want.

Install

This package is ESM onlyesm. In Node.js (version 14.14+ and 16.0+), install with npm:

npm install hast-util-to-parse5

In Deno with esm.shesmsh:

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

In browsers with esm.shesmsh:

<script type="module">
  import {toParse5} from 'https://esm.sh/hast-util-to-parse5@7?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 toParse5toparse5. There is no default export.

toParse5(tree[, space|options])

Transform a hast tree to Parse5’s AST.

Parameters

• tree (HastNodehast-node)

— tree to transform

• space (Spacespace, optional)

— same as `{space: space}`

• options (Optionsoptions, optional)

— configuration

Returns

parse5 node (Parse5Nodeparse5-node).

Options

Configuration (TypeScript type).

Fields

• space (Spacespace, 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 Optionsoptions and Spacespace.

Compatibility

Projects maintained by the unified collective are compatible with all maintained versions of Node.js. As of now, that is Node.js 14.14+ and 16.0+. Our projects sometimes work with older versions, but this is not guaranteed.

Security

Use of hast-util-to-parse5 can open you up to a cross-site scripting (XSS)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.mdcontributing in syntax-tree/.githubhealth for ways to get started. See support.mdsupport for ways to get help.
This project has a code of conductcoc. By interacting with this repository, organization, or community you agree to abide by its terms.

License

MITlicense © Titus Wormerauthor