GPUOutOfMemoryError

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, bevor Sie diese produktiv verwenden.

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

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die GPUOutOfMemoryError-Schnittstelle der WebGPU API beschreibt einen Out-of-Memory-Fehler (oom), der darauf hinweist, dass nicht genügend freier Speicher vorhanden war, um die angeforderte Operation abzuschließen.

Sie repräsentiert eine der Fehlerarten, die durch GPUDevice.popErrorScope und das uncapturederror-Ereignis angezeigt werden.

Out-of-Memory-Fehler sollten in einer gut ausgeführten App relativ selten auftreten, sind aber weniger vorhersehbar als GPUValidationErrors. Dies liegt daran, dass sie von dem Gerät abhängen, auf dem Ihre App läuft, sowie von anderen Apps, die zu diesem Zeitpunkt GPU-Ressourcen nutzen.

GPUError GPUOutOfMemoryError

Konstruktor

GPUOutOfMemoryError() Experimentell

Erstellt eine neue Instanz eines GPUOutOfMemoryError-Objekts.

Instanz-Eigenschaften

Die message-Eigenschaft wird von ihrem übergeordneten Objekt, GPUError, geerbt:

message Experimentell Nur lesbar

Ein String, der eine lesbare Nachricht bereitstellt, die erklärt, warum der Fehler aufgetreten ist.

Beispiele

Das folgende Beispiel nutzt einen Fehlerbereich, um einen Out-of-Memory-Fehler zu erfassen und protokolliert ihn in der Konsole.

js
device.pushErrorScope("out-of-memory");

let buffer = device.createBuffer({
  size: 100_000_000_000, // 100GB; far too big
  usage: GPUBufferUsage.COPY_SRC | GPUBufferUsage.MAP_WRITE,
});

device.popErrorScope().then((error) => {
  if (error) {
    // error is a GPUOutOfMemoryError object instance
    buffer = null;
    console.error(`Out of memory, buffer too large. Error: ${error.message}`);
  }
});

Spezifikationen

Specification
WebGPU
# gpuoutofmemoryerror

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch