W3cubDocs

/Web APIs

TextTrack: removeCue() method

The removeCue() method of the TextTrack interface removes a cue from the list of cues.

Syntax

js

removeCue(cue)

Parameters

Return value

Undefined.

Exceptions

NotFoundError DOMException

Thrown if the given cue is not found in the list of cues.

Note: The TextTrackCue interface is an abstract class used as the parent for other cue interfaces such as VTTCue. Therefore, when removing a cue you will be passing in one of the cue types that inherit from TextTrackCue.

Examples

In the following example a cue is added to a video text track using addCue(), then removed using 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);

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
removeCue 23 12 31 10 ≤12.1 6 4.4 25 31 ≤12.1 7 1.5

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/TextTrack/removeCue