DefaultTab

Last mouse X position for this tab (for natural trajectories in anti-detection). Each tab maintains its own mouse position to prevent concurrent operations from interfering.

Last mouse Y position for this tab (for natural trajectories in anti-detection). Each tab maintains its own mouse position to prevent concurrent operations from interfering.

Activates the tab, bringing it to the foreground.

Adds a handler for a specific CDP event.

Navigate back in the tab's history.

Brings the tab to the front, activating it.

Internal method to call a CDP command.

Closes the websocket connection. Should not be called manually by users.

Disables the DOM agent to stop receiving DOM-related events.

Evaluates a JavaScript expression in the context of the tab.

Expects a request to match the given urlPattern.

Expects multiple requests matching the given list of urlPatterns. All expectations are active concurrently during block.

Finds a single element by its text content, optionally waiting for it to appear.

Finds multiple elements by their text content, optionally waiting for them to appear.

Finds and returns the first element containing the specified text, or the best match if bestMatch is true.

Returns elements which match the given text. Please note: this may (or will) also return any other element (like inline scripts), which happen to contain that text.

Navigate forward in the tab's history.

Sets the tab's window to fullscreen mode.

Navigate to a specified URL in the tab.

Gets all elements of tag: link, a, img, script, meta.

Convenience function, which returns all links (a, link, img, script, meta).

Gets the content of the tab as a string.

Gets the current window information for the tab.

Intercepts network requests matching the given urlPattern and requestStage. This allows you to modify requests, responses, or block them entirely.

Maximizes the tab's window.

Restores the tab's window to its normal state.

Minimizes the tab's window.

Performs a native mouse click at the specified \[x, y\] coordinates.

Moves the mouse cursor to the specified \[x, y\] coordinates, optionally in multiple steps and with a flash effect.

Finds a single element based on a CSS selector string.

Equivalent of JavaScript's document.querySelectorAll. This is considered one of the main methods to use in this package.

Evaluates a JavaScript expression in the context of the tab.

Reload the current page in the tab.

Saves a screenshot of the page. This is not the same as Element.saveScreenshot, which saves a screenshot of a single element only.

Takes a screenshot of the page and returns the result as a base64 encoded string. This is not the same as Element.screenshotB64, which takes a screenshot of a single element only.

Scrolls the tab down by a specified amount.

Scrolls the page naturally using CDP's synthesizeScrollGesture (P3 - Anti-detection). This creates smooth, human-like scrolling instead of instant jumps.

Scrolls the tab up by a specified amount.

Selects an element in the DOM using a CSS selector.

Finds multiple elements by CSS selector, optionally waiting for them to appear.

Sends a CDP command and waits for the response.

Sets the user agent for the tab.

Sets the tab's window state, including position and size.

Suspends the coroutine for a specified time in milliseconds.

Updates the target information by fetching it from the CDP.

Waits until the event listener reports idle (no new events received in a certain timespan). When \`t\` is provided, ensures waiting for \`t\` milliseconds, no matter what.

Waits for the document's ready state to reach a specified state.

Finds elements by XPath string.