Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

HTMLMediaElement.pause() — začasna ustavitev predvajanja

Metoda pause() začasno ustavi predvajanje zvočnega ali video elementa, ne da bi ga vrnila na začetek. Ne sprejema argumentov in vrne undefined. Stanje paused se spremeni sinhrono, dogodek pause pa se sproži pozneje.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

media.pause()

HTMLMediaElement.pause je metoda brskalniškega spletnega API-ja, ki jo podedujeta elementa audio in video. Na večpredstavnostnem elementu pokličite media.pause(). Metoda ne sprejema argumentov in vrne undefined, ne obljube. Ni del samega ECMAScripta; prisotnost Node.js v projektu ne potrjuje, da je metoda tam na voljo.

Če je vrednost paused enaka false, jo metoda sinhrono nastavi na true. Predvajanja ne vrne na začetek. Za nadaljevanje predvajanja uporabite play(). Ponovni klic pause() na že ustavljenem elementu ne sproži novega dogodka pause.

Ko se stanje spremeni, brskalnik v čakalno vrsto doda opravilo, ki najprej sproži timeupdate in nato pause; ta dogodka se ne sprožita, preden se metoda vrne. Po sprožitvi obeh dogodkov opravilo z napako AbortError zavrne le tiste obljube, ki jih je vrnil play() in so bile še na seznamu čakajočih obljub za predvajanje tega elementa, ko je algoritem pause() prevzel seznam. Obljuba, ki je bila s seznama že odstranjena za opravilo v čakalni vrsti, ki sproži dogodek playing, se še vedno lahko izpolni. Obravnavajte zavrnitve obljub, ki jih vrne play(). Če je networkState enak NETWORK_EMPTY, pause() zažene tudi algoritem izbire vira — te metode ne obravnavajte kot mehanizem za preklic prenosa.

Primer namenoma uporablja nov element brez vira, ki ima na začetku paused === true. Prikazuje vrnjeno vrednost in varno ponavljanje klica, ne prikazuje pa prekinitve aktivnega predvajanja.

Primeri

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

Rezultat

true
true
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri