MediaSource: removeSourceBuffer() 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 removeSourceBuffer() method of the MediaSource interface removes the given SourceBuffer from the SourceBufferList associated with this MediaSource object.

Syntax

js
removeSourceBuffer(sourceBuffer)

Parameters

sourceBuffer

The SourceBuffer object to be removed.

Return value

None (undefined).

Exceptions

NotFoundError DOMException

Thrown if the supplied sourceBuffer doesn't exist in MediaSource.sourceBuffers.

Examples

js
for (let i = 0; i < 10; i++) {
  const sourceBuffer = mediaSource.addSourceBuffer(mimeCodec);
}

mediaSource.removeSourceBuffer(mediaSource.sourceBuffers[0]);

Specifications

Specification
Media Source Extensions™
# dom-mediasource-removesourcebuffer

Browser compatibility

BCD tables only load in the browser

See also