GPUDeviceLostInfo

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

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 der GPUDevice.lost Promise aufgelöst wird. Dies liefert Informationen darüber, warum ein Gerät verloren gegangen ist.

Weitere Informationen über den "verlorenen" Status finden Sie auf der Seite GPUDevice.lost.

Instanz-Eigenschaften

message Schreibgeschützt

Ein String, der eine menschenlesbare Nachricht bereitstellt, die erklärt, warum das Gerät verloren gegangen ist.

reason Schreibgeschützt

Ein enumerierter Wert, der den Grund angibt, warum das Gerät in maschinenlesbarer Form verloren gegangen ist.

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

BCD tables only load in the browser

Siehe auch