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