WebGL2RenderingContext: clientWaitSync() 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 inWeb Workers.
TheWebGL2RenderingContext.clientWaitSync() method of theWebGL 2 API blocks and waits for aWebGLSync object to become signaled or a given timeout to be passed.
In this article
Syntax
js
clientWaitSync(sync, flags, timeout)Parameters
syncA
WebGLSyncobject on which to wait on.flagsA
GLbitfieldspecifying a bitwise combination of flags controllingthe flushing behavior. May begl.SYNC_FLUSH_COMMANDS_BIT.timeoutA
GLint64specifying a timeout (in nanoseconds) for which to wait forthe sync object to become signaled. Must not be larger thangl.MAX_CLIENT_WAIT_TIMEOUT_WEBGL.
Return value
AGLenum indicating the sync object's status.
gl.ALREADY_SIGNALED: Indicates that the sync object was signaled whenthis method was called.gl.TIMEOUT_EXPIRED: Indicates that thetimeouttime passedand that the sync object did not become signaled.gl.CONDITION_SATISFIED: Indicates that the sync object was signaledbefore thetimeoutexpired.gl.WAIT_FAILED: Indicates that an error occurred during the execution.
Examples
js
const sync = gl.fenceSync(gl.SYNC_GPU_COMMANDS_COMPLETE, 0);const status = gl.clientWaitSync(sync, 0, 0);Specifications
| Specification |
|---|
| WebGL 2.0 Specification> # 3.7.14> |