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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
getError

Legend

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

Full support
Full support

Siehe auch