GPUDevice: pushErrorScope() Methode

Limited availability

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

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die pushErrorScope() Methode der GPUDevice Schnittstelle fügt einen neuen GPU-Fehlerbereich zum Fehlerbereich-Stack des Geräts hinzu, was es Ihnen ermöglicht, Fehler eines bestimmten Typs zu erfassen.

Sobald Sie mit der Erfassung von Fehlern fertig sind, können Sie die Erfassung durch Aufrufen von GPUDevice.popErrorScope() beenden. Dies entfernt den Bereich vom Stack und gibt ein Promise zurück, das zu einem Objekt aufgelöst wird, das den ersten im Bereich erfassten Fehler beschreibt, oder null, wenn keine Fehler erfasst wurden.

Syntax

js
pushErrorScope(filter)

Parameter

filter

Ein enumerierter Wert, der angibt, welcher Fehlertyp in diesem speziellen Fehlerbereich erfasst wird. Mögliche Werte sind:

"internal"

Der Fehlerbereich erfasst einen GPUInternalError.

"out-of-memory"

Der Fehlerbereich erfasst einen GPUOutOfMemoryError.

"validation"

Der Fehlerbereich erfasst einen GPUValidationError.

Rückgabewert

Keiner (Undefined).

Beispiele

Das folgende Beispiel verwendet einen Fehlerbereich, um einen vermuteten Validierungsfehler zu erfassen und ihn in der Konsole zu protokollieren.

js
device.pushErrorScope("validation");

let sampler = device.createSampler({
  maxAnisotropy: 0, // Invalid, maxAnisotropy must be at least 1.
});

device.popErrorScope().then((error) => {
  if (error) {
    sampler = null;
    console.error(`An error occurred while creating sampler: ${error.message}`);
  }
});

Sehen Sie sich die WebGPU-Fehlerbehandlung Best Practices für viele weitere Beispiele und Informationen an.

Spezifikationen

Specification
WebGPU
# dom-gpudevice-pusherrorscope

Browser-Kompatibilität

Siehe auch