GPUDevice: popErrorScope() 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 popErrorScope() Methode der GPUDevice Schnittstelle entfernt einen bestehenden GPU-Fehlerbereich aus dem Fehlerbereichs-Stack (ursprünglich mit GPUDevice.pushErrorScope() hinzugefügt) und gibt ein Promise zurück, das zu einem Objekt aufgelöst wird, das den ersten im Bereich erfassten Fehler beschreibt, oder null, wenn kein Fehler aufgetreten ist.

Syntax

js
popErrorScope()

Parameter

Keine.

Rückgabewert

Ein Promise, das zu einem Objekt aufgelöst wird, das den ersten im Bereich erfassten Fehler beschreibt. Dieser kann vom Typ sein:

Falls kein Fehler aufgetreten ist, wird es zu null aufgelöst.

Beispiele

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

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}`);
  }
});

Weitere Beispiele und Informationen finden Sie in den WebGPU Error Handling best practices.

Spezifikationen

Specification
WebGPU
# dom-gpudevice-poperrorscope

Browser-Kompatibilität

Siehe auch