AudioTrackList: addtrack イベント

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

addtrack イベントは、トラックが AudioTrackList に追加されたときに発生します。

構文

このイベント名を addEventListener() などのメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。

js
addEventListener("addtrack", (event) => { })

onaddtrack = (event) => { }

イベント型

TrackEvent です。 Event を継承しています。

Event TrackEvent

イベントプロパティ

TrackEventEvent に基づいているため、 Event のプロパティも TrackEvent オブジェクトで利用できます。

track 読取専用

このイベントが参照している DOM track オブジェクト。 null でなければ、これは常にいずれかのメディアトラック型のオブジェクトになります。AudioTrackVideoTrackTextTrack) のいずれかです。

解説

トリガー

この addtrack イベントは、 AudioTrackList オブジェクトで表される音声トラックを持つメディア要素に新しいトラックが追加されるたびに呼び出されます。 これは、メディアが最初に要素に装着されたとき、トラックが追加されたときに起こります。メディアリソース内のそれぞれの音声トラックに対して、 1 つの addtrack イベントが発生します。

このイベントはキャンセル不可で、バブリングしません。

用途

このイベントを使用して、新しい音声トラックが利用できるようになったことに反応することができます。例えば、新しい音声トラックをユーザーが選択できるように、 UI 要素を更新することができます。

addEventListener() を使用する場合:

js
const videoElement = document.querySelector("video");

videoElement.audioTracks.addEventListener("addtrack", (event) => {
  console.log(`Audio track: ${event.track.label} added`);
});

onaddtrack イベントハンドラープロパティを使用する場合:

js
const videoElement = document.querySelector("video");

videoElement.audioTracks.onaddtrack = (event) => {
  console.log(`Audio track: ${event.track.label} added`);
};

仕様書

Specification
HTML
# event-media-addtrack
HTML
# handler-tracklist-onaddtrack

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
addtrack event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
User must explicitly enable this feature.
Has more compatibility info.

関連情報