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():
Create an Audio Object
You can create an <audio> element by using the document.createElement() method:
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
