База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

cancelAnimationFrame — отменяне на чакащо извикване

cancelAnimationFrame(handle) премахва чакащо извикване, регистрирано с requestAnimationFrame(). Използвайте върнатия идентификатор в същия контекст; методът не прекъсва код, който вече се изпълнява.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

window.cancelAnimationFrame(handle);

cancelAnimationFrame(handle) отменя едно чакащо извикване, регистрирано с requestAnimationFrame(). Подайте върнатия идентификатор handle, а не функцията за извикване, и използвайте същия обект, който предоставя API. Методът връща undefined.

Идентификатор, който вече не е сред чакащите извиквания, не променя нищо. Отмяната не прекъсва извикване, което вече е започнало, и не отменя ефектите му. В цикъл, който планира следващи кадри, запазвайте най-новия идентификатор и отменяйте именно него; по-ранен идентификатор не представлява цялата анимация.

Това е Web API от HTML Living Standard, а не функция на ECMAScript. Поддържа се от актуалните браузърни енджини за Window. Стандартът го предвижда и в поддържани контексти DedicatedWorkerGlobalScope; неподдържан контекст предизвиква NotSupportedError. Версията на Node, използвана в дадено хранилище, не потвърждава наличието на този API.

Примерът отменя първото извикване, след което проверява брояча във второ извикване. Очакваният изход е calls: 0 и result: undefined. Проверката се извършва едва когато браузърът изпълни второто извикване.

Примери

(() => {
  let calls = 0;
  const handle = window.requestAnimationFrame(() => {
    calls += 1;
  });

  const result = window.cancelAnimationFrame(handle);

  window.requestAnimationFrame(() => {
    console.log(`calls: ${calls}`);
    console.log(`result: ${result}`);
  });
})();

Резултат

calls: 0
result: undefined

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници