GPUDevice: pushErrorScope() Methode

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

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.

In diesem Artikel

Syntax

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.

Die WebGPU API

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden