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 | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | 9 | 4.0 (2.0) | 11 | 12 | 5.1 |
| Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | ? | 25 | (Yes) | ? | 12 | 8.1 |