WebGL2RenderingContext: invalidateFramebuffer() method

Baseline

Widely available

This feature is well established and works across many devices and browser versions. Its been available across browsers since September 2021.

Note: This feature is available in Web Workers.

The WebGL2RenderingContext.invalidateFramebuffer() method of the WebGL 2 API invalidates the contents of attachments in a framebuffer.

Syntax

invalidateFramebuffer(target, attachments)

A GLenum specifying the binding point (target). Possible values:

gl.FRAMEBUFFER: Collection buffer data storage of color, alpha, depth and stencil buffers used to render an image.
gl.DRAW_FRAMEBUFFER: Equivalent to gl.FRAMEBUFFER.
gl.READ_FRAMEBUFFER: Used as a source for reading operations.

An Array of GLenum specifying the attachment points to invalidate. Possible values:

gl.COLOR_ATTACHMENT{0-15}: Invalidates one of the framebuffer's color buffers.
gl.DEPTH_ATTACHMENT: Invalidates the framebuffer's depth buffer.
gl.STENCIL_ATTACHMENT: Invalidates the framebuffer's stencil buffer.
gl.DEPTH_STENCIL_ATTACHMENT: Invalidates both the framebuffer's depth and stencil buffer.

gl.invalidateFramebuffer(gl.READ_FRAMEBUFFER, [
  gl.COLOR_ATTACHMENT0,
  gl.COLOR_ATTACHMENT1,
]);

Specification
WebGL 2.0 Specification # 4.7.4

Was this page helpful to you?

Yes No

This page was last modified on Jun 23, 2025 by MDN contributors.