Node

Node

Return a new Node

Constructor

new Node()

Source:

Members

index

Source:

Position of the current Node from its parent.

Example
node.index // returns the index of the node or -1

next

Source:

Next Node after the current Node, or null if there is none.

Example
node.next // returns null

nextElement

Source:

Next Element after the current Node, or null if there is none.

Example
node.nextElement // returns an element or null

previous

Source:

Previous Node before the current Node, or null if there is none.

Example
node.previous // returns a node or null

previousElement

Source:

Previous Element before the current Node, or null if there is none.

Example
node.previousElement // returns an element or null

root

Source:

Top-most ancestor from the current Node.

Example
node.root // returns the top-most node or the current node itself

Methods

after(…nodes)

Source:

Insert one or more Nodes after the current Node, returning the current Node.

Example
node.after(new Text({ data: 'Hello World' }))
Parameters:
Name Type Attributes Description
nodes Node | string <repeatable>

Any nodes to be inserted after the current Node.

append(…nodes)

Source:

Append Nodes or new Text Nodes to the current Node, returning the current Node.

Example
node.append(someOtherNode)
Parameters:
Name Type Attributes Description
nodes Node | string <repeatable>

Any nodes to be inserted after the last child of the current Node.

appendTo(parent)

Source:

Append the current Node to another Node, returning the current Node.

Parameters:
Name Type Description
parent Container

Container for the current Node.

before(…nodes)

Source:

Insert Nodes or new Text Nodes before the Node if it has a parent, returning the current Node.

Example
node.before(new Text({ data: 'Hello World' })) // returns the current node
Parameters:
Name Type Attributes Description
nodes Node | string <repeatable>

Any nodes to be inserted before the current Node.

prepend(…nodes)

Source:

Prepend Nodes or new Text Nodes to the current Node, returning the current Node.

Example
node.prepend(someOtherNode)
Parameters:
Name Type Attributes Description
nodes Node | string <repeatable>

Any nodes inserted before the first child of the current Node.

remove()

Source:

Remove the current Node from its parent, returning the current Node.

Example
node.remove() // returns the current node

replaceWith(…nodes)

Source:

Replace the current Node with another Node or Nodes, returning the current Node.

Example
node.replaceWith(someOtherNode) // returns the current node
Parameters:
Name Type Attributes Description
nodes Node <repeatable>

Any nodes replacing the current Node.

visit(result, overrideVisitorsopt) → {ResultPromise}

Source:

Transform the current Node and any descendants using visitors.

Examples
await node.visit(result)
await node.visit() // visit using the result of the current node
await node.visit(result, {
  Element () {
    // do something to an element
  }
})
Parameters:
Name Type Attributes Description
result Result

Result to be used by visitors.

overrideVisitors Object <optional>

Alternative visitors to be used in place of Result visitors.

Returns:
Type
ResultPromise

warn(result, text, optsopt)

Source:

Add a warning from the current Node.

Examples
node.warn(result, 'Something went wrong')
node.warn(result, 'Something went wrong', {
  node: someOtherNode,
  plugin: someOtherPlugin
})
Parameters:
Name Type Attributes Description
result Result

Result the warning is being added to.

text string

Message being sent as the warning.

opts Object <optional>

Additional information about the warning.