AudioTrackList: removetrack イベント

Limited availability

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

removetrack イベントは、トラックが AudioTrackList から取り除かれたときに発生します。

構文

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

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

onremovetrack = (event) => { }

イベント型

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

Event TrackEvent

イベントプロパティ

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

track 読取専用

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

解説

トリガー

removetrack イベントは、 AudioTrackList オブジェクトで表される音声トラックを持つメディア要素からトラックが取り外されるたびに呼び出されます。

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

用途

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

AddEventListener() を使用する場合:

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

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

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

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

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

仕様書

Specification
HTML Standard
# event-media-removetrack
HTML Standard
# handler-tracklist-onremovetrack

ブラウザーの互換性

BCD tables only load in the browser

関連情報