CKTIS / JavaScript
HTMLMediaElement.pause() — afspelen pauzeren
De methode pause() pauzeert een audio- of video-element zonder terug te spoelen naar het begin. De methode heeft geen argumenten en geeft undefined terug. De paused-status verandert synchroon, terwijl het pause-event later wordt verzonden.
Versie: 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 is een Web API-methode van de browser die audio- en video-elementen erven. Roep media.pause() aan op een media-element. De methode heeft geen argumenten en geeft undefined terug, geen promise. De methode maakt geen deel uit van ECMAScript zelf; de aanwezigheid van Node.js in een project bewijst niet dat de methode daar beschikbaar is.
Als paused de waarde false heeft, zet de methode deze synchroon op true. Het afspelen wordt niet teruggespoeld naar het begin. Gebruik play() om het afspelen te hervatten. Een volgende aanroep van pause() op een element dat al gepauzeerd is, veroorzaakt geen nieuw pause-event.
Wanneer de status verandert, zet de browser een taak in de wachtrij die eerst timeupdate en daarna pause verzendt; deze events worden niet verzonden voordat de methode terugkeert. Na het verzenden van beide events wijst de taak alleen díé door play() teruggegeven promises af met AbortError die nog in de lijst met openstaande afspeelpromises van het element stonden toen het pause()-algoritme die lijst overnam. Een promise die al uit de lijst is gehaald voor een taak in de wachtrij die playing verzendt, kan alsnog worden vervuld. Handel afwijzingen van door play() teruggegeven promises af. Als networkState de waarde NETWORK_EMPTY heeft, start pause() ook het algoritme voor resourcekeuze — beschouw deze methode niet als een manier om een download te annuleren.
Het voorbeeld gebruikt bewust een nieuw element zonder bron, dat begint met paused === true. Het laat de retourwaarde en veilige herhaalde aanroepen zien, maar niet het onderbreken van actief afspelen.
Voorbeelden
const media = document.createElement('video');
const result = media.pause();
console.log(media.paused);
console.log(result === undefined);
media.pause();
console.log(media.paused);Resultaat
true true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.