dom-serializer

render domhandler DOM nodes to a string

dom-serializer downloads dom-serializer version dom-serializer license

dom-serializerSimilar Packages:

Npm Package Weekly Downloads Trend

3 Years
🌟 Show real-time usage chart on dom-serializer's README.md, just copy the code below.
## Usage Trend
[![Usage Trend of dom-serializer](https://npm-compare.com/img/npm-trend/THREE_YEARS/dom-serializer.png)](https://npm-compare.com/dom-serializer#timeRange=THREE_YEARS)

Cumulative GitHub Star Trend

🌟 Show GitHub stars trend chart on dom-serializer's README.md, just copy the code below.
## GitHub Stars Trend
[![GitHub Stars Trend of dom-serializer](https://npm-compare.com/img/github-trend/dom-serializer.png)](https://npm-compare.com/dom-serializer)

Stat Detail

Package
Downloads
Stars
Size
Issues
Publish
License
dom-serializer014317.6 kB817 days agoMIT

README for dom-serializer

dom-serializer Node.js CI

Renders a domhandler DOM node or an array of domhandler DOM nodes to a string.

import render from "dom-serializer";

// OR

const render = require("dom-serializer").default;

API

render

â–¸ render(node: Node | Node[], options?: Options): string

Renders a DOM node or an array of DOM nodes to a string.

Can be thought of as the equivalent of the outerHTML of the passed node(s).

Parameters:

NameTypeDefault valueDescription
nodeNode | Node[]-Node to be rendered.
optionsDomSerializerOptions{}Changes serialization behavior

Returns: string

Options

encodeEntities

• Optional decodeEntities: boolean | "utf8"

Encode characters that are either reserved in HTML or XML.

If xmlMode is true or the value not 'utf8', characters outside of the ASCII range will be encoded as well.

default decodeEntities


decodeEntities

• Optional decodeEntities: boolean

Option inherited from parsing; will be used as the default value for encodeEntities.

default true


emptyAttrs

• Optional emptyAttrs: boolean

Print an empty attribute's value.

default xmlMode

example With emptyAttrs: false: <input checked>

example With emptyAttrs: true: <input checked="">


selfClosingTags

• Optional selfClosingTags: boolean

Print self-closing tags for tags without contents. If xmlMode is set, this will apply to all tags. Otherwise, only tags that are defined as self-closing in the HTML specification will be printed as such.

default xmlMode

example With selfClosingTags: false: <foo></foo><br></br>

example With xmlMode: true and selfClosingTags: true: <foo/><br/>

example With xmlMode: false and selfClosingTags: true: <foo></foo><br />


xmlMode

• Optional xmlMode: boolean | "foreign"

Treat the input as an XML document; enables the emptyAttrs and selfClosingTags options.

If the value is "foreign", it will try to correct mixed-case attribute names.

default false


Ecosystem

NameDescription
htmlparser2Fast & forgiving HTML/XML parser
domhandlerHandler for htmlparser2 that turns documents into a DOM
domutilsUtilities for working with domhandler's DOM
css-selectCSS selector engine, compatible with domhandler's DOM
cheerioThe jQuery API for domhandler's DOM
dom-serializerSerializer for domhandler's DOM

LICENSE: MIT