GPUInternalError

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 GPUInternalError-Schnittstelle der WebGPU API beschreibt einen Anwendungsfehler, der darauf hinweist, dass eine Operation aus einem system- oder implementationsspezifischen Grund fehlgeschlagen ist, selbst wenn alle Validierungsanforderungen erfüllt waren.

Sie repräsentiert einen der Fehlertypen, die von GPUDevice.popErrorScope und dem uncapturederror-Ereignis aufgetreten sind.

Interne Fehler treten auf, wenn in der WebGPU-Implementierung etwas passiert ist, das nicht durch die Validierung erfasst wurde und nicht eindeutig als ein "Out-of-Memory"-Fehler identifiziert werden konnte. Es bedeutet allgemein, dass eine von Ihrem Code ausgeführte Operation ein Systemlimit erreicht hat, das schwer auszudrücken war mit den unterstützten Limits von WebGPU. Dieselbe Operation könnte auf einem anderen Gerät erfolgreich sein. Diese Fehler können nur bei der Erstellung der Pipeline auftreten, normalerweise wenn der Shader für das Gerät zu komplex ist.

GPUError GPUInternalError

Konstruktor

GPUInternalError()

Erstellt eine neue GPUInternalError Objektinstanz.

Instanz-Eigenschaften

Die message-Eigenschaft wird von ihrem Elternteil GPUError geerbt:

message Experimentell Schreibgeschützt

Ein String, der eine menschenlesbare Nachricht bereitstellt, die erklärt, warum der Fehler aufgetreten ist.

Beispiele

Das folgende Beispiel verwendet einen Fehlerbereich, um einen vermuteten Validierungsfehler zu erfassen und diesen im Konsolenprotokoll auszugeben.

js
device.pushErrorScope("internal");

let module = device.createShaderModule({
  code: shader, // REALLY complex shader
});

device.popErrorScope().then((error) => {
  if (error) {
    // error is a GPUInternalError object instance
    module = null;
    console.error(`An error occurred while creating shader: ${error.message}`);
  }
});

Spezifikationen

Specification
WebGPU
# gpuinternalerror

Browser-Kompatibilität

Siehe auch