Skip to main content
Version: 20.8.0

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​

ParameterTypeDescription
tagNameKThe 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');