GPUDevice: pushErrorScope() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("WebGPU API")}}{{SecureContext_Header}}{{AvailableInWorkers}}
The **pushErrorScope()** method of the {{domxref("GPUDevice")}} interface pushes a new GPU error scope onto the device's error scope stack, allowing you to capture errors of a particular type.
Once you are done capturing errors, you can end capture by invoking {{domxref("GPUDevice.popErrorScope()")}}. This pops the scope from the stack and returns a {{jsxref("Promise")}} that resolves to an object describing the first error captured in the scope, or null if no errors were captured.
Syntax
pushErrorScope(filter)Parameters
filter- : An enumerated value that specifies what type of error will be caught in this particular error scope. Possible values are:
"internal"- : The error scope will catch a {{domxref("GPUInternalError")}}.
"out-of-memory"- : The error scope will catch a {{domxref("GPUOutOfMemoryError")}}.
"validation"- : The error scope will catch a {{domxref("GPUValidationError")}}.
Return value
None ({{jsxref("undefined")}}).
Examples
The following example uses an error scope to capture a suspected validation error, logging it to the console.
device.pushErrorScope("validation");
let sampler = device.createSampler({
maxAnisotropy: 0, // Invalid, maxAnisotropy must be at least 1.
});
device.popErrorScope().then((error) => {
if (error) {
sampler = null;
console.error(`An error occurred while creating sampler: ${error.message}`);
}
});See WebGPU Error Handling best practices for a lot more examples and information.
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- The WebGPU API