TextTrack.removeCue()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

removeCue() は TextTrack インターフェイスのメソッドで、キューのリストからキューを取り除きます。

構文

js
removeCue(cue)

引数

cue

TextTrackCue です。

返値

undefined です。

例外

NotFoundError DOMException

指定されたキューがキューのリストに見つからなかった場合に発生します。

メモ: TextTrackCue インターフェイスは、 VTTCue などの他のキューインターフェイスの親クラスとして使用される抽象的なクラスです。したがって、キューを追加する場合は TextTrackCue を継承したキュー型のいずれかを使用することになります。

例

以下の例では、addCue() を使用して動画のテキストトラックにキューを追加し、removeCue を使用してキューを削除しています。

js
let video = document.querySelector("video");
let track = video.addTextTrack("captions", "Captions", "en");
track.mode = "showing";
let cue = new VTTCue(0, 0.9, "Hildy!");
track.addCue(cue);
track.removeCue(cue);

仕様書

Specification
HTML Standard
# dom-texttrack-removecue-dev

ブラウザーの互換性

BCD tables only load in the browser