GPUPipelineError: GPUPipelineError() constructor
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The GPUPipelineError()
constructor creates a new
GPUPipelineError
object instance.
Syntax
new GPUPipelineError(message, options)
Parameters
message
Optional-
A string providing a human-readable message that explains why the error occurred. If not specified,
message
defaults to an empty string (""
). options
-
An object, which can contain the following properties:
reason
-
An enumerated value that defines the reason the pipeline creation failed in a machine-readable way. The value can be one of:
"internal"
: Pipeline creation failed because of an internal error (seeGPUInternalError
for more information about these kinds of error)."validation"
: Pipeline creation failed because of a validation error (seeGPUValidationError
for more information about these kinds of error).
Examples
A developer would not manually use the constructor to create a GPUPipelineError
object. The user agent uses this constructor to create an appropriate object when a Promise
returned by a GPUDevice.createComputePipelineAsync()
or GPUDevice.createRenderPipelineAsync()
call rejects, signalling a pipeline failure.
See the main GPUPipelineError
page for an example involving a GPUPipelineError
object instance.
Specifications
Specification |
---|
WebGPU # dom-gpupipelineerror-constructor |
Browser compatibility
BCD tables only load in the browser