Latest web development tutorials
 

HTML DOM Audio Object


Audio Object

The Audio Object is new in HTML5.

The Audio object represents an HTML <audio> element.

Note: The <audio> element is not supported in Internet Explorer 8 and earlier versions.

Access an Audio Object

You can access an <audio> element by using getElementById():

Example

var x = document.getElementById("myAudio");
Try it Yourself »

Create an Audio Object

You can create an <audio> element by using the document.createElement() method:

Example

var x = document.createElement("AUDIO");
Try it Yourself »

Audio Object Properties

Property Description
audioTracks Returns an AudioTrackList object representing available audio tracks
autoplay Sets or returns whether the audio should start playing as soon as it is ready
buffered Returns a TimeRanges object representing the buffered parts of an audio
controller Returns the MediaController object representing the current media controller of an audio
controls Sets or returns whether an audio should have controls displayed (play/pause etc)
crossOrigin Sets or returns the CORS settings of an audio
currentSrc Returns the URL of the current audio
currentTime Sets or returns the current playback position in an audio (in seconds)
defaultMuted Sets or returns whether the audio should be muted by default
defaultPlaybackRate Sets or returns whether the default playback speed of the audio
duration Returns the length of an audio(in seconds)
ended Returns whether the playback of the audio has ended
error Returns a MediaError object representing the error state of the audio
loop Sets or returns whether the audio should start playing over again, every time it is finished
mediaGroup Sets or returns the name of the media group the audio(s) is a part of
muted Sets or returns whether the sound should be turned off
networkState Returns the current network state of an audio
paused Sets or returns whether an audio is paused
playbackRate Sets or returns the speed of the audio playback
played Returns a TimeRanges object representing the played parts of the audio
preload Sets or returns the value of the preload attribute of an audio
readyState Returns the current ready state of an audio
seekable Returns a TimeRanges object representing the seekable parts of an audio
seeking Returns whether the user is currently seeking in the audio
src Sets or returns the value of the src attribute of an audio
textTracks Returns a TextTrackList object representing the available text tracks
volume Sets or returns the audio volume of an audio

Audio Object Methods

Method Description
addTextTrack() Adds a new text track to the audio
canPlayType() Checks whether the browser can play the specified audio type
fastSeek() Seeks to a specified time in the audio player
getStartDate() Returns a new Date object, representing the current timeline offset
load() Re-loads the audio element
play() Starts playing the audio
pause() Pauses the currently playing audio

Standard Properties and Events

The Audio object also supports the standard properties and events.


Related Pages

HTML tutorial: HTML5 audio

HTML reference: HTML <audio> tag