CKTIS / JavaScript
HTMLMediaElement.pause() — Wiedergabe pausieren
Die Methode pause() pausiert ein Audio- oder Videoelement, ohne zum Anfang zurückzuspulen. Sie nimmt keine Argumente entgegen und gibt undefined zurück. Der paused-Status ändert sich synchron, das pause-Ereignis wird dagegen später ausgelöst.
Version: 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 ist eine Web-API-Methode des Browsers, die Audio- und Videoelemente erben. Rufe media.pause() für ein Medienelement auf. Die Methode nimmt keine Argumente entgegen und gibt undefined zurück, kein Promise. Sie gehört nicht zu ECMAScript selbst; dass ein Projekt Node.js verwendet, belegt nicht, dass die Methode dort verfügbar ist.
Wenn paused den Wert false hat, setzt die Methode ihn synchron auf true. Die Wiedergabe wird nicht zum Anfang zurückgespult. Verwende play(), um die Wiedergabe fortzusetzen. Ein erneuter Aufruf von pause() für ein bereits pausiertes Element löst kein weiteres pause-Ereignis aus.
Ändert sich der Status, reiht der Browser eine Aufgabe ein, die zuerst timeupdate und anschließend pause auslöst; diese Ereignisse werden nicht vor der Rückkehr der Methode ausgelöst. Danach lehnt die Aufgabe mit AbortError nur die von play() zurückgegebenen Promises ab, die noch in der Liste der ausstehenden Wiedergabe-Promises des Elements standen, als der pause()-Algorithmus diese Liste übernahm. Ein Promise, das zuvor für eine bereits eingereihte Aufgabe aus der Liste entnommen wurde, die playing auslöst, kann weiterhin erfüllt werden. Behandle Ablehnungen der von play() zurückgegebenen Promises. Wenn networkState den Wert NETWORK_EMPTY hat, ruft pause() außerdem den Algorithmus zur Ressourcenauswahl auf — verwende die Methode nicht, um einen Download abzubrechen.
Das Beispiel verwendet absichtlich ein neues Element ohne Quelle, bei dem anfangs paused === true gilt. Es zeigt den Rückgabewert und wiederholte, sichere Aufrufe, aber nicht das Unterbrechen einer laufenden Wiedergabe.
Beispiele
const media = document.createElement('video');
const result = media.pause();
console.log(media.paused);
console.log(result === undefined);
media.pause();
console.log(media.paused);Ergebnis
true true true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.