package
A small set of utilities for dealing with parse5 syntax trees
npm install @parse5/toolsGitHub-flavored package documentation.
Across all versions.
Download trend unavailable.
Runtime metadata.
Estimated unpacked size across 1 packages.
27.8 kB
Includes dependencies.
A set of tools for interacting with and manipulating a parse5 AST.
The parse5 tree adapter architecture can make AST types, traversal and manipulation difficult due to its customisability.
This package introduces some assumptions (i.e. removes some customisability) in order to provide a more trivial interface to the parse5 AST for the common use case.
Due to this, the types in various places are also simplified and improved.
The default parse5 adapter is usually enough to create the nodes you need.
To make some use cases a little easier, the following do exist, though:
createElement(tagName[, attrs[, namespaceURI]])
[{name: 'foo', value: 'bar'}]) or
an object (e.g. {foo: 'bar'})createTextNode(value)createCommentNode(value)createDocument()createDocumentFragment()createTemplateNode([content])
content must be a DocumentFragment if it is setThe default parse5 adapter can already remove nodes. For ease of use, we also expose a function here:
removeNode(node)A full set of node type guard functions are availabile:
isDocumentisDocumentFragmentisTemplateNodeisElementNodeisCommentNodeisDocumentTypeNodeisTextNodeEach of these consumes a Node and acts as a TypeScript type guard:
if (isDocument(node)) {
// access document-specific properties
}These help with determining if a given node can have children, or can be a child.
isChildNodeisParentNodeThese too are TypeScript type guards:
if (isChildNode(node)) {
// interact with node.parentNode
}
if (isParentNode(node)) {
// interact with node.childNodes
}If you need to mutate a child:
replaceWith(node, ...replacements) - replaces a given node with one or more
nodesspliceChildren(node, start, deleteCount[, ...children]) - splices the
children of a node just the same as Array#spliceFor interacting with and mutating attributes of an element:
setAttribute(node, name, value)getAttribute(node, name)hasAttribute(node, name)removeAttribute(node, name)getAttributeIndex(node, name)For dealing with text content of nodes:
getTextContent(node)setTextContent(node, str)Unless otherwise specified, all traversal functions are depth first.
Additionally, all capable of returning multiple nodes are iterators.
query(node, condition)From a given node, this queries for a child at any depth which matches the condition.
For example, to find the first document fragment:
query(
node,
(node) => isDocumentFragment(node)
);queryAll(node[, condition])From a given node, this queries for all children at any depth which match the condition.
For example, to find all elements:
const elements = query(
node,
(node) => isElementNode(node)
);
for (const element of elements) {
// do something
}ancestors(node)Discovers all parents of the specified node until the root document.
walkChildren(node)Discovers all children of the specified node, depth-first.
previousSiblings(node)Discovers all previous siblings of the specified node.
nextSiblings(node)Discovers all next siblings of the specified node.
traverseThe traverse function allows you to specify a visitor which will be called for each matching type encountered while traversing the tree depth-first.
For example:
traverse(node, {
text: (textNode) => {
// do something with a text node
}
});Each node type can have a visitor (e.g. you could have an element function).
pre:nodeThere is one special visit function: pre:node.
This is called before visiting any node and will prevent traversing into the current node's children if it returns false.
For example:
traverse(node, {
'pre:node': (node) => {
return isElement(node);
}
});This example would traverse into the children of only element nodes as all others would have returned false.
fb55
me@feedic.com