WebGL2RenderingContext: getQuery() method

Baseline Widely available

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

Note: This feature is available in Web Workers.

The WebGL2RenderingContext.getQuery() method of the WebGL 2 API returns the currently active WebGLQuery for the target, or null.

Syntax

js
getQuery(target, pname)

Parameters

target

A GLenum specifying the target of the query. Possible values:

gl.ANY_SAMPLES_PASSED

Specifies an occlusion query: these queries detect whether an object is visible (whether the scoped drawing commands pass the depth test and if so, how many samples pass).

gl.ANY_SAMPLES_PASSED_CONSERVATIVE

Same as above, but less accurate and faster version.

gl.TRANSFORM_FEEDBACK_PRIMITIVES_WRITTEN

Number of primitives that are written to transform feedback buffers.

pname

A GLenum specifying the query object target. Must be gl.CURRENT_QUERY.

Return value

A WebGLQuery object.

Examples

js
const currentQuery = gl.getQuery(gl.ANY_SAMPLES_PASSED, gl.CURRENT_QUERY);

Specifications

Specification
WebGL 2.0 Specification
# 3.7.12

Browser compatibility

BCD tables only load in the browser

See also