GPUValidationError

Интерфейс GPUValidationError API WebGPU описывает ошибку приложения, указывающую, что операция не прошла проверки ограничений API WebGPU.

Он представляет собой один из типов ошибок, отображаемых GPUDevice.popErrorScope и событием uncapturederror.

Ошибки проверки возникают всякий раз, когда недействительные входные данные предоставляются вызову WebGPU. Они являются согласованными, предсказуемыми и не должны возникать при условии правильной структуры вашего приложения. Они будут возникать одинаково на всех устройствах, на которых выполняется ваш код, поэтому, после исправления всех ошибок, обнаруженных во время разработки, вам, скорее всего, не нужно будет наблюдать за ними напрямую. Исключением из этого правила является случай, когда вы используете предоставленные пользователем ресурсы, шейдеры и т. п., в этом случае наблюдение за ошибками проверки во время загрузки может оказаться полезным.

GPUValidationError() Экспериментальная

Создаёт новый экземпляр объекта GPUValidationError.

Свойство message унаследовано от родительского класса GPUError:

message Экспериментальная Только для чтения

Строка, предоставляющая понятное для человека сообщение, объясняющее причину возникновения ошибки.

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

device.pushErrorScope("validation");

let sampler = device.createSampler({
  maxAnisotropy: 0, // Invalid, maxAnisotropy must be at least 1.
});

device.popErrorScope().then((error) => {
  if (error) {
    // error is a GPUValidationError object instance
    sampler = null;
    console.error(`An error occurred while creating sampler: ${error.message}`);
  }
});

• API WebGPU
• Рекомендации по обработке ошибок WebGPU