DieGPUInternalError-Schnittstelle derWebGPU 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 vonGPUDevice.popErrorScope und demuncapturederror-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 denunterstü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.

Konstruktor

GPUInternalError()

Erstellt eine neueGPUInternalError Objektinstanz.

Instanz-Eigenschaften

Diemessage-Eigenschaft wird von ihrem ElternteilGPUError geerbt:

messageExperimentellSchreibgeschü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.

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

Browser-Kompatibilität

Siehe auch

• DieWebGPU API
• Beste Praktiken für die Fehlerbehandlung in WebGPU