puppeteer/website/versioned_docs/version-21.2.1/api/puppeteer.elementhandle._x.md
release-please[bot] a25527a223
chore: release main (#10897)
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2023-09-13 12:29:09 +02:00

34 lines
1.1 KiB
Markdown

---
sidebar_label: ElementHandle.$x
---
# ElementHandle.$x() method
> Warning: This API is now obsolete.
>
> Use [ElementHandle.$$()](./puppeteer.elementhandle.__.md) with the `xpath` prefix.
>
> Example: `await elementHandle.$$('xpath/' + xpathExpression)`
>
> The method evaluates the XPath expression relative to the elementHandle. If `xpath` starts with `//` instead of `.//`, the dot will be appended automatically.
>
> If there are no such elements, the method will resolve to an empty array.
#### Signature:
```typescript
class ElementHandle {
$x(expression: string): Promise<Array<ElementHandle<Node>>>;
}
```
## Parameters
| Parameter | Type | Description |
| ---------- | ------ | -------------------------------------------------------------------------------------------- |
| expression | string | Expression to [evaluate](https://developer.mozilla.org/en-US/docs/Web/API/Document/evaluate) |
**Returns:**
Promise&lt;Array&lt;[ElementHandle](./puppeteer.elementhandle.md)&lt;Node&gt;&gt;&gt;