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 HTMLVideoElementHTMLMediaElement.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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.