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