TheHTMLAudioElement interface provides access to the properties of<audio> elements, as well as methods to manipulate them.

This element is based on, and inherits properties and methods from, theHTMLMediaElement interface.

Constructor

Audio()

Creates and returns a newHTMLAudioElement object, optionally starting the process of loading an audio file into it if the file URL is given.

Instance properties

No specific properties; inherits properties from its parent,HTMLMediaElement, and fromHTMLElement.

Instance methods

Inherits methods from its parent,HTMLMediaElement, and fromHTMLElement. It offers no methods of its own.

Examples

Basic usage

You can create aHTMLAudioElement entirely with JavaScript using theAudio() constructor:

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

then you can invoke theplay() method on the element

audioElement.play();

Some of the more commonly used properties of the audio element includesrc,currentTime,duration,paused,muted, andvolume. This snippet copies the audio file's duration to a variable:

const audioElement = new Audio("car_horn.wav");audioElement.addEventListener("loadeddata", () => {  let duration = audioElement.duration;  // The duration variable now holds the duration (in seconds) of the audio clip});

Events

Inherits methods from its parent,HTMLMediaElement, and from its ancestorHTMLElement. Listen to events usingaddEventListener() or by assigning an event listener to theoneventname property of this interface.

Specifications

Browser compatibility

See also

• Web media technologies
• Audio and Video Delivery
• HTML element implementing this interface:<audio>.