All Implemented Interfaces:: ai.platon.pulsar.skeleton.crawl.fetch.driver.WebDriver , java.io.Closeable , java.lang.AutoCloseable , kotlin.Comparable


public abstract class AbstractWebDriver
 implements Comparable<AbstractWebDriver>, WebDriver

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`public enum`	`AbstractWebDriver.State`	The state of the driver. State.INIT: The driver is initialized. State.READY: The driver is ready to work. State.WORKING: The driver is working. State.RETIRED: The driver is retired and should be quit as soon as possible. State.QUIT: The driver is quit.

Field Summary

Fields
Modifier and Type	Field	Description
`private final Integer`	`parentSid`
`private final BrowserSettings`	`settings`
`private final Float`	`resourceBlockProbability`
`private final List<String>`	`blockedURLs`
`private final List<String>`	`probabilisticBlockedURLs`
`private final Boolean`	`isConnectable`
`private final BrowserChatModel`	`chatModel`
`private final Object`	`implementation`
`private final SnapshotService`	`snapshotService`
`private Duration`	`idleTimeout`
`private Instant`	`lastActiveTime`
`private final Boolean`	`isIdle`
`private final Boolean`	`isActive`
`private final Boolean`	`isInit`
`private final Boolean`	`isReady`
`private final Boolean`	`isWorking`
`private final Boolean`	`isRetired`
`private final Boolean`	`isQuit`
`private final Boolean`	`isCanceled`
`private final Boolean`	`isCrashed`
`private final String`	`status`
`private final Boolean`	`isMockedPageSource`
`private Boolean`	`isRecovered`
`private Boolean`	`isReused`
`private Boolean`	`isRecyclable`
`private Boolean`	`ignoreDOMFeatures`
`private final <Error class: unknown class>`	`name`
`private NavigateEntry`	`navigateEntry`
`private final NavigateHistory`	`navigateHistory`
`private final <Error class: unknown class>`	`delayPolicy`
`private final <Error class: unknown class>`	`timeoutPolicy`
`private final List<WebDriver>`	`frames`
`private WebDriver`	`opener`
`private final Set<WebDriver>`	`outgoingPages`
`private final Map<String, Object>`	`data`
`private final Map<String, Object>`	`mainRequestHeaders`
`private final List<Map<String, String>>`	`mainRequestCookies`
`private final Integer`	`mainResponseStatus`
`private final String`	`mainResponseStatusText`
`private final Map<String, Object>`	`mainResponseHeaders`
`private final String`	`guid`
`private final AbstractBrowser`	`browser`
`private final Integer`	`id`
`private final BrowserType`	`browserType`

Constructor Summary

Constructors
Constructor	Description
`AbstractWebDriver(String guid, AbstractBrowser browser, Integer id)`

Enum Constant Summary

Enum Constants
Enum Constant	Description

Method Summary

Modifier and Type	Method	Description
`Integer`	`getParentSid()`	The parent driver id.
`final BrowserSettings`	`getSettings()`
`final Float`	`getResourceBlockProbability()`
`final List<String>`	`getBlockedURLs()`
`final List<String>`	`getProbabilisticBlockedURLs()`
`final Boolean`	`isConnectable()`
`BrowserChatModel`	`getChatModel()`
`Object`	`getImplementation()`
`SnapshotService`	`getSnapshotService()`
`final Duration`	`getIdleTimeout()`	Idle timeout before a READY driver is considered stale and eligible for recycling/retirement.
`final Unit`	`setIdleTimeout(Duration idleTimeout)`	Idle timeout before a READY driver is considered stale and eligible for recycling/retirement.
`final Instant`	`getLastActiveTime()`
`final Unit`	`setLastActiveTime(Instant lastActiveTime)`
`final Boolean`	`isIdle()`
`final Boolean`	`isActive()`
`final Boolean`	`isInit()`
`final Boolean`	`isReady()`
`final Boolean`	`isWorking()`
`final Boolean`	`isRetired()`
`final Boolean`	`isQuit()`
`final Boolean`	`isCanceled()`
`final Boolean`	`isCrashed()`
`final String`	`getStatus()`
`Boolean`	`isMockedPageSource()`	True if pageSource is a mocked/fake value (e.g.
`final Boolean`	`isRecovered()`	Driver participated in a recovery workflow (e.g.
`final Unit`	`setRecovered(Boolean isRecovered)`	Driver participated in a recovery workflow (e.g.
`final Boolean`	`isReused()`	Driver reused from pool after previous task.
`final Unit`	`setReused(Boolean isReused)`	Driver reused from pool after previous task.
`final Boolean`	`isRecyclable()`	If recyclable the driver returns to a standby pool post-task; else it remains dedicated until retired.
`final Unit`	`setRecyclable(Boolean isRecyclable)`	If recyclable the driver returns to a standby pool post-task; else it remains dedicated until retired.
`final Boolean`	`getIgnoreDOMFeatures()`	Skip DOM feature computation if true (performance optimization for pure interaction tasks).
`final Unit`	`setIgnoreDOMFeatures(Boolean ignoreDOMFeatures)`	Skip DOM feature computation if true (performance optimization for pure interaction tasks).
`<Error class: unknown class>`	`getName()`
`NavigateEntry`	`getNavigateEntry()`	Navigate entry for the current page (URL + metadata).
`Unit`	`setNavigateEntry(NavigateEntry navigateEntry)`	Navigate entry for the current page (URL + metadata).
`NavigateHistory`	`getNavigateHistory()`	History of navigation entries.
`<Error class: unknown class>`	`getDelayPolicy()`	Delay policy (per action random delay ranges) derived from browser settings.
`<Error class: unknown class>`	`getTimeoutPolicy()`	Timeout policy (per action max durations) derived from browser settings.
`List<WebDriver>`	`getFrames()`	Child frame drivers (if any)
`WebDriver`	`getOpener()`	Page opener driver (if window opened by script / click)
`Unit`	`setOpener(WebDriver opener)`	Page opener driver (if window opened by script / click)
`Set<WebDriver>`	`getOutgoingPages()`	Pages opened from this page (window.open, target=_blank, etc.
`Map<String, Object>`	`getData()`	Arbitrary contextual data store.
`final Map<String, Object>`	`getMainRequestHeaders()`
`final List<Map<String, String>>`	`getMainRequestCookies()`
`final Integer`	`getMainResponseStatus()`
`final String`	`getMainResponseStatusText()`
`final Map<String, Object>`	`getMainResponseHeaders()`
`String`	`getGuid()`	The guid of the driver.
`AbstractBrowser`	`getBrowser()`	The browser of the driver.
`Integer`	`getId()`	The driver id, starts with 1.
`final Unit`	`free()`	Transition to READY (available for assignment).
`final Unit`	`startWork()`	Transition to WORKING (exclusive usage).
`final Unit`	`retire()`	Mark for disposal after current task.
`final Unit`	`cancel()`	Request cooperative cancellation of current task (best-effort).
`Unit`	`addInitScript(String script)`	Adds a script which would be evaluated whenever the page is navigated.
`Unit`	`navigate(String url)`	Navigates current page to the given URL.
`Unit`	`reload()`	Reloads the current page.
`String`	`currentUrl()`	Returns a string representing the current URL that the browser is looking at.
`String`	`url()`	The URL read-only property of the Document interface returns the document location as a string.
`String`	`documentURI()`	Returns the document location as a string.
`String`	`baseURI()`	Returns the document's baseURI.
`String`	`title()`	Returns the title of the current page.
`String`	`referrer()`	The referrer property returns the URI of the page that linked to this page.
`ModelResponse`	`chat(String prompt, String selector)`	Interact with an AI model using the context of the element selected by selector.
`<T extends Any> T`	`evaluate(String expression, T defaultValue)`	Executes JavaScript and returns the result, or defaultValue if the result is null or incompatible.
`<T extends Any> T`	`evaluateValue(String expression, T defaultValue)`	Executes JavaScript and returns the result as a JSON-serializable value, or defaultValue if null/incompatible.
`Boolean`	`isVisible(String selector)`	Returns whether the element is visible.
`Boolean`	`isChecked(String selector)`	Returns whether the element is checked.
`Double`	`scrollDown(Integer count)`	The current page frame scrolls down for count times.
`Double`	`scrollUp(Integer count)`	The current page frame scrolls up for count times.
`Double`	`scrollBy(Double pixels, Boolean smooth)`	Scrolls the current page frame vertically by the given number of pixels.
`Double`	`scrollToTop()`	The current page frame scrolls to the top.
`Double`	`scrollToBottom()`	The current page frame scrolls to the bottom.
`Double`	`scrollToMiddle(Double ratio)`	The current page frame scrolls to the middle.
`Double`	`scrollToViewport(Double n, Boolean smooth)`	Scrolls to the position of the n-th viewport.
`String`	`outerHTML()`	Returns the document's HTML markup.
`String`	`outerHTML(String selector)`	Returns the node's HTML markup, the node is located by selector.
`String`	`textContent(String selector)`	Returns the text content of the document or a specific element.
`Map<String, String>`	`extract(Map<String, String> fields)`	Extracts multiple fields from the page using CSS selectors.
`String`	`selectFirstTextOrNull(String selector)`	Returns the node's text content, the node is located by selector.
`List<String>`	`selectTextAll(String selector)`	Returns a list of text contents of all the elements matching the specified selector within the page.
`String`	`selectFirstAttributeOrNull(String selector, String attrName)`	Returns the node's attribute value, the node is located by selector, the attribute is attrName.
`Map<String, String>`	`selectAttributes(String selector)`	Returns the node's attribute values, the node is located by selector.
`List<String>`	`selectAttributeAll(String selector, String attrName, Integer start, Integer limit)`	Returns the nodes' attribute values, the nodes are located by selector, the attribute is attrName.
`Unit`	`setAttribute(String selector, String attrName, String attrValue)`	Set the attribute of an element located by selector.
`Unit`	`setAttributeAll(String selector, String attrName, String attrValue)`	Set the attribute of all elements matching the CSS query.
`String`	`selectFirstPropertyValueOrNull(String selector, String propName)`	Returns the node's property value, the node is located by selector, the property is propName.
`List<String>`	`selectPropertyValueAll(String selector, String propName, Integer start, Integer limit)`	Returns the nodes' property values, the nodes are located by selector, the property is propName.
`Unit`	`setProperty(String selector, String propName, String propValue)`	Set the property of an element located by selector.
`Unit`	`setPropertyAll(String selector, String propName, String propValue)`	Set the property of all elements matching the CSS query.
`List<Hyperlink>`	`selectHyperlinks(String selector, Integer offset, Integer limit)`	Find hyperlinks in elements matching the selector.
`List<GeoAnchor>`	`selectAnchors(String selector, Integer offset, Integer limit)`	Select anchors (link + coordinates) – placeholder implementation until util binding available.
`List<String>`	`selectImages(String selector, Integer offset, Integer limit)`	Select image URLs (abs:src) – placeholder implementation.
`Unit`	`clickTextMatches(String selector, String pattern, Integer count)`	This method clicks an element with selector whose text content matches pattern, and then focuses it.
`Unit`	`clickMatches(String selector, String attrName, String pattern, Integer count)`	This method clicks an element with selector whose attribute name is attrName and value matches pattern, and then focuses it.
`Unit`	`check(String selector)`	This method check an element with selector.
`Unit`	`uncheck(String selector)`	This method uncheck an element with selector.
`Duration`	`waitForSelector(String selector)`	Wait until the element identified by the selector becomes present in the DOM or timeout.
`Duration`	`waitForSelector(String selector, SuspendFunction0<Unit> action)`	Wait for the element identified by the selector to become present in the DOM, or until timeout.
`Duration`	`waitForNavigation(String oldUrl)`	Wait until the current url changes or timeout.
`Duration`	`waitForNavigation(String oldUrl, Duration timeout)`	Wait until the current url changes or timeout.
`Duration`	`waitUntil(SuspendFunction0<Boolean> predicate)`	Wait until the predicate returns true.
`Duration`	`waitUntil(Duration timeout, SuspendFunction0<Boolean> predicate)`	Wait until the predicate returns true.
`final Long`	`randomDelayMillis(String action, IntRange fallback)`	Generate a random delay in milliseconds for an action.
`final Duration`	`timeout(String action, Duration fallback)`
`Connection`	`newJsoupSession()`	Create a new Jsoup session with the last page's context, which means, the same headers and cookies.
`Connection.Response`	`loadJsoupResource(String url)`	Load the url as a resource with Jsoup rather than browser rendering, with the last page's context.
`NetworkResourceResponse`	`loadResource(String url)`	Load the url as a resource without browser rendering, with the last page's context.
`Boolean`	`equals(Object other)`
`Integer`	`hashCode()`
`Integer`	`compareTo(AbstractWebDriver other)`
`String`	`toString()`
`Unit`	`terminate()`
`Unit`	`awaitTermination()`
`Unit`	`close()`
`final Boolean`	`checkState(String action)`

Methods inherited from class ai.platon.pulsar.skeleton.crawl.fetch.driver.WebDriver
addBlockedURLs, ariaSnapshot, ariaSnapshot, boundingBox, bringToFront, captureScreenshot, captureScreenshot, captureScreenshot, clearBrowserCookies, click, click, clickablePoint, dblclick, dblclick, delay, delay, delay, deleteCookies, dialogAccept, dialogDismiss, drag, dragAndDrop, evaluate, evaluateDetail, evaluateValue, evaluateValue, evaluateValueDetail, evaluateValueDetail, exists, fill, focus, getBrowserType, getCookies, goBack, goForward, hover, isHidden, keyDown, keyUp, mouseDown, mouseMove, mouseUp, mouseWheel, mouseWheelDown, mouseWheelUp, moveMouseTo, moveMouseTo, nanoDOMTree, navigate, navigateTo, navigateTo, open, pageSource, pause, press, querySelectorAll, resize, screenshot, screenshot, screenshot, scrollTo, selectOption, selectOption, stop, type, upload, waitForFunction, waitForNavigation, waitForPage, waitForSelector, waitForSelector, waitForSelector, waitForSelector, waitUntil
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - AbstractWebDriver
```
AbstractWebDriver(String guid, AbstractBrowser browser, Integer id)
```
- Method Detail
  - getParentSid
```
 Integer getParentSid()
```
    The parent driver id. The id is unique in process scope.
  - getSettings
```
 final BrowserSettings getSettings()
```
  - getResourceBlockProbability
```
 final Float getResourceBlockProbability()
```
  - getBlockedURLs
```
 final List<String> getBlockedURLs()
```
  - getProbabilisticBlockedURLs
```
 final List<String> getProbabilisticBlockedURLs()
```
  - isConnectable
```
 final Boolean isConnectable()
```
  - getChatModel
```
 BrowserChatModel getChatModel()
```
  - getImplementation
```
 Object getImplementation()
```
  - getSnapshotService
```
 SnapshotService getSnapshotService()
```
  - getIdleTimeout
```
 final Duration getIdleTimeout()
```
    Idle timeout before a READY driver is considered stale and eligible for recycling/retirement.
  - setIdleTimeout
```
 final Unit setIdleTimeout(Duration idleTimeout)
```
    Idle timeout before a READY driver is considered stale and eligible for recycling/retirement.
  - getLastActiveTime
```
 final Instant getLastActiveTime()
```
  - setLastActiveTime
```
 final Unit setLastActiveTime(Instant lastActiveTime)
```
  - isIdle
```
 final Boolean isIdle()
```
  - isActive
```
 final Boolean isActive()
```
  - isInit
```
 final Boolean isInit()
```
  - isReady
```
 final Boolean isReady()
```
  - isWorking
```
 final Boolean isWorking()
```
  - isRetired
```
 final Boolean isRetired()
```
  - isQuit
```
 final Boolean isQuit()
```
  - isCanceled
```
 final Boolean isCanceled()
```
  - isCrashed
```
 final Boolean isCrashed()
```
  - getStatus
```
 final String getStatus()
```
  - isMockedPageSource
```
 Boolean isMockedPageSource()
```
    True if pageSource is a mocked/fake value (e.g. offline / synthetic content).
  - isRecovered
```
 final Boolean isRecovered()
```
    Driver participated in a recovery workflow (e.g. auto relaunch) after crash.
  - setRecovered
```
 final Unit setRecovered(Boolean isRecovered)
```
    Driver participated in a recovery workflow (e.g. auto relaunch) after crash.
  - isReused
```
 final Boolean isReused()
```
    Driver reused from pool after previous task.
  - setReused
```
 final Unit setReused(Boolean isReused)
```
    Driver reused from pool after previous task.
  - isRecyclable
```
 final Boolean isRecyclable()
```
    If recyclable the driver returns to a standby pool post-task; else it remains dedicated until retired.
  - setRecyclable
```
 final Unit setRecyclable(Boolean isRecyclable)
```
    If recyclable the driver returns to a standby pool post-task; else it remains dedicated until retired.
  - getIgnoreDOMFeatures
```
 final Boolean getIgnoreDOMFeatures()
```
    Skip DOM feature computation if true (performance optimization for pure interaction tasks).
  - setIgnoreDOMFeatures
```
 final Unit setIgnoreDOMFeatures(Boolean ignoreDOMFeatures)
```
    Skip DOM feature computation if true (performance optimization for pure interaction tasks).
  - getName
```
 <Error class: unknown class> getName()
```
  - getNavigateEntry
```
 NavigateEntry getNavigateEntry()
```
    Navigate entry for the current page (URL + metadata).
  - setNavigateEntry
```
 Unit setNavigateEntry(NavigateEntry navigateEntry)
```
    Navigate entry for the current page (URL + metadata).
  - getNavigateHistory
```
 NavigateHistory getNavigateHistory()
```
    History of navigation entries.
  - getDelayPolicy
```
 <Error class: unknown class> getDelayPolicy()
```
    Delay policy (per action random delay ranges) derived from browser settings.
  - getTimeoutPolicy
```
 <Error class: unknown class> getTimeoutPolicy()
```
    Timeout policy (per action max durations) derived from browser settings.
  - getFrames
```
 List<WebDriver> getFrames()
```
    Child frame drivers (if any)
  - getOpener
```
 WebDriver getOpener()
```
    Page opener driver (if window opened by script / click)
  - setOpener
```
 Unit setOpener(WebDriver opener)
```
    Page opener driver (if window opened by script / click)
  - getOutgoingPages
```
 Set<WebDriver> getOutgoingPages()
```
    Pages opened from this page (window.open, target=_blank, etc.)
  - getData
```
 Map<String, Object> getData()
```
    Arbitrary contextual data store.
  - getMainRequestHeaders
```
 final Map<String, Object> getMainRequestHeaders()
```
  - getMainRequestCookies
```
 final List<Map<String, String>> getMainRequestCookies()
```
  - getMainResponseStatus
```
 final Integer getMainResponseStatus()
```
  - getMainResponseStatusText
```
 final String getMainResponseStatusText()
```
  - getMainResponseHeaders
```
 final Map<String, Object> getMainResponseHeaders()
```
  - getGuid
```
 String getGuid()
```
    The guid of the driver.
  - getBrowser
```
 AbstractBrowser getBrowser()
```
    The browser of the driver. The browser defines methods and events to manipulate a real browser.
  - getId
```
 Integer getId()
```
    The driver id, starts with 1. The id is unique in process scope.
  - free
```
 final Unit free()
```
    Transition to READY (available for assignment). Resets cancellation/crash flags. Must only be called after INIT or WORKING states.
  - startWork
```
 final Unit startWork()
```
    Transition to WORKING (exclusive usage). Resets cancellation/crash flags.
  - retire
```
 final Unit retire()
```
    Mark for disposal after current task.
  - cancel
```
 final Unit cancel()
```
    Request cooperative cancellation of current task (best-effort).
  - addInitScript
```
 Unit addInitScript(String script)
```
    Adds a script which would be evaluated whenever the page is navigated. @mcp
    The script is evaluated after the document was created but before any of its scripts were run. This is useful to amend the JavaScript environment, e.g. to seed Math.random.
    This function should be invoked before a navigation, usually in an onWillNavigate event handler.
    
    Parameters:
    
    script - JavaScript source code to add.
  - navigate
```
 Unit navigate(String url)
```
    Navigates current page to the given URL. @mcp
    driver.navigate("https://www.example.com") driver.waitForNavigation()
    Parameters:
    
    url - URL to navigate page to.
  - reload
```
 Unit reload()
```
    Reloads the current page. @mcp
    This method should trigger a reload of the current page, similar to how a user would refresh the page in a browser.
  - currentUrl
```
 String currentUrl()
```
    Returns a string representing the current URL that the browser is looking at. @mcp
    The current url is always the main frame's document.documentURI if the browser succeed to return it, and is displayed in the browser's address bar.
    If the browser failed to return a proper url, returns the passed in url to navigate, just like a real user enter a url in the address bar but the browser failed to load the page.
    NOTE: the url can be non-standard, for example:
    about:blank chrome://newtab chrome://settings
    see ai.platon.cdt.kt.protocol.types.page.NavigationEntry.userTypedURL
    
    Returns:
    
    A string containing the URL of the document, or the passed in url to navigate.
  - url
```
 String url()
```
    The URL read-only property of the Document interface returns the document location as a string. @mcp
    This property equals to javascript document.URL. The document.URL property returns the same value. The document.documentURI property can be used on any document types, while the document.URL property can only be used on HTML documents.
    
    Returns:
    
    A string containing the URL of the document
  - documentURI
```
 String documentURI()
```
    Returns the document location as a string. @mcp
    This property equals to javascript document.documentURI.
    The document.URL property which returns the same value. The document.documentURI property can be used on any document types, while the document.URL property can only be used on HTML documents.
    
    Returns:
    
    The document's documentURI.
  - baseURI
```
 String baseURI()
```
    Returns the document's baseURI. @mcp
    The baseURI is a property of Node, it's the absolute base URL of the document containing the node. A baseURI is used to resolve relative URLs.
    The base URL is determined as follows:
    By default, the base URL is the location of the document (as determined by window.location).
    If the document has an <base> element, its href attribute is used.
    Returns:
    
    The document's baseURI.
  - title
```
 String title()
```
    Returns the title of the current page. @mcp
  - referrer
```
 String referrer()
```
    The referrer property returns the URI of the page that linked to this page. @mcp
    The value is an empty string if the user navigated to the page directly (not through a link, but, for example, by using a bookmark).
    Inside an <iframe>, the referrer will initially be set to the same value as the href of the parent window's Window.location.
    
    Returns:
    
    The document's referrer.
  - chat
```
 ModelResponse chat(String prompt, String selector)
```
    Interact with an AI model using the context of the element selected by selector. @mcp
    The AI model receives the element's content and structure as context along with the provided prompt.
    
    Parameters:
    
    prompt - The question or instruction for the AI model.
    
    selector - The CSS selector of the element to use as context.
    
    Returns:
    
    A ModelResponse containing the model's answer.
  - evaluate
```
 <T extends Any> T evaluate(String expression, T defaultValue)
```
    Executes JavaScript and returns the result, or defaultValue if the result is null or incompatible. @mcp
    
    Parameters:
    
    expression - The JavaScript expression to evaluate.
    
    defaultValue - The value to return if evaluation fails or returns null.
    
    Returns:
    
    The evaluation result or defaultValue.
  - evaluateValue
```
 <T extends Any> T evaluateValue(String expression, T defaultValue)
```
    Executes JavaScript and returns the result as a JSON-serializable value, or defaultValue if null/incompatible. @mcp
    
    Parameters:
    
    expression - The JavaScript expression to evaluate.
    
    defaultValue - The value to return if evaluation fails or returns null.
    
    Returns:
    
    The evaluation result or defaultValue.
  - isVisible
```
 Boolean isVisible(String selector)
```
    Returns whether the element is visible. @mcp
    driver.isVisible("input[name='q']")
    Parameters:
    
    selector -
    The selector of the element to check.
    
    Returns:
    
    Whether the element is visible.
  - isChecked
```
 Boolean isChecked(String selector)
```
    Returns whether the element is checked. @mcp
    driver.isChecked("input[name='agree']")
    Parameters:
    
    selector -
    The selector of the element to check.
    
    Returns:
    
    Whether the element is checked.
  - scrollDown
```
 Double scrollDown(Integer count)
```
    The current page frame scrolls down for count times. @mcp
    driver.scrollDown(3)
    TODO: use mouseWheel instead
    Parameters:
    
    count - The times to scroll down.
  - scrollUp
```
 Double scrollUp(Integer count)
```
    The current page frame scrolls up for count times. @mcp
    driver.scrollUp(3)
    TODO: use mouseWheel instead
    Parameters:
    
    count - The times to scroll up.
  - scrollBy
```
 Double scrollBy(Double pixels, Boolean smooth)
```
    Scrolls the current page frame vertically by the given number of pixels. @mcp
    Positive values scroll down, negative values scroll up. The target position is clamped to the scrollable range 0, scrollHeight - viewportHeight.
    When smooth is true a deterministic, step‑wise scrolling algorithm is used (instead of relying on the browser's native smooth scrolling) for higher stability: it issues incremental window.scrollTo() calls and waits for the viewport to settle after each step. This reduces race conditions with lazy‑loaded content or async layout changes and yields more predictable final positions.
    Typical usage:
    // Scroll down 200px smoothly (default) driver.scrollBy() // Scroll up 500px immediately driver.scrollBy(-500.0, smooth = false) // Scroll down one viewport height, smooth val y = driver.scrollBy(driver.viewportHeight(), smooth = true)
    Parameters:
    
    pixels - The delta in pixels to scroll; positive scrolls down, negative scrolls up.
    
    smooth - Whether to perform a deterministic smooth scrolling sequence.
    
    Returns:
    
    The final vertical scroll offset (window.scrollY) after scrolling.
  - scrollToTop
```
 Double scrollToTop()
```
    The current page frame scrolls to the top. @mcp
    driver.scrollToTop()
  - scrollToBottom
```
 Double scrollToBottom()
```
    The current page frame scrolls to the bottom. @mcp
    driver.scrollToBottom()
  - scrollToMiddle
```
 Double scrollToMiddle(Double ratio)
```
    The current page frame scrolls to the middle. @mcp
    driver.scrollToMiddle(0.2) driver.scrollToMiddle(0.5) driver.scrollToMiddle(0.8)
    Parameters:
    
    ratio - The ratio of the page to scroll to, 0.0 means the top, 1.0 means the bottom.
  - scrollToViewport
```
 Double scrollToViewport(Double n, Boolean smooth)
```
    Scrolls to the position of the n-th viewport.
    
    Parameters:
    
    n - Viewport index (1 represents the first screen)
    
    smooth - Whether to use smooth scrolling
    
    Returns:
    
    Actual scrollY pixel value after scrolling
  - outerHTML
```
 String outerHTML()
```
    Returns the document's HTML markup. @mcp
    val html = driver.outerHTML()
    If the document does not exist, returns null.
    Returns:
    
    The HTML markup of the document.
  - outerHTML
```
 String outerHTML(String selector)
```
    Returns the node's HTML markup, the node is located by selector. @mcp
    If the node does not exist, returns null.
    val html = driver.outerHTML("h2.title")
    Parameters:
    
    selector - The selector to locate the node.
    
    Returns:
    
    The HTML markup of the node.
  - textContent
```
 String textContent(String selector)
```
    Returns the text content of the document or a specific element. @mcp
    If selector is null, returns the text content of the entire document (usually document.body.innerText). If selector is provided, returns the text content of the first matching element.
    If the document or element does not exist, returns null.
    val bodyText = driver.textContent() val titleText = driver.textContent("h1.title")
    Parameters:
    
    selector - The CSS selector of the element.
    
    Returns:
    
    The text content, or null if not found.
  - extract
```
 Map<String, String> extract(Map<String, String> fields)
```
    Extracts multiple fields from the page using CSS selectors. @mcp
    
    Parameters:
    
    fields - A map where keys are field names and values are CSS selectors.
    
    Returns:
    
    A map containing the extracted text content for each field. Values are null if the selector matches nothing.
  - selectFirstTextOrNull
```
 String selectFirstTextOrNull(String selector)
```
    Returns the node's text content, the node is located by selector. @mcp
    If the node does not exist, returns null.
    val text = driver.selectFirstTextOrNull("h2.title")
    Parameters:
    
    selector - The selector to locate the node.
    
    Returns:
    
    The text content of the node.
  - selectTextAll
```
 List<String> selectTextAll(String selector)
```
    Returns a list of text contents of all the elements matching the specified selector within the page. @mcp
    If no elements match the selector, returns an empty list.
    val texts = driver.selectTextAll("h2")
    Parameters:
    
    selector - The selector to locate the nodes.
    
    Returns:
    
    The text contents of the nodes.
  - selectFirstAttributeOrNull
```
 String selectFirstAttributeOrNull(String selector, String attrName)
```
    Returns the node's attribute value, the node is located by selector, the attribute is attrName. @mcp
    If the node does not exist, or the attribute does not exist, returns null.
    val classes = driver.selectFirstAttributeOrNull("h2.title", "class")
    Parameters:
    
    selector - The selector to locate the node.
    
    attrName - The attribute name to retrieve.
    
    Returns:
    
    The attribute value of the node.
  - selectAttributes
```
 Map<String, String> selectAttributes(String selector)
```
    Returns the node's attribute values, the node is located by selector. @mcp
    If the node do not exist, or the attribute does not exist, returns an empty list.
    val classes = driver.selectAttributes("h2.title", "class")
    Parameters:
    
    selector - The selector to locate the nodes.
    
    Returns:
    
    The attribute pairs of the nodes.
  - selectAttributeAll
```
 List<String> selectAttributeAll(String selector, String attrName, Integer start, Integer limit)
```
    Returns the nodes' attribute values, the nodes are located by selector, the attribute is attrName. @mcp
    If the nodes do not exist, or the attribute does not exist, returns an empty list.
    val classes = driver.selectAttributeAll("h2.title", "class")
    Parameters:
    
    selector - The selector to locate the nodes.
    
    attrName - The attribute name to retrieve.
    
    start - The offset of the first node to select.
    
    limit - The maximum number of nodes to select.
    
    Returns:
    
    The attribute values of the nodes.
  - setAttribute
```
 Unit setAttribute(String selector, String attrName, String attrValue)
```
    Set the attribute of an element located by selector. @mcp
    driver.setAttribute("h2.title", "class", "header")
    Parameters:
    
    selector - The CSS query to select an element.
    
    attrName - The attribute name to set.
    
    attrValue - The attribute value to set.
  - setAttributeAll
```
 Unit setAttributeAll(String selector, String attrName, String attrValue)
```
    Set the attribute of all elements matching the CSS query. @mcp
    driver.setAttributeAll("h2.title", "class", "header")
    Parameters:
    
    selector - The CSS query to select elements.
    
    attrName - The attribute name to set.
    
    attrValue - The attribute value to set.
  - selectFirstPropertyValueOrNull
```
 String selectFirstPropertyValueOrNull(String selector, String propName)
```
    Returns the node's property value, the node is located by selector, the property is propName. @mcp
    If the node does not exist, or the property does not exist, returns null.
    val classes = driver.selectFirstPropertyOrNull("input#input", "value")
    Parameters:
    
    selector - The selector to locate the node.
    
    propName - The property name to retrieve.
    
    Returns:
    
    The property value of the node.
  - selectPropertyValueAll
```
 List<String> selectPropertyValueAll(String selector, String propName, Integer start, Integer limit)
```
    Returns the nodes' property values, the nodes are located by selector, the property is propName. @mcp
    If the nodes do not exist, or the property does not exist, returns an empty list.
    val classes = driver.selectPropertyAll("input#input", "value")
    Parameters:
    
    selector - The selector to locate the nodes.
    
    propName - The property name to retrieve.
    
    start - The offset of the first node to select.
    
    limit - The maximum number of nodes to select.
    
    Returns:
    
    The property values of the nodes.
  - setProperty
```
 Unit setProperty(String selector, String propName, String propValue)
```
    Set the property of an element located by selector. @mcp
    driver.setProperty("input#input", "value")
    Parameters:
    
    selector - The CSS query to select an element.
    
    propName - The property name to set.
    
    propValue - The property value to set.
  - setPropertyAll
```
 Unit setPropertyAll(String selector, String propName, String propValue)
```
    Set the property of all elements matching the CSS query. @mcp
    driver.setPropertyAll("input#input", "value")
    Parameters:
    
    selector - The CSS query to select elements.
    
    propName - The property name to set.
    
    propValue - The property value to set.
  - selectHyperlinks
```
 List<Hyperlink> selectHyperlinks(String selector, Integer offset, Integer limit)
```
    Find hyperlinks in elements matching the selector. NOTE: Currently constructs absolute URLs by concatenating baseURI and raw href; TODO: robust resolution & abs: support.
    
    Parameters:
    
    selector - The CSS query to select elements.
    
    offset - The offset of the first element to select.
    
    limit - The maximum number of elements to select.
  - selectAnchors
```
 List<GeoAnchor> selectAnchors(String selector, Integer offset, Integer limit)
```
    Select anchors (link + coordinates) – placeholder implementation until util binding available.
    
    Parameters:
    
    selector - The CSS query to select elements.
    
    offset - The offset of the first element to select.
    
    limit - The maximum number of elements to select.
  - selectImages
```
 List<String> selectImages(String selector, Integer offset, Integer limit)
```
    Select image URLs (abs:src) – placeholder implementation.
    
    Parameters:
    
    selector - The CSS query to select elements.
    
    offset - The offset of the first element to select.
    
    limit - The maximum number of elements to select.
  - clickTextMatches
```
 Unit clickTextMatches(String selector, String pattern, Integer count)
```
    This method clicks an element with selector whose text content matches pattern, and then focuses it. @mcp
    If there's no element matching selector, or the element's text content doesn't match pattern, nothing to do.
    driver.clickTextMatches("button", "submit")
    TODO: use playwright style selector which supports text matching, for example: button:has-text("submit")
    Parameters:
    
    selector -
    A selector of an element to focus. If there are multiple elements satisfying the selector, the first will be focused.
    
    pattern - The pattern to match the text content.
    
    count - The number of times to click.
  - clickMatches
```
 Unit clickMatches(String selector, String attrName, String pattern, Integer count)
```
    This method clicks an element with selector whose attribute name is attrName and value matches pattern, and then focuses it. @mcp
    If there's no element matching selector, or the element has no attribute attrName, or the element's attribute value doesn't match pattern, nothing to do.
    driver.clickMatches("button", "type", "submit")
    Parameters:
    
    selector -
    A selector of an element to focus. If there are multiple elements satisfying the selector, the first will be focused.
    
    attrName - The attribute name to match.
    
    pattern - The pattern to match the attribute value.
    
    count - The number of times to click.
  - check
```
 Unit check(String selector)
```
    This method check an element with selector. If there's no element matching selector, nothing to do. @mcp
    Parameters:
    
    selector -
    A selector of an element to check. If there are multiple elements satisfying the selector, the first will be checked.
  - uncheck
```
 Unit uncheck(String selector)
```
    This method uncheck an element with selector. If there's no element matching selector, nothing to do. @mcp
    Parameters:
    
    selector -
    A selector of an element to uncheck. If there are multiple elements satisfying the selector, the first will be focused.
  - waitForSelector
```
 Duration waitForSelector(String selector)
```
    Wait until the element identified by the selector becomes present in the DOM or timeout. @mcp
    val remainingTime = driver.waitForSelector("h2.title")
    Parameters:
    
    selector - The selector of the element to wait for.
    
    Returns:
    
    The remaining time until timeout when the element becomes present.
  - waitForSelector
```
 Duration waitForSelector(String selector, SuspendFunction0<Unit> action)
```
    Wait for the element identified by the selector to become present in the DOM, or until timeout. @mcp
    This method periodically checks for the existence of the element. If the element is not found during a check, the action will be executed, such as scrolling the page down.
    val remainingTime = driver.waitForSelector("h2.title") { driver.scrollDown() }
    Parameters:
    
    action - The action to execute when the element is not found.
  - waitForNavigation
```
 Duration waitForNavigation(String oldUrl)
```
    Wait until the current url changes or timeout. @mcp
    val url = "https://www.example.com" driver.navigate(url) var remainingTime = driver.waitForNavigation() if (remainingTime 0) { driver.click("a[href='/next']") remainingTime = driver.waitForNavigation(url) }
  - waitForNavigation
```
 Duration waitForNavigation(String oldUrl, Duration timeout)
```
    Wait until the current url changes or timeout. @mcp
    val timeout = Duration.ofSeconds(30) val url = "https://www.example.com" driver.navigate(url) var remainingTime = driver.waitForNavigation(timeout) if (remainingTime 0) { driver.click("a[href='/next']") remainingTime = driver.waitForNavigation(url, timeout) }
    Parameters:
    
    timeout - The maximum time to wait for the url to change.
  - waitUntil
```
 Duration waitUntil(SuspendFunction0<Boolean> predicate)
```
    Wait until the predicate returns true. @mcp
    val remainingTime = driver.waitUntil { driver.exists("h2.title") }
    Parameters:
    
    predicate - The predicate to check.
    
    Returns:
    
    The remaining time until timeout when the predicate returns true.
  - waitUntil
```
 Duration waitUntil(Duration timeout, SuspendFunction0<Boolean> predicate)
```
    Wait until the predicate returns true. @mcp
    val remainingTime = driver.waitUntil(Duration.ofSeconds(10)) { driver.exists("h2.title") }
    Parameters:
    
    timeout - The maximum time to wait for the predicate to return true.
    
    predicate - The predicate to check.
    
    Returns:
    
    The remaining time until timeout when the predicate returns true.
  - randomDelayMillis
```
 final Long randomDelayMillis(String action, IntRange fallback)
```
    Generate a random delay in milliseconds for an action.
    
    Parameters:
    
    action - Named action bucket (fallbacks: specific -> default -> provided fallback range).
    
    fallback - Used if policy values are missing / invalid.
  - timeout
```
 final Duration timeout(String action, Duration fallback)
```
  - newJsoupSession
```
 Connection newJsoupSession()
```
    Create a new Jsoup session with the last page's context, which means, the same headers and cookies. @mcp
    
    Returns:
    
    The Jsoup session.
  - loadJsoupResource
```
 Connection.Response loadJsoupResource(String url)
```
    Load the url as a resource with Jsoup rather than browser rendering, with the last page's context. @mcp
    This means, the same headers and cookies.
    
    Parameters:
    
    url - The URL to load.
    
    Returns:
    
    The Jsoup response.
  - loadResource
```
 NetworkResourceResponse loadResource(String url)
```
    Load the url as a resource without browser rendering, with the last page's context. @mcp
    This means, the same headers and cookies.
    
    Parameters:
    
    url - The URL to load.
    
    Returns:
    
    The network resource response.
  - equals
```
 Boolean equals(Object other)
```
  - hashCode
```
 Integer hashCode()
```
  - compareTo
```
 Integer compareTo(AbstractWebDriver other)
```
  - toString
```
 String toString()
```
  - terminate
```
 Unit terminate()
```
  - awaitTermination
```
 Unit awaitTermination()
```
  - close
```
 Unit close()
```
  - checkState
```
 final Boolean checkState(String action)
```

Class AbstractWebDriver

Nested Class Summary

Field Summary

Constructor Summary

Enum Constant Summary

Method Summary

Methods inherited from class ai.platon.pulsar.skeleton.crawl.fetch.driver.WebDriver

Methods inherited from class java.lang.Object

Constructor Detail

AbstractWebDriver

Method Detail

getParentSid

getSettings

getResourceBlockProbability

getBlockedURLs

getProbabilisticBlockedURLs

isConnectable

getChatModel

getImplementation

getSnapshotService

getIdleTimeout

setIdleTimeout

getLastActiveTime

setLastActiveTime

isIdle

isActive

isInit

isReady

isWorking

isRetired

isQuit

isCanceled

isCrashed

getStatus

isMockedPageSource

isRecovered

setRecovered

isReused

setReused

isRecyclable

setRecyclable

getIgnoreDOMFeatures

setIgnoreDOMFeatures

getName

getNavigateEntry

setNavigateEntry

getNavigateHistory

getDelayPolicy

getTimeoutPolicy

getFrames

getOpener

setOpener

getOutgoingPages

getData

getMainRequestHeaders

getMainRequestCookies

getMainResponseStatus

getMainResponseStatusText

getMainResponseHeaders

getGuid

getBrowser

getId

free

startWork

retire

cancel

addInitScript

navigate

reload

currentUrl

url

documentURI

baseURI

title

referrer

chat

evaluate

evaluateValue

isVisible

isChecked