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

瀏覽器相容性

另見