跳至主要內容
版本：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');