GPUDeviceLostInfo

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Das GPUDeviceLostInfo-Interface der WebGPU API repräsentiert das Objekt, das zurückgegeben wird, wenn das GPUDevice.lost Promise aufgelöst wird. Es liefert Informationen darüber, warum ein Gerät verloren gegangen ist.

Weitere Informationen über den "lost"-Zustand finden Sie auf der Seite GPUDevice.lost.

Instanzeigenschaften

message Schreibgeschützt

Ein String, der eine lesbare Nachricht liefert, die erklärt, warum das Gerät verloren ging.

reason Schreibgeschützt

Ein enumerierter Wert, der den Grund, warum das Gerät verloren ging, in maschinenlesbarer Form definiert.

Beispiele

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();
    }
  });
  // …
}

Spezifikationen

Specification
WebGPU
# gpudevicelostinfo

Browser-Kompatibilität

Siehe auch