跳到主要内容
版本：23.11.1

ElementHandle.toElement() 方法

将当前句柄转换为给定的元素类型。

签名​

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

参数​

参数

类型

描述

tagName

K

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

返回

Promise<HandleFor<ElementFor<K>>>

异常​

如果句柄不匹配，则会报错。该句柄不会自动释放。

示例​

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