Audio preload Property
Example
Find out if and how the author thinks that the audio should be loaded when the page loads:
var x = document.getElementById("myAudio").preload;
Try it Yourself »
Definition and Usage
The preload property sets or returns the value of the preload attribute of a audio.
The preload attribute specifies if and how the author thinks that the audio should be loaded when the page loads.
The preload attribute allows the author to provide a hint to the browser about what he/she thinks will lead to the best user experience. This attribute may be ignored in some instances.
Note: The preload attribute is ignored if the autoplay attribute is present.
Browser Support
Property | |||||
---|---|---|---|---|---|
preload | Yes | 9.0 | Yes | Yes | Yes |
Syntax
Return the preload property:
audioObject.preload
Set the preload property:
audioObject.preload = "auto|metadata|none"
Property Values
Value | Description |
---|---|
auto | The author thinks that the browser should load the entire audio when the page loads |
metadata | The author thinks that the browser should load only metadata when the page loads |
none | The author thinks that the browser should NOT load the audio when the page loads |
Technical Details
Return Value: | A String, representing what data should be preloaded (if any). Possible return values are "auto", "metadata", or "none". See "Property Values" for what the values mean |
---|
More Examples
Example
A demonstration of how to set different property values:
document.getElementById("myAudio").preload = "none";
document.getElementById("myaudio").preload = "auto";
Try it Yourself »
Related Pages
HTML reference: HTML <audio> preload attribute
❮ Audio Object