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 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.

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 Schreibgeschützt

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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
GPUOutOfMemoryError
Experimental
GPUOutOfMemoryError() constructor
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.
User must explicitly enable this feature.
Has more compatibility info.

Siehe auch