W3cubDocs

/DOM

WebGLRenderingContext.getError

The WebGLRenderingContext.getError() method of the WebGL API returns error information.

Syntax

GLenum gl.getError();

Parameters

None.

Return value

Constant Description
gl.NO_ERROR No error has been recorded. The value of this constant is 0.
gl.INVALID_ENUM An unacceptable value has been specified for an enumerated argument. The command is ignored and the error flag is set.
gl.INVALID_VALUE A numeric argument is out of range. The command is ignored and the error flag is set.
gl.INVALID_OPERATION The specified command is not allowed for the current state. The command is ignored and the error flag is set.
gl.INVALID_FRAMEBUFFER_OPERATION The currently bound framebuffer is not framebuffer complete when trying to render to or to read from it.
gl.OUT_OF_MEMORY Not enough memory is left to execute the command.
gl.CONTEXT_LOST_WEBGL If the WebGL context is lost, this error is returned on the first call to getError. Afterwards and until the context has been restored, it returns gl.NO_ERROR.

Examples

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

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

Specifications

Specification Status Comment
WebGL 1.0
The definition of 'getError' in that specification.
Recommendation Initial definition.
OpenGL ES 2.0
The definition of 'glGetError' in that specification.
Standard Man page of the OpenGL API.

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support 9 12 4 11 12 5.1
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support Yes 25 Yes Yes 12 8.1 Yes

See also

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/getError