puppeteer/website/versioned_docs/version-15.3.1/api/puppeteer.frame.waitforxpath.md
release-please[bot] ec8c750383
chore(main): release 15.3.1 (#8635)
* chore(main): release 15.3.1

* chore: generate versioned docs

Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2022-07-06 09:24:46 +02:00

1.5 KiB

sidebar_label
Frame.waitForXPath

Frame.waitForXPath() method

Signature:

class Frame {
  waitForXPath(
    xpath: string,
    options?: WaitForSelectorOptions
  ): Promise<ElementHandle<Node> | null>;
}

Parameters

Parameter Type Description
xpath string the XPath expression to wait for.
options WaitForSelectorOptions (Optional) options to configure the visiblity of the element and how long to wait before timing out.

Returns:

Promise<ElementHandle<Node> | null>

Remarks

Wait for the xpath to appear in page. If at the moment of calling the method the xpath already exists, the method will return immediately. If the xpath doesn't appear after the timeout milliseconds of waiting, the function will throw.

For a code example, see the example for Frame.waitForSelector(). That function behaves identically other than taking a CSS selector rather than an XPath.