GPUUncapturedErrorEvent

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

WebGPU API の GPUUncapturedErrorEvent インターフェイスは、GPUDevice の uncapturederror イベント用のイベントオブジェクト型で、テレメトリーや予期せぬエラーの報告に使用されます。

エラーが発生する可能性を把握している場合は、pushErrorScope() および popErrorScope() を用いて処理をするべきです。

Event GPUUncapturedErrorEvent

コンストラクター

GPUUncapturedErrorEvent()

新しい GPUUncapturedErrorEvent オブジェクトのインスタンスを生成します。

インスタンスプロパティ

親の Event からプロパティを継承します。

error 読取専用

エラーの詳細へのアクセスを提供する GPUError オブジェクトのインスタンスです。

例

エラースコープで処理されなかったエラーをすべて拾ってキャプチャするグローバルな仕組みとして、以下のようなコードを使用できます。

js
// ...

device.addEventListener("uncapturederror", (event) => {
  // エラーを再浮上させる
  console.error("A WebGPU error was not captured:", event.error.message);
  reportErrorToServer({
    type: event.error.constructor.name,
    message: event.error.message,
  });
});

// ...

仕様書

Specification
WebGPU
# gpuuncapturederrorevent

ブラウザーの互換性

BCD tables only load in the browser

関連情報