niddle

A super fast Node.js addon for HTML parsing and manipulation, written in Rust.

Features

• High-performance DOM parsing and manipulation
• Exposes a simple JavaScript API via NAPI-RS
• Designed for both server-side and CLI HTML processing
• Written in Rust for speed and safety

Installation

yarn add niddle
# or
npm install niddle

Usage

const { parse } = require('niddle');
const root = parse('<div id="foo" class="bar">hello <span>world</span></div>');

const div = root.select('div');
console.log(div.getAttribute('id')); // "foo"
console.log(div.text()); // "hello world"
div.setAttribute('title', 'my-title');
console.log(div.outerHtml()); // <div id="foo" class="bar" title="my-title">hello <span>world</span></div>

API Documentation

parse(html: string): NodeRepr

Parses an HTML string and returns a NodeRepr instance representing the root node.

Parameters

• html (string): The HTML content to parse.

Returns

• NodeRepr: The parsed root node.

NodeRepr Class

Represents a DOM node and provides various manipulation methods.

Methods

• append(content: string | NodeRepr): void
  • Appends a new node or HTML string as a child.
• appendSequence(nodes: NodeRepr[]): void
  • Appends multiple nodes.
• clone(): NodeRepr
  • Clones the current node (not including descendants).
• cloneRecursive(): NodeRepr
  • Clones the node and all descendants.
• getAttribute(name: string): string
  • Gets an attribute value by name.
• getAttributes(): Record<string, string>
  • Gets all attributes as a key-value object.
• getChildren(): NodeRepr[]
  • Returns all child nodes.
• innerHtml(): string
  • Gets the HTML content of all descendants.
• insertAfter(node: NodeRepr): void
  • Inserts the current node after the specified node.
• insertBefore(node: NodeRepr): void
  • Inserts the current node before the specified node.
• insertSequenceAfter(nodes: NodeRepr[]): void
  • Inserts multiple nodes after the current node.
• insertSequenceBefore(nodes: NodeRepr[]): void
  • Inserts multiple nodes before the current node.
• outerHtml(): string
  • Gets the HTML content including the node itself.
• prepend(content: string | NodeRepr): void
  • Prepends a new node or HTML string as a child.
• prependSequence(nodes: NodeRepr[]): void
  • Prepends multiple nodes.
• remove(): void
  • Removes the node from the DOM.
• removeAllAttributes(): void
  • Removes all attributes from the node.
• removeAttribute(name: string): void
  • Removes an attribute by name.
• select(selectors: string): NodeRepr
  • Selects the first node matching the selector.
• selectAll(selectors: string): NodeRepr[]
  • Selects all nodes matching the selector.
• setAttribute(name: string, value: string): void
  • Sets an attribute value.
• setAttributes(attrs: Record<string, string>): void
  • Sets multiple attributes.
• text(): string
  • Gets the text content of the node.

Contributing

yarn install
yarn build
yarn test

Benchmark

cargo benchmark
yarn benchmark

For more usage examples and advanced API, see the source code and benchmarks in the repository.