Giter Club home page Giter Club logo

hast-util-to-parse5's Introduction

hast-util-to-parse5

Build Coverage Downloads Size Sponsors Backers Chat

hast utility to transform to a parse5 AST.

Contents

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

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

hast-util-to-parse5's People

Contributors

christianmurphy avatar greenkeeperio-bot avatar wooorm avatar

Stargazers

 avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

hast-util-to-parse5's Issues

Invalid attribute values passed to `parse5`

var hastUtilToParse5 = require("hast-util-to-parse5")
var h = require("hastscript");

const el = h('input', {'minLength': 5});
const ast = hastUtilToParse5(el);

HAST permits the minLength attribute to be a number, but parse5's AST requires that values be strings. Attempting to serialize the AST obtained from this snippet results in an exception.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.