HTMLAudioElement
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("HTML DOM")}}
The **HTMLAudioElement** interface provides access to the properties of {{HTMLElement("audio")}} elements, as well as methods to manipulate them.
This element is based on, and inherits properties and methods from, the {{domxref("HTMLMediaElement")}} interface.
{{InheritanceDiagram}}
Constructor
- {{domxref("HTMLAudioElement.Audio", "Audio()")}}
- : Creates and returns a new
HTMLAudioElementobject, 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, {{domxref("HTMLMediaElement")}}, and from {{domxref("HTMLElement")}}._
Instance methods
_Inherits methods from its parent, {{domxref("HTMLMediaElement")}}, and from {{domxref("HTMLElement")}}. It offers no methods of its own._
Events
_Inherits methods from its parent, {{domxref("HTMLMediaElement")}}, and from its ancestor {{domxref("HTMLElement")}}._ Listen to events using [addEventListener()](/en-US/docs/Web/API/EventTarget/addEventListener) or by assigning an event listener to the oneventname property of this interface.
Examples
Basic usage
You can create a HTMLAudioElement entirely with JavaScript using the {{domxref("HTMLAudioElement.Audio", "Audio()")}} constructor:
const audioElement = new Audio("car_horn.wav");then you can invoke the play() method on the element
audioElement.play();توجه: A common gotcha is trying to play an audio element immediately on page load. Modern browser's default autoplay policy will block that from happening. Refer to Firefox and chrome for best practices and workarounds.
Some of the more commonly used properties of the audio element include {{domxref("HTMLMediaElement.src", "src")}}, {{domxref("HTMLMediaElement.currentTime", "currentTime")}}, {{domxref("HTMLMediaElement.duration", "duration")}}, {{domxref("HTMLMediaElement.paused", "paused")}}, {{domxref("HTMLMediaElement.muted", "muted")}}, and {{domxref("HTMLMediaElement.volume", "volume")}}. 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
});Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- Web media technologies
- Audio and Video Delivery
- HTML element implementing this interface: {{HTMLElement("audio")}}.