CKTIS / JavaScript
HTMLMediaElement.pause() — pozastavenie prehrávania
Metóda pause() pozastaví prehrávanie zvukového alebo video prvku bez návratu na začiatok. Neprijíma žiadne argumenty a vracia undefined. Stav paused sa zmení synchrónne, zatiaľ čo udalosť pause sa odošle neskôr.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
media.pause()HTMLMediaElement.pause je metóda webového API prehliadača, ktorú dedia prvky audio a video. Zavolajte media.pause() na multimediálnom prvku. Metóda neprijíma žiadne argumenty a vracia undefined, nie promise. Nie je súčasťou samotného ECMAScriptu; prítomnosť Node.js v projekte nepotvrdzuje jej dostupnosť.
Ak má paused hodnotu false, metóda ju synchrónne nastaví na true. Prehrávanie sa nevráti na začiatok. Ak chcete v prehrávaní pokračovať, použite play(). Opätovné zavolanie pause() na už pozastavenom prvku nevygeneruje ďalšiu udalosť pause.
Pri zmene stavu prehliadač zaradí úlohu, ktorá odošle najprv timeupdate a potom pause; tieto udalosti sa neodošlú pred návratom metódy. Po odoslaní oboch udalostí úloha odmietne s chybou AbortError iba prísľuby vrátené metódou play(), ktoré ešte boli v zozname čakajúcich prísľubov prehrávania daného prvku, keď algoritmus pause() tento zoznam prevzal. Prísľub, ktorý už bol zo zoznamu odobratý pre zaradenú úlohu odosielajúcu udalosť playing, sa stále môže splniť. Ošetrite odmietnutia prísľubov vrátených metódou play(). Ak má networkState hodnotu NETWORK_EMPTY, pause() spustí aj algoritmus výberu zdroja — nepovažujte túto metódu za spôsob zrušenia sťahovania.
Príklad zámerne používa nový prvok bez zdroja, ktorý má od začiatku paused === true. Ukazuje návratovú hodnotu a bezpečné opakované volanie, ale neukazuje prerušenie aktívneho prehrávania.
Prí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ýsledok
true true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.