GPUDeviceLostInfo

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

注意:此功能在 Web Workers 中可用。

GPUDeviceLostInfo 接口是 WebGPU API 的一部分,当 GPUDevice.lost Promise 解析时返回的对象。它提供了设备丢失的原因信息。

有关“丢失”状态的更多信息,请参阅 GPUDevice.lost 页面。

实例属性

message 只读

一个字符串,提供一个人类可读的消息,解释设备丢失的原因。

reason 只读

一个枚举值,以机器可读的方式定义设备丢失的原因。

示例

js
async function init() {
  if (!navigator.gpu) {
    throw Error("WebGPU not supported.");
  }
  const adapter = await navigator.gpu.requestAdapter();
  if (!adapter) {
    throw Error("Couldn't request WebGPU adapter.");
  }

  // Create a GPUDevice
  let device = await adapter.requestDevice(descriptor);

  // Use lost to handle lost devices
  device.lost.then((info) => {
    console.error(`WebGPU device was lost: ${info.message}`);
    device = null;
    if (info.reason !== "destroyed") {
      init();
    }
  });
  // …
}

规范

规范
WebGPU
# gpudevicelostinfo

浏览器兼容性

另见