Node

You can obtain Node instances through Page query methods:

• page.querySelector(selector) - Find first matching element
• page.querySelectorAll(selector) - Find all matching elements
• node.querySelector(selector) - Find first matching element within this node
• node.querySelectorAll(selector) - Find all matching elements within this node

Properties

nodeType

The type of node (1 for Element, 3 for Text).

nodeName

The name of the node (tag name for elements, ‘#text’ for text nodes).

nodeValue

The text content for text nodes, null for elements.

tagName

The tag name of the element (empty string for non-elements).

textContent

The text content of the node and its descendants.

innerHTML

The HTML content inside the element.

childNodes

Array of child nodes.

firstChild

The first child node, or null if none exists.

lastChild

The last child node, or null if none exists.

Methods

getAttribute(name)

Gets the value of an attribute.

const href = element.getAttribute('href');

hasAttribute(name)

Checks if an attribute exists.

if (element.hasAttribute('disabled')) {
    console.log('Element is disabled');
}

click([options])

Clicks the element.

// Simple click
await element.click();

// Click with navigation wait
await element.click({ waitForNavigation: 'networkidle2' });

type(text[, options])

Types text into the element.

await element.type('Hello world');

focus([options])

Focuses the element.

await element.focus();

blur([options])

Removes focus from the element.

await element.blur();

hover([options])

Hovers over the element.

await element.hover();

scrollIntoView([options])

Scrolls the element into view.

await element.scrollIntoView();

setValue(value[, options])

Sets the value of a form element.

// Set input value
await element.setValue('test@example.com');

// Set checkbox
await element.setValue(true);

dispatchEvent(eventName[, detail, options])

Dispatches an event on the element.

await element.dispatchEvent('click');

dragTo(target[, options])

Drags this element to another element or selector.

// Drag to another element
const target = await page.querySelector('.dropzone');
await element.dragTo(target);

// Drag to selector
await element.dragTo('.dropzone');

querySelector(selector)

Finds the first matching element within this node.

const child = await element.querySelector('.child');

querySelectorAll(selector)

Finds all matching elements within this node.

const children = await element.querySelectorAll('.child');

getBoundingClientRect()

Gets the element’s position and size.

const rect = element.getBoundingClientRect();
console.log(rect.x, rect.y, rect.width, rect.height);

Example Usage

Here’s a complete example showing how to use the Node class:

// Get a form element
const form = await page.querySelector('form');

// Fill out form fields
const emailInput = await form.querySelector('input[type="email"]');
await emailInput.type('test@example.com');

// Check a checkbox
const checkbox = await form.querySelector('.terms-checkbox');
await checkbox.setValue(true);

// Get form dimensions
const rect = form.getBoundingClientRect();
console.log('Form size:', rect.width, rect.height);

// Submit the form
const submitButton = await form.querySelector('button[type="submit"]');
await submitButton.click({ waitForNavigation: 'networkidle2' });