Spec-Zone.ru › Web APIs

HTMLMediaElement: метод load()

Базовая Широко доступна

Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Метод HTMLMediaElement load() сбрасывает элемент медиа в исходное состояние и начинает процесс выбора источника медиа и загрузки медиа, в подготовке к воспроизведению с начала.

Объем предварительно загружаемых данных медиа определяется значением атрибута элемента preload.

Этот метод обычно полезен только тогда, когда вы внесли динамические изменения в набор источников, доступных для элемента медиа, либо изменив атрибут элемента src, либо добавив или удалив элементы <source>, вложенные в сам элемент медиа. load() сбросит элемент и повторно просканирует доступные источники, тем самым приведя изменения в действие.

Синтаксис

load()

Параметры

Нет.

Возвращаемое значение

Нет (undefined).

Примечания по использованию

Вызов load() прерывает все текущие операции, связанные с этим элементом медиа, затем начинает процесс выбора и загрузки соответствующего ресурса медиа, учитывая параметры, указанные в элементе <audio> или <video> и его атрибуте src или дочернем элементе <source>. Подробнее об этом описано на странице «HTML видео и аудио».

Процесс прерывания любых текущих операций приведет к выполнению или отклонению любых ожидающих Promise, возвращаемых методом play(), в зависимости от их статуса до начала загрузки новых медиа. Ожидающие обещания воспроизведения прерываются с помощью "AbortError" исключения DOMException.

При выполнении процесса загрузки в сам элемент медиа будут отправляться соответствующие события:

  • Если элемент уже загружает медиа, этот процесс прерывается, и отправляется событие abort.
  • Если элемент уже инициализирован с медиа, отправляется событие emptied.
  • Если сброс позиции воспроизведения до начала медиа фактически изменил позицию воспроизведения (то есть она не была уже в начале), отправляется событие timeupdate.
  • После того, как медиа выбрано, и загрузка готова начаться, отправляется событие loadstart.
  • Начиная с этого момента, события отправляются так же, как и при любой загрузке медиа.

Примеры

В этом примере находится элемент <video> в документе и сбрасывается путем вызова load().

const mediaElem = document.querySelector("video");
mediaElem.load();

Спецификации

Спецификация
HTML
# dom-media-load-dev

Совместимость браузеров

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
load 3 12 3.5 ≤12.1 3.1 18 4 ≤12.1 3 1.0 ≤37

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/load

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API