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

CKTIS / JavaScript

Animation.pause() — поставяне на анимация на пауза

Animation.pause() спира възпроизвеждането на анимация, без да я отменя. Операцията може да е в очакване; чрез animation.ready можете да изчакате завършването ѝ.

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

Синтаксис

animation.pause();

animation.pause() не приема аргументи и връща undefined, а не promise. Тя спира напредването на времето на анимацията; play() възобновява възпроизвеждането, а cancel() отменя анимацията.

Поставянето на пауза може да изисква синхронизация. Използвайте await animation.ready, а не await animation.pause(). Самото наблюдение на playState === 'paused' не доказва, че операцията е завършила: pending все още може да е true.

Това е браузърен API на Web Animations, а не функция на ECMAScript. Не правете извод за поддръжката въз основа на версията на Node.js; проверете целевите браузъри.

Примери

(async () => {
  const box = document.createElement('div');
  box.textContent = 'Pause demo';
  document.body.append(box);

  const animation = box.animate(
    [{ opacity: 0 }, { opacity: 1 }],
    { duration: 1000, fill: 'both' }
  );
  animation.pause();
  await animation.ready;
  animation.currentTime = 500;

  console.log(animation.playState);
  console.log(animation.currentTime);
  console.log(animation.pending);

  animation.cancel();
  box.remove();
})();

Резултат

paused
500
false

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

Източници