GPUPipelineError: GPUPipelineError()-Konstruktor

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

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

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Der GPUPipelineError()-Konstruktor erstellt eine neue Instanz des GPUPipelineError-Objekts.

Syntax

js
new GPUPipelineError(message, options)

Parameter

message Optional

Ein String, der eine menschenlesbare Nachricht bereitstellt, die erklärt, warum der Fehler aufgetreten ist. Wenn nicht angegeben, ist der Standardwert von message ein leerer String ("").

options

Ein Objekt, das die folgenden Eigenschaften enthalten kann:

reason

Ein enumerierter Wert, der den Grund für das Fehlschlagen der Pipeline-Erstellung in einer maschinenlesbaren Weise definiert. Der Wert kann einer der folgenden sein:

  • "internal": Die Pipeline-Erstellung ist aufgrund eines internen Fehlers fehlgeschlagen (siehe GPUInternalError für weitere Informationen über diese Art von Fehler).
  • "validation": Die Pipeline-Erstellung ist aufgrund eines Validierungsfehlers fehlgeschlagen (siehe GPUValidationError für weitere Informationen über diese Art von Fehler).

Beispiele

Ein Entwickler würde den Konstruktor nicht manuell verwenden, um ein GPUPipelineError-Objekt zu erstellen. Der Benutzeragent verwendet diesen Konstruktor, um ein geeignetes Objekt zu erstellen, wenn ein Promise zurückgegeben wird, indem ein Aufruf von GPUDevice.createComputePipelineAsync() oder GPUDevice.createRenderPipelineAsync() abgelehnt wird, was auf einen Pipeline-Fehler hinweist.

Siehe die Hauptseite GPUPipelineError für ein Beispiel mit einer GPUPipelineError-Objektinstanz.

Spezifikationen

Specification
WebGPU
# dom-gpupipelineerror-constructor

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch