Frame.$eval() メソッド

指定されたセレクタに一致する最初の要素に対して、指定された関数をフレーム上で実行します。

指定された関数がPromiseを返す場合、このメソッドはPromiseが解決されるまで待ちます。

シグネチャ:

class Frame {
  $eval<
    Selector extends string,
    Params extends unknown[],
    Func extends EvaluateFuncWith<NodeFor<Selector>, Params> = EvaluateFuncWith<
      NodeFor<Selector>,
      Params
    >,
  >(
    selector: Selector,
    pageFunction: string | Func,
    ...args: Params
  ): Promise<Awaited<ReturnType<Func>>>;
}

パラメータ

パラメータ	型	説明
selector	セレクタ	クエリ対象のセレクタ。
pageFunction	string | Func	フレームのコンテキストで評価される関数。セレクタに一致する最初の要素が、関数の最初の引数として渡されます。
args	Params	pageFunctionに渡す追加の引数。

戻り値

Promise<Awaited<ReturnType<Func>>>

関数の結果へのPromise。

例

const searchValue = await frame.$eval('#search', el => el.value);