requestAnimationFrame method

int requestAnimationFrame(
  1. FrameRequestCallback callback
)

The requestAnimationFrame() method of the DedicatedWorkerGlobalScope interface tells the browser you wish to perform an animation frame request and call a user-supplied callback function before the next repaint.

The frequency of calls to the callback function will generally match the display refresh rate. The most common refresh rate is 60 Hz, (60 cycles/frames per second), though 75 Hz, 120 Hz, and 144 Hz are also widely used. requestAnimationFrame() calls are paused in most browsers when running in background tabs or hidden iframes, to improve performance and battery life.

A call to the requestAnimationFrame() method schedules only one single call to the callback function. If you want to animate another frame, your callback function must call requestAnimationFrame() again.

Warning: Be sure always to use the first argument (or some other method for getting the current time) to calculate how much the animation will progress in a frame — otherwise, the animation will run faster on high refresh-rate screens. For ways to do that, see the examples below.

Calling the requestAnimationFrame() method requires the current worker to have an associated owner Window. That means that the current worker must be created by Window or by a dedicated worker that also has an associated owner Window.

Implementation

external int requestAnimationFrame(FrameRequestCallback callback);