GPUPipelineError

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 vor der Verwendung auf produktiven Webseiten.

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 GPUPipelineError-Schnittstelle der WebGPU API beschreibt einen Pipeline-Fehler. Dies ist der Wert, der empfangen wird, wenn ein Promise zurückgegeben durch einen Aufruf von GPUDevice.createComputePipelineAsync() oder GPUDevice.createRenderPipelineAsync() abgelehnt wird.

DOMException GPUPipelineError

Konstruktor

GPUPipelineError()

Erstellt eine neue GPUPipelineError-Objektinstanz.

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, DOMException.

reason Schreibgeschützt

Ein enumerierter Wert, der den Grund beschreibt, warum die Pipelinenerstellung fehlschlug, und zwar in einer für Maschinen lesbaren Weise.

Beispiele

Im folgenden Codeausschnitt versuchen wir, einen GPUComputePipeline mit GPUDevice.createComputePipelineAsync() zu erstellen. Allerdings haben wir unseren Compute-Pipeline-entryPoint als "maijn" falsch geschrieben (es sollte "main" sein), daher schlägt die Pipelinenerstellung fehl und unser catch-Block gibt den resultierenden Grund und die Fehlermeldung in der Konsole aus.

js
// …

let computePipeline;

try {
  computePipeline = await device.createComputePipelineAsync({
    layout: device.createPipelineLayout({
      bindGroupLayouts: [bindGroupLayout],
    }),
    compute: {
      module: shaderModule,
      entryPoint: "maijn",
    },
  });
} catch (error) {
  // error is a GPUPipelineError object instance
  console.error(error.reason);
  console.error(`Pipeline creation failed: ${error.message}`);
}

// …

In diesem Fall ist der gegebene reason "Validation" und die message lautet "Entry point "maijn" doesn't exist in the shader module [ShaderModule]."

Spezifikationen

Specification
WebGPU
# gpupipelineerror

Browser-Kompatibilität

Siehe auch