SourceBuffer: remove() method

Limited availability

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

Note: This feature is available in Dedicated Web Workers.

The remove() method of the SourceBuffer interface removes media segments within a specific time range from the SourceBuffer. This method can only be called when SourceBuffer.updating equals false. If SourceBuffer.updating is not equal to false, call SourceBuffer.abort().

Syntax

js
remove(start, end)

Parameters

start

A double representing the start of the time range, in seconds.

end

A double representing the end of the time range, in seconds.

Return value

None (undefined).

Exceptions

InvalidAccessError DOMException

Thrown if either the MediaSource.duration property is equal to NaN, the start parameter is negative or greater than MediaSource.duration, or the end parameter is less than or equal to start or equal to NaN.

InvalidStateError DOMException

Thrown if the SourceBuffer.updating property is equal to true, or this SourceBuffer has been removed from MediaSource.

Examples

TBD.

Specifications

Specification
Media Source Extensions™
# dom-sourcebuffer-remove

Browser compatibility

See also