TheWebGLRenderingContext.bindBuffer() method of theWebGL API binds a givenWebGLBuffer to a target.

Syntax

bindBuffer(target, buffer)

Parameters

target

AGLenum specifying the binding point (target). Possible values:

gl.ARRAY_BUFFER

Buffer containing vertex attributes, such asvertex coordinates, texture coordinate data, or vertex color data.

gl.ELEMENT_ARRAY_BUFFER

Buffer used for element indices.

When using aWebGL 2 context, the following values are available additionally:

gl.COPY_READ_BUFFER

Buffer for copying from one buffer object to another.

gl.COPY_WRITE_BUFFER

Buffer for copying from one buffer object to another.

gl.TRANSFORM_FEEDBACK_BUFFER

Buffer for transform feedback operations.

gl.UNIFORM_BUFFER

Buffer used for storing uniform blocks.

gl.PIXEL_PACK_BUFFER

Buffer used for pixel transfer operations.

gl.PIXEL_UNPACK_BUFFER

Buffer used for pixel transfer operations.

buffer

AWebGLBuffer to bind.

Return value

None (undefined).

Exceptions

Only one target can be bound to a givenWebGLBuffer. An attempt to bindthe buffer to another target will throw anINVALID_OPERATION error and thecurrent buffer binding will remain the same.

AWebGLBuffer which has been marked for deletion withdeleteBuffer cannot be(re-)bound. An attempt to do so will generate anINVALID_OPERATION error,and the current binding will remain untouched.

Examples

Binding a buffer to a target

const canvas = document.getElementById("canvas");const gl = canvas.getContext("webgl");const buffer = gl.createBuffer();gl.bindBuffer(gl.ARRAY_BUFFER, buffer);

Getting current bindings

To check the current buffer bindings, query theARRAY_BUFFER_BINDINGandELEMENT_ARRAY_BUFFER_BINDING constants.

gl.getParameter(gl.ARRAY_BUFFER_BINDING);gl.getParameter(gl.ELEMENT_ARRAY_BUFFER_BINDING);

Specifications

Browser compatibility

See also

• WebGLRenderingContext.createBuffer()
• WebGLRenderingContext.deleteBuffer()
• WebGLRenderingContext.isBuffer()
• Other buffers:WebGLFramebuffer,WebGLRenderbuffer