WebGLRenderingContext: getError()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

Die WebGLRenderingContext.getError()-Methode der WebGL API gibt Fehlerinformationen zurück.

Syntax

js
getError()

Parameter

Keine.

Rückgabewert

Konstante Beschreibung
gl.NO_ERROR Es wurde kein Fehler aufgezeichnet. Der Wert dieser Konstante ist 0.
gl.INVALID_ENUM Ein unzulässiger Wert wurde für ein enumeriertes Argument angegeben. Der Befehl wird ignoriert und das Fehler-Flag wird gesetzt.
gl.INVALID_VALUE Ein numerisches Argument liegt außerhalb des zulässigen Bereichs. Der Befehl wird ignoriert und das Fehler-Flag wird gesetzt.
gl.INVALID_OPERATION Der angegebene Befehl ist im aktuellen Zustand nicht zulässig. Der Befehl wird ignoriert und das Fehler-Flag wird gesetzt.
gl.INVALID_FRAMEBUFFER_OPERATION Der aktuell gebundene Framebuffer ist nicht vollständig, wenn versucht wird, darauf zu rendern oder davon zu lesen.
gl.OUT_OF_MEMORY Nicht genügend Speicher ist vorhanden, um den Befehl auszuführen.
gl.CONTEXT_LOST_WEBGL Wenn der WebGL-Kontext verloren geht, wird dieser Fehler beim ersten Aufruf von getError zurückgegeben. Danach und bis der Kontext wiederhergestellt ist, wird gl.NO_ERROR zurückgegeben.

Beispiele

js
gl.getError(); // gl.NO_ERROR (0)

gl.enable(gl.FOOBAR);
gl.getError(); // gl.INVALID_ENUM;

Spezifikationen

Specification
WebGL Specification
# 5.14.3

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch