Skip to main content
Version: 23.10.1

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

范围

类型

描述

tagName

K

所需元素类型的标签名称。

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