База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

HTMLMediaElement.play() — асинхронно стартиране на възпроизвеждането

Методът play() заявява стартиране или подновяване на възпроизвеждането на аудио или видео. Той връща Promise, затова интерфейсът трябва да отчита както започването на възпроизвеждането, така и отхвърлянето на заявката.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

media.play() // Promise<undefined>; media is an HTMLAudioElement or HTMLVideoElement

HTMLMediaElement.play() е метод от Web API на браузъра за елементи audio и video, а не функция на ECMAScript. Не приема аргументи. Връща Promise, която се изпълнява със стойност undefined, когато възпроизвеждането започне — не когато медийното съдържание приключи.

Използвайте await media.play() в рамките на try...catch. Нито връщането от извикването, нито paused === false потвърждават, че възпроизвеждането е започнало. Promise може да остане нерешена, докато се зареждат данни; актуализирайте интерфейса, след като тя се разреши.

NotAllowedError означава, че възпроизвеждането не е разрешено, например заради политиката за автоматично възпроизвеждане. Извикайте метода директно в обработчик на щракване, но все пак обработвайте отказа. NotSupportedError се отнася за неподдържан източник. Прекъсването на чакаща заявка чрез pause() или презареждане може да доведе до AbortError.

Примерът умишлено подава текст вместо запис, за да покаже обработка на отхвърляне без външен файл. Той не демонстрира успешно възпроизвеждане. Този API е част от HTML Living Standard; Node 24 в хранилище не доказва наличността му в браузър.

Примери

const media = document.createElement('audio');
media.src = 'data:text/plain,not-media';
const button = document.createElement('button');
button.textContent = 'Test play()';
const status = document.createElement('pre');
document.body.append(button, status);

button.addEventListener('click', async () => {
  button.disabled = true;
  try {
    await media.play();
    status.textContent = 'Playback started';
  } catch (error) {
    status.textContent = `Rejected: ${error.name}`;
  } finally {
    button.disabled = false;
  }
});

Резултат

Rejected: NotSupportedError

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници