domhandler
- Version 5.0.3
- Published
- 75.3 kB
- 1 dependency
- BSD-2-Clause license
Install
npm i domhandleryarn add domhandlerpnpm add domhandlerOverview
Handler for htmlparser2 that turns pages into a dom
Index
Functions
Classes
Interfaces
Type Aliases
Functions
function cloneNode
cloneNode: <T extends Node>(node: T, recursive?: boolean) => T;Clone a node, and optionally its children.
Parameter recursive
Clone child nodes as well.
Returns
A clone of the node.
function hasChildren
hasChildren: (node: Node) => node is ParentNode;Parameter node
Node to check.
Returns
trueif the node has children,falseotherwise.
function isCDATA
isCDATA: (node: Node) => node is CDATA;Parameter node
Node to check.
Returns
trueif the node has the typeCDATA,falseotherwise.
function isComment
isComment: (node: Node) => node is Comment;Parameter node
Node to check.
Returns
trueif the node has the typeComment,falseotherwise.
function isDirective
isDirective: (node: Node) => node is ProcessingInstruction;Parameter node
Node to check.
Returns
trueif the node has the typeProcessingInstruction,falseotherwise.
function isDocument
isDocument: (node: Node) => node is Document;Parameter node
Node to check.
Returns
trueif the node has the typeProcessingInstruction,falseotherwise.
function isTag
isTag: (node: Node) => node is Element;Parameter node
Node to check.
Returns
trueif the node is aElement,falseotherwise.
function isText
isText: (node: Node) => node is Text;Parameter node
Node to check.
Returns
trueif the node has the typeText,falseotherwise.
Classes
class CDATA
class CDATA extends NodeWithChildren {}class Comment
class Comment extends DataNode {}Comments within the document.
class DataNode
abstract class DataNode extends Node {}A node that contains some data.
constructor
constructor(data: string);Parameter data
The content of the data node
property data
data: string;property nodeValue
nodeValue: string;Same as data. [DOM spec](https://dom.spec.whatwg.org)-compatible alias.
class Document
class Document extends NodeWithChildren {}The root node of the document.
class DomHandler
class DomHandler {}constructor
constructor( callback?: Callback, options?: DomHandlerOptions, elementCB?: ElementCallback);Parameter callback
Called once parsing has completed.
Parameter options
Settings for the handler.
Parameter elementCB
Callback whenever a tag is closed.
property dom
dom: ChildNode[];The elements of the DOM
property lastNode
protected lastNode: DataNode;A data node that is still being written to.
property root
root: Document;The root element for the DOM
property tagStack
protected tagStack: ParentNode[];Stack of open tags.
method addNode
protected addNode: (node: ChildNode) => void;method handleCallback
protected handleCallback: (error: Error | null) => void;method oncdataend
oncdataend: () => void;method oncdatastart
oncdatastart: () => void;method onclosetag
onclosetag: () => void;method oncomment
oncomment: (data: string) => void;method oncommentend
oncommentend: () => void;method onend
onend: () => void;method onerror
onerror: (error: Error) => void;method onopentag
onopentag: (name: string, attribs: { [key: string]: string }) => void;method onparserinit
onparserinit: (parser: ParserInterface) => void;method onprocessinginstruction
onprocessinginstruction: (name: string, data: string) => void;method onreset
onreset: () => void;method ontext
ontext: (data: string) => void;class Element
class Element extends NodeWithChildren {}An element within the DOM.
constructor
constructor( name: string, attribs: { [name: string]: string }, children?: ChildNode[], type?: any);Parameter name
Name of the tag, eg.
div,span.Parameter attribs
Object mapping attribute names to attribute values.
Parameter children
Children of the node.
property "x-attribsNamespace"
'x-attribsNamespace'?: Record<string, string>;Element attribute namespaces (parse5 only).
property "x-attribsPrefix"
'x-attribsPrefix'?: Record<string, string>;Element attribute namespace-related prefixes (parse5 only).
property attribs
attribs: { [name: string]: string };property attributes
readonly attributes: Attribute[];property name
name: string;property namespace
namespace?: string;Element namespace (parse5 only).
property nodeType
readonly nodeType: number;property sourceCodeLocation
sourceCodeLocation?: TagSourceCodeLocation;parse5source code location info, with start & end tags.Available if parsing with parse5 and location info is enabled.
property tagName
tagName: string;Same as name. [DOM spec](https://dom.spec.whatwg.org)-compatible alias.
property type
type: any;class Node
abstract class Node {}This object will be used as the prototype for Nodes when creating a DOM-Level-1-compliant structure.
property endIndex
endIndex: number;The end index of the node. Requires
withEndIndiceson the handler to be `true.
property next
next: ChildNode;Next sibling
property nextSibling
nextSibling: ChildNode;Same as next. [DOM spec](https://dom.spec.whatwg.org)-compatible alias.
property nodeType
abstract readonly nodeType: number;[DOM spec](https://dom.spec.whatwg.org/#dom-node-nodetype)-compatible node .
property parent
parent: ParentNode;Parent of the node
property parentNode
parentNode: ParentNode;Same as parent. [DOM spec](https://dom.spec.whatwg.org)-compatible alias.
property prev
prev: ChildNode;Previous sibling
property previousSibling
previousSibling: ChildNode;Same as prev. [DOM spec](https://dom.spec.whatwg.org)-compatible alias.
property sourceCodeLocation
sourceCodeLocation?: SourceCodeLocation;parse5source code location info.Available if parsing with parse5 and location info is enabled.
property startIndex
startIndex: number;The start index of the node. Requires
withStartIndiceson the handler to be `true.
property type
abstract readonly type: ElementType;The type of the node.
method cloneNode
cloneNode: <T extends Node>(this: T, recursive?: boolean) => T;Clone this node, and optionally its children.
Parameter recursive
Clone child nodes as well.
Returns
A clone of the node.
class NodeWithChildren
abstract class NodeWithChildren extends Node {}A
Nodethat can have children.
constructor
constructor(children: ChildNode[]);Parameter children
Children of the node. Only certain node types can have children.
property childNodes
childNodes: ChildNode[];Same as children. [DOM spec](https://dom.spec.whatwg.org)-compatible alias.
property children
children: ChildNode[];property firstChild
readonly firstChild: ChildNode;First child of the node.
property lastChild
readonly lastChild: ChildNode;Last child of the node.
class ProcessingInstruction
class ProcessingInstruction extends DataNode {}Processing instructions, including doc types.
constructor
constructor(name: string, data: string);property "x-name"
'x-name'?: string;If this is a doctype, the document type name (parse5 only).
property "x-publicId"
'x-publicId'?: string;If this is a doctype, the document type public identifier (parse5 only).
property "x-systemId"
'x-systemId'?: string;If this is a doctype, the document type system identifier (parse5 only).
property name
name: string;property nodeType
readonly nodeType: number;property type
type: ElementType.Directive;Interfaces
interface DomHandlerOptions
interface DomHandlerOptions {}property withEndIndices
withEndIndices?: boolean;Add an
endIndexproperty to nodes. When the parser is used in a non-streaming fashion,endIndexis an integer indicating the position of the end of the node in the document.false
property withStartIndices
withStartIndices?: boolean;Add a
startIndexproperty to nodes. When the parser is used in a non-streaming fashion,startIndexis an integer indicating the position of the start of the node in the document.false
property xmlMode
xmlMode?: boolean;Treat the markup as XML.
false
Type Aliases
type AnyNode
type AnyNode = ParentNode | ChildNode;type ChildNode
type ChildNode = Text | Comment | ProcessingInstruction | Element | CDATA | Document;type ParentNode
type ParentNode = Document | Element | CDATA;Package Files (2)
Dependencies (1)
Dev Dependencies (11)
Peer Dependencies (0)
No peer dependencies.
Badge
To add a badge like this oneto your package's README, use the codes available below.
You may also use Shields.io to create a custom badge linking to https://www.jsdocs.io/package/domhandler.
- Markdown[](https://www.jsdocs.io/package/domhandler)
- HTML<a href="https://www.jsdocs.io/package/domhandler"><img src="https://img.shields.io/badge/jsDocs.io-reference-blue" alt="jsDocs.io"></a>
- Updated .
Package analyzed in 3013 ms. - Missing or incorrect documentation? Open an issue for this package.
