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

Siehe die Seite GPUDevice.lost für weitere Informationen über den "verlorenen" Zustand.

Instanz-Eigenschaften

message Schreibgeschützt

Ein String, der eine für Menschen lesbare Nachricht bereitstellt, 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 Weise 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