puppeteer/docs/api/puppeteer.elementhandle.toelement.md
dependabot[bot] 93e9acc410
chore(deps-dev): Bump the dev-dependencies group with 3 updates (#12101)
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Nikolay Vitkov <nvitkov@chromium.org>
2024-03-20 15:03:14 +00:00

1.0 KiB

sidebar_label
ElementHandle.toElement

ElementHandle.toElement() method

Converts the current handle to the given element type.

Signature:

class ElementHandle {
  toElement<K extends keyof HTMLElementTagNameMap | keyof SVGElementTagNameMap>(
    tagName: K
  ): Promise<HandleFor<ElementFor<K>>>;
}

Parameters

Parameter

Type

Description

tagName

K

The tag name of the desired element type.

**Returns:**

Promise<HandleFor<ElementFor<K>>>

Exceptions

An error if the handle does not match. The handle will not be automatically disposed.

Example

const element: ElementHandle<Element> = await page.$('.class-name-of-anchor');
// DO NOT DISPOSE `element`, this will be always be the same handle.
const anchor: ElementHandle<HTMLAnchorElement> = await element.toElement('a');