HTMLMediaElement: error property

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("HTML DOM")}}

The **error** read-only property of the {{domxref("HTMLMediaElement")}} interface is the {{domxref("MediaError")}} object for the most recent error, or null if there has not been an error. When an {{domxref("HTMLMediaElement/error_event", "error")}} event is received by the element, you can determine details about what happened by examining this object.

Value

A {{domxref("MediaError")}} object describing the most recent error to occur on the media element or null if no errors have occurred.

Examples

This example establishes a video element and adds an error handler to it; the error handler logs the details to console.

js
const videoElement = document.createElement("video");
videoElement.onerror = () => {
  console.error(
    `Error ${videoElement.error.code}; details: ${videoElement.error.message}`,
  );
};
videoElement.src = "https://example.com/bogusvideo.mp4";

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{domxref("HTMLMediaElement")}}: Interface used to define the HTMLMediaElement.error property
  • {{HTMLElement("audio")}} and {{HTMLElement("video")}}