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