GPUPipelineError
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
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 erhalten wird, wenn ein von einem Promise zurückgegebenes Versprechen bei einem Aufruf von GPUDevice.createComputePipelineAsync() oder GPUDevice.createRenderPipelineAsync() abgelehnt wird.
Konstruktor
GPUPipelineError()-
Erstellt eine neue Instanz eines
GPUPipelineError-Objekts.
Instanz-Eigenschaften
Erbt Eigenschaften von seinem Elternteil, DOMException.
reasonSchreibgeschützt-
Ein enumerierter Wert, der den Grund definiert, warum die Pipeline-Erstellung in einer maschinenlesbaren Weise fehlgeschlagen ist.
Beispiele
Im folgenden Beispiel versuchen wir, eine GPUComputePipeline mithilfe von GPUDevice.createComputePipelineAsync() zu erstellen. Wir haben jedoch unseren Compute-Pipeline-entryPoint als "maijn" falsch geschrieben (es sollte "main" sein), daher schlägt die Pipeline-Erstellung fehl, und unser catch-Block druckt den resultierenden Grund und die Fehlermeldung in die Konsole aus.
// …
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
| Spezifikation |
|---|
| WebGPU # gpupipelineerror |