Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

requestAnimationFrame — aktualizacje przed renderowaniem

requestAnimationFrame zleca jednorazowe wywołanie funkcji podczas aktualizacji renderowania. Pozwala animować na podstawie czasu, zamiast zakładać stałą liczbę klatek na sekundę.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

const handle = window.requestAnimationFrame((timestamp) => { /* update visual state */ });
window.cancelAnimationFrame(handle);

window.requestAnimationFrame(callback) rejestruje jednorazową funkcję zwrotną wykonywaną w ramach aktualizacji renderowania, przed prezentacją obrazu. Zwraca liczbowy uchwyt żądania, a nie wynik funkcji. Kolejną klatkę trzeba zamówić ponownie; window.cancelAnimationFrame(handle) usuwa oczekujące wywołanie.

Argument timestamp to znacznik czasu o wysokiej rozdzielczości, wyrażony w milisekundach względem początku pomiaru czasu danego środowiska, a nie data kalendarzowa ani czas trwania klatki. Obliczaj upływ czasu przez odejmowanie znaczników. Funkcje wywołane w tej samej partii dla tego samego celu otrzymują ten sam znacznik.

Nie zakładaj 60 klatek na sekundę ani stałego opóźnienia. Częstotliwość zależy od możliwości renderowania; niewidoczne dokumenty mogą nie otrzymywać aktualizacji. Utrzymuj funkcję krótką, ponieważ długa praca opóźnia renderowanie. Przyrost pozycji zależny od czasu zapobiega uzależnieniu prędkości od liczby klatek.

To API standardu HTML, nie funkcja konkretnej edycji ECMAScript. Jest obsługiwane w bieżących silnikach przeglądarek dla Window; sama obecność Node 24 w repozytorium nie potwierdza obsługi. Przykład wymaga widocznej strony z istniejącym document.body. Animuje punkt, a w ostatnim wywołaniu funkcji zwrotnej ustawia jego przesunięcie na 100 pikseli, wypisuje w konsoli done: 100px i usuwa punkt, zanim przeglądarka zdąży go wyświetlić w tej pozycji. Planowany czas ruchu to 1000 ms, ale rzeczywiste zakończenie może nastąpić później.

Przykłady

(() => {
  const dot = document.createElement('div');
  dot.textContent = '●';
  document.body.append(dot);
  let start;

  function frame(timestamp) {
    if (start === undefined) start = timestamp;
    const progress = Math.min((timestamp - start) / 1000, 1);
    dot.style.transform = `translateX(${100 * progress}px)`;

    if (progress < 1) {
      window.requestAnimationFrame(frame);
    } else {
      console.log('done: 100px');
      dot.remove();
    }
  }

  window.requestAnimationFrame(frame);
})();

Wynik

done: 100px

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła