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()
などのメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。
addEventListener("removetrack", (event) => { })
onremovetrack = (event) => { }
イベント型
TrackEvent
です。 Event
を継承しています。
イベントプロパティ
TrackEvent
は Event
に基づいているため、 Event
のプロパティも TrackEvent
オブジェクトで利用できます。
track
読取専用-
このイベントが参照している DOM track オブジェクト。
null
でなければ、これは常にいずれかのメディアトラック型のオブジェクトになります。AudioTrack
、VideoTrack
、TextTrack
) のいずれかです。
解説
トリガー
removetrack
イベントは、 AudioTrackList
オブジェクトで表される音声トラックを持つメディア要素からトラックが取り外されるたびに呼び出されます。
このイベントはキャンセル不可で、バブリングしません。
用途
このイベントを使用して、新しい音声トラックが利用できるようになったことに反応することができます。例えば、新しい音声トラックをユーザーが選択できるように、 UI 要素を更新することができます。
例
AddEventListener()
を使用する場合:
const videoElement = document.querySelector("video");
videoElement.audioTracks.addEventListener("removetrack", (event) => {
console.log(`Audio track: ${event.track.label} removed`);
});
onremovetrack
イベントハンドラープロパティを使用する場合:
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
関連情報
- 関連イベント:
addtrack
,change
VideoTrackList
を対象としたこのイベント:removetrack
MediaStream
を対象としたこのイベント:removetrack
- メディアキャプチャおよびストリーム API
- WebRTC API