HTMLAudioElement

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

L'interface HTMLAudioElement donne accès aux propriétés des éléments HTML <audio>, ainsi qu'aux méthodes permettant de les manipuler.

Cet élément est basé sur l'interface HTMLMediaElement, dont il hérite des propriétés et des méthodes.

EventTarget Node Element HTMLElement HTMLMediaElement HTMLAudioElement

Dans cet article

Constructeur

Audio()

Crée et retourne un nouvel objet HTMLAudioElement, en lançant éventuellement le chargement d'un fichier audio si une URL de fichier est fournie.

Propriétés d'instance

Aucune propriété spécifique ; hérite des propriétés de son parent HTMLMediaElement et de HTMLElement.

Méthodes d'instance

Hérite des méthodes de son parent HTMLMediaElement et de HTMLElement. Elle n'offre pas de méthodes propres.

Exemples

Utilisation simple

Vous pouvez créer un HTMLAudioElement entièrement en JavaScript à l'aide du constructeur Audio() :

const audioElement = new Audio("car_horn.wav");

vous pouvez ensuite appeler la méthode play() sur l'élément :

audioElement.play();

Note : Un écueil courant consiste à essayer de lire un élément audio immédiatement au chargement de la page. La politique d'autoplay par défaut des navigateurs modernes bloque ce comportement. Consultez les articles Firefox (angl.) et Chrome pour les bonnes pratiques et les solutions de contournement.

Parmi les propriétés les plus couramment utilisées de l'élément audio, on trouve src, currentTime, duration, paused, muted et volume. Cet extrait copie la durée du fichier audio dans une variable :

js
const audioElement = new Audio("car_horn.wav");
audioElement.addEventListener("loadeddata", () => {
  let duration = audioElement.duration;
  // La variable duration contient maintenant la durée (en secondes) du clip audio
});