CKTIS / JavaScript
Dogodki vmesnika HTMLMediaElement
Z devetimi dogodki za zvok in video uskladi položaj, trajanje in kontrolnike ter zaznaj ponastavitev vira, konec predvajanja ali napako.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
media.addEventListener(type, (event) => { /* read event.currentTarget here */ });
// type: "timeupdate" | "loadedmetadata" | "durationchange" | "emptied"
// | "play" | "pause" | "volumechange" | "ended" | "error"HTMLMediaElement je brskalniški vmesnik, skupen elementoma audio in video, in ni del ECMAScripta. Z addEventListener() registriraj poslušalce neposredno na predstavnostnem elementu, po možnosti pred nastavitvijo src: ti dogodki se ne širijo navzgor do prednikov in jih ni mogoče preklicati. V obdelovalniku preberi trenutno stanje elementa, namesto da ga sklepaš iz vrstnega reda dogodkov.
loadedmetadata pomeni, da so metapodatki, na primer mere videa, na voljo, ne pa, da je vse pripravljeno za predvajanje. durationchange sporoči, da je trajanje prvič določeno ali popravljeno: duration je v sekundah, ob manjkajočih podatkih ima vrednost NaN, ob neomejenem koncu pa Infinity. emptied pomeni, da je bilo stanje vira ponastavljeno, na primer ob ponovnem nalaganju. Odstrani stare podatke o mediju iz vmesnika; sama ponastavitev ne sproži nujno dogodka durationchange.
Ob timeupdate preberi currentTime v sekundah in osveži prikaz položaja. Dogodek lahko nastopi med predvajanjem ali skokom na drug položaj; ni časovnik s stalno frekvenco niti signal za vsako sličico. play pomeni, da se je paused spremenil v false, ne da se je predvajanje dejansko začelo (playing). pause sporoča prehod v stanje premora, ne začasnega pomanjkanja podatkov. Ob volumechange preberi volume in muted: sprememba ene ali druge vrednosti lahko sproži dogodek.
ended označuje dosežen konec, ne navadnega premora, čeprav se na koncu lahko pojavi tudi pause. Če je loop nastavljen na true in playbackRate ni negativen, se ended ne sproži. Ob error preveri media.error, na primer media.error?.code; ta MediaError se nanaša na predstavnostni vir. Zavrnitve obljube, ki jo vrne play(), obravnavaj ločeno: na primer NotAllowedError je lahko posledica pravil za samodejno predvajanje, ne da bi se sprožil predstavnostni dogodek error.
Primeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>HTMLMediaElement events</title>
</head>
<body>
<script>
(() => {
const panel = document.createElement('div');
const audio = document.createElement('audio');
audio.controls = true;
audio.preload = 'metadata';
panel.append(audio);
// Generate three seconds of silence as mono, 8-bit PCM WAV.
const rate = 8000;
const samples = 3 * rate;
const bytes = new Uint8Array(44 + samples);
const view = new DataView(bytes.buffer);
const tag = (offset, text) => bytes.set(new TextEncoder().encode(text), offset);
const u16 = (offset, value) => view.setUint16(offset, value, true);
const u32 = (offset, value) => view.setUint32(offset, value, true);
tag(0, 'RIFF'); u32(4, 36 + samples); tag(8, 'WAVE');
tag(12, 'fmt '); u32(16, 16); u16(20, 1); u16(22, 1);
u32(24, rate); u32(28, rate); u16(32, 1); u16(34, 8);
tag(36, 'data'); u32(40, samples); bytes.fill(128, 44);
const wav = URL.createObjectURL(new Blob([bytes], { type: 'audio/wav' }));
const bad = URL.createObjectURL(new Blob(['not audio'], { type: 'audio/wav' }));
const listeners = new AbortController();
const types = ['timeupdate', 'loadedmetadata', 'durationchange', 'emptied',
'play', 'pause', 'volumechange', 'ended', 'error'];
for (const type of types) {
audio.addEventListener(type, ({ currentTarget: media }) => {
console.log(type, {
currentTime: media.currentTime, duration: media.duration,
paused: media.paused, ended: media.ended,
volume: media.volume, muted: media.muted,
errorCode: media.error?.code ?? null
});
}, { signal: listeners.signal });
}
function button(label, action) {
const control = document.createElement('button');
control.type = 'button';
control.textContent = label;
control.addEventListener('click', action);
panel.append(control);
}
button('Mute / unmute', () => { audio.muted = !audio.muted; });
button('Reload', () => { audio.src = wav; });
button('Load invalid audio', () => { audio.src = bad; });
button('Remove demo', () => {
listeners.abort();
audio.removeAttribute('src');
audio.load();
panel.remove();
URL.revokeObjectURL(wav);
URL.revokeObjectURL(bad);
});
document.body.prepend(panel);
audio.src = wav;
})();
</script>
</body>
</html>Rezultat
Expected observations, not a fixed transcript (each event name is logged with a state object): - Initial load: durationchange and loadedmetadata; duration is 3 seconds at loadedmetadata. - Play, pause, resume, and let the clip finish: play, timeupdate (repeated), pause, play again, and eventually ended. A pause event can also occur at the end. - Mute / unmute: volumechange; muted toggles. - Reload after metadata is available: emptied, then fresh durationchange and loadedmetadata. - Load invalid audio: error with a non-null errorCode; emptied can appear first.
Primer shrani kot datoteko HTML in jo odpri v brskalniku, ki podpira PCM WAV in dovoljuje predstavnostne vire `blob:`. Dogodke spremljaj v razvijalski konzoli. Za predvajanje in premor uporabi vgrajene kontrolnike. Primer ustvari tri sekunde tišine brez prenosa datoteke; čas in število dogodkov se lahko razlikujeta. `Remove demo` odstrani kontrolnike in sprosti objektne URL-je.
Povezane lekcije
- JavaScript · Lekcija 28 · Srednja · Različica: 3