TheWebGLQuery interface is part of theWebGL 2 API and provides ways to asynchronously query for information. By default, occlusion queries and primitive queries are available.

Another kind of queries are disjoint timer queries, which allow you to measure performance and profiling of your GPU. Disjoint timer queries are available with theEXT_disjoint_timer_query extension only.

When working withWebGLQuery objects, the following methods of theWebGL2RenderingContext are useful:

• WebGL2RenderingContext.createQuery()
• WebGL2RenderingContext.deleteQuery()
• WebGL2RenderingContext.isQuery()
• WebGL2RenderingContext.beginQuery()
• WebGL2RenderingContext.endQuery()
• WebGL2RenderingContext.getQuery()
• WebGL2RenderingContext.getQueryParameter()

Examples

Creating aWebGLQuery object

in this example,gl must be aWebGL2RenderingContext.WebGLQuery objects are not available in WebGL 1.

const query = gl.createQuery();

Specifications

Browser compatibility

See also

• EXT_disjoint_timer_query