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

CKTIS / JavaScript

HTMLMediaElement.pause() — поставяне на възпроизвеждането на пауза

Методът pause() поставя аудио или видео елемент на пауза, без да връща възпроизвеждането в началото. Не приема аргументи и връща undefined. Състоянието paused се променя синхронно, а събитието pause се изпраща по-късно.

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

Синтаксис

media.pause()

HTMLMediaElement.pause е метод от уеб API на браузъра, наследен от елементите audio и video. Извикайте media.pause() върху мултимедиен елемент. Методът не приема аргументи и връща undefined, а не promise. Не е част от самия ECMAScript; наличието на Node.js в даден проект не доказва, че методът е достъпен там.

Ако paused е false, методът синхронно задава стойност true. Той не връща възпроизвеждането в началото. За да продължите възпроизвеждането, използвайте play(). Повторното извикване на pause() върху вече поставен на пауза елемент не генерира ново събитие pause.

При промяна на състоянието браузърът поставя задача на опашка, която изпраща първо timeupdate, а след това pause; тези събития не се изпращат преди методът да върне управлението. След изпращането на двете събития задачата отхвърля с AbortError само онези обещания, върнати от play(), които все още са били в списъка на елемента с чакащи обещания за възпроизвеждане, когато алгоритъмът на pause() е взел списъка. Обещание, което вече е извадено от списъка за задача на опашката, която изпраща събитието playing, все още може да бъде изпълнено. Обработвайте отхвърлянията на обещанията, върнати от play(). Ако networkState е NETWORK_EMPTY, pause() задейства и алгоритъма за избор на ресурс — не използвайте метода като механизъм за отменяне на изтегляне.

Примерът умишлено използва нов елемент без източник, който първоначално е с paused === true. Той показва върнатата стойност и безопасното повторно извикване, но не демонстрира прекъсване на активно възпроизвеждане.

Примери

const media = document.createElement('video');
const result = media.pause();
console.log(media.paused);
console.log(result === undefined);
media.pause();
console.log(media.paused);

Резултат

true
true
true

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

Източници