CKTIS / JavaScript
HTMLMediaElement.pause() — pozastavení přehrávání
Metoda pause() pozastaví přehrávání zvukového nebo video prvku, aniž by se přehrávání vrátilo na začátek. Nepřijímá žádné argumenty a vrací undefined. Stav paused se změní synchronně, zatímco událost pause se odešle později.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
media.pause()HTMLMediaElement.pause je metoda webového API prohlížeče, kterou dědí prvky audio a video. Zavolejte media.pause() na multimediálním prvku. Metoda nepřijímá žádné argumenty a vrací undefined, nikoli příslib. Není součástí samotného ECMAScriptu; přítomnost Node.js v projektu nepotvrzuje, že je metoda dostupná.
Pokud má paused hodnotu false, metoda ji synchronně nastaví na true. Přehrávání se nevrátí na začátek. Chcete-li v přehrávání pokračovat, použijte play(). Opakované zavolání pause() na již pozastaveném prvku nevyvolá další událost pause.
Při změně stavu prohlížeč zařadí úlohu, která odešle nejprve timeupdate a poté pause; tyto události se neodesílají před návratem metody. Po odeslání obou událostí úloha odmítne s chybou AbortError pouze přísliby vrácené metodou play(), které byly ještě v seznamu čekajících příslibů přehrávání daného prvku, když algoritmus pause() tento seznam převzal. Příslib, který už byl ze seznamu odebrán pro zařazenou úlohu odesílající událost playing, může být stále splněn. Ošetřete odmítnutí příslibů vrácených metodou play(). Pokud má networkState hodnotu NETWORK_EMPTY, metoda pause() také spustí algoritmus výběru zdroje — nepovažujte ji za prostředek ke zrušení stahování.
Příklad záměrně používá nový prvek bez zdroje, který má od začátku paused === true. Ukazuje návratovou hodnotu a bezpečné opakované volání, ale nepředvádí přerušení aktivního přehrávání.
Příklady
const media = document.createElement('video');
const result = media.pause();
console.log(media.paused);
console.log(result === undefined);
media.pause();
console.log(media.paused);Výsledek
true true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.