VideoTrackList: addtrack イベント

Limited availability

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

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

構文

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

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

onaddtrack = (event) => {};

イベント型

TrackEvent です。 Event から継承しています。

Event TrackEvent

イベントプロパティ

下記に挙げたプロパティに加えて、親インターフェイスである Event のプロパティも利用できます。

track 読取専用

イベントが参照している新しく追加された VideoTrack。

例

addEventListener() を使用する場合

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

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

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

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

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

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser

関連情報