GPUDevice: метод pushErrorScope()

Метод pushErrorScope() интерфейса GPUDevice помещает новый контекст ошибок GPU в стек контекстов ошибок устройства, позволяя захватывать ошибки определенного типа.

После завершения захвата ошибок вы можете завершить захват, вызвав GPUDevice.popErrorScope(). Это извлекает контекст из стека и возвращает Promise, который разрешается до объекта, описывающего первую пойманную ошибку в контексте, или null, если ошибки не было поймано.

filter

Перечисление, определяющее тип ошибки, которая будет поймана в данном контексте. Возможные значения:

"internal"

Контекст ошибки поймает GPUInternalError.

"out-of-memory"

Контекст ошибки поймает GPUOutOfMemoryError.

"validation"

Контекст ошибки поймает GPUValidationError.

Ничего (Undefined).

В следующем примере используется контекст ошибки для захвата предполагаемой ошибки валидации и ее вывода в консоль.

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}`);
  }
});

См. Рекомендации по обработке ошибок WebGPU для получения дополнительных примеров и информации.

• API WebGPU