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 :

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 :

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
});

Évènements

Hérite des méthodes de son parent HTMLMediaElement et de son ancêtre HTMLElement. Écoutez les évènements à l'aide de addEventListener() ou en assignant un gestionnaire à la propriété oneventname de cette interface.

Spécifications

Compatibilité des navigateurs

Voir aussi

• Technologies des médias web
• Diffusion audio et vidéo
• L'élément HTML implémentant cette interface : <audio>.