WebWorker.evaluate() メソッド

ワーカーで渡された関数を評価します。

シグネチャ:

class WebWorker {
  evaluate<
    Params extends unknown[],
    Func extends EvaluateFunc<Params> = EvaluateFunc<Params>,
  >(func: Func | string, ...args: Params): Promise<Awaited<ReturnType<Func>>>;
}

パラメータ

パラメータ	型	説明
func	Func | 文字列	評価される関数です。
args	Params	func に渡す引数です。

戻り値

Promise<Awaited<ReturnType<Func>>>

func の結果です。

備考

渡された関数が promise を返す場合、evaluate はその promise が解決されるまで待機します。

目安として、渡された関数の戻り値が JSON オブジェクト (例: ほとんどのクラス) より複雑な場合、evaluate は _おそらく_ ある程度の切り詰められた値 (または {}) を返します。これは、実際の戻り値ではなく、プロトコルを介して Puppeteer に戻り値を送信した結果であるシリアル化されたバージョンを返しているためです。

一般的に、evaluateHandle を使用するのは、evaluate が返り値を適切にシリアル化できない場合か、返り値オブジェクトに対する変更可能なハンドルが必要な場合です。