WebGLRenderingContext.getShaderInfoLog

The WebGLRenderingContext.getShaderInfoLog returns the information log for the specified WebGLShader object. It contains warnings, debugging and compile information.

Syntax

gl.getShaderInfoLog(shader);

Parameters

shader

A WebGLShader to query.

Return value

A DOMString that contains diagnostic messages, warning messages, and other information about the last compile operation. When a WebGLShader object is initially created, its information log will be a string of length 0.

Examples

Checking compilation errors

/* load shader source code. */
gl.shaderSource(shader, shaderCode);

/* compile shader source code. */
gl.compileShader(shader);

var error = gl.getShaderInfoLog(shader);

if (error.length > 0) {
  throw error;
}

Specifications

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

Browser compatibility

See also

• WebGLRenderingContext.getShaderParameter() – used with gl.COMPILE_STATUS to check for a failed compile.
• WebGLRenderingContext.getError()