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 compatibility

Feature Chrome Edge Firefox Internet Explorer Opera Safari Servo
Basic Support 9 12 4.0 11 12 5.1 No support
Feature Android Chrome for Android Edge Mobile Firefox for Android IE Mobile Opera Mobile Safari Mobile
Basic Support (Yes) 25 (Yes) 4.0 11 12 8.1

See also

© 2005–2017 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