Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

HTMLMediaElement.pause() — mettre la lecture en pause

La méthode pause() met en pause un élément audio ou vidéo sans revenir au début. Elle ne prend aucun argument et renvoie undefined. L’état paused change de façon synchrone, tandis que l’événement pause est déclenché plus tard.

Version : 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 est une méthode de l’API Web du navigateur, héritée par les éléments audio et video. Appelez media.pause() sur un élément multimédia. La méthode ne prend aucun argument et renvoie undefined, et non une promesse. Elle ne fait pas partie d’ECMAScript lui-même ; la présence de Node.js dans un projet ne garantit pas qu’elle y soit disponible.

Si paused vaut false, la méthode le définit de façon synchrone sur true. Elle ne revient pas au début de la lecture. Pour reprendre la lecture, utilisez play(). Rappeler pause() sur un élément déjà en pause ne déclenche pas un nouvel événement pause.

Lorsque l’état change, le navigateur met en file une tâche qui déclenche timeupdate, puis pause ; ces événements ne sont pas déclenchés avant le retour de la méthode. Après avoir déclenché les deux événements, la tâche rejette avec AbortError uniquement les promesses renvoyées par play() qui figuraient encore dans la liste des promesses de lecture en attente de l’élément lorsque l’algorithme de pause() a récupéré cette liste. Une promesse déjà retirée de cette liste pour une tâche mise en file qui déclenche playing peut encore être résolue. Gérez les rejets des promesses renvoyées par play(). Si networkState vaut NETWORK_EMPTY, pause() lance également l’algorithme de sélection de ressource — ne considérez pas cette méthode comme un mécanisme d’annulation du téléchargement.

L’exemple utilise volontairement un nouvel élément sans source, dont l’état initial est paused === true. Il montre la valeur de retour et la possibilité de répéter l’appel sans risque, mais ne montre pas l’interruption d’une lecture en cours.

Exemples

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

Résultat

true
true
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources