Back to Content

MediaSource: removeSourceBuffer() method

files/en-us/web/api/mediasource/removesourcebuffer/index.md

latest1005 B
Original Source

{{APIRef("Media Source Extensions")}}{{AvailableInWorkers("window_and_dedicated")}}

The removeSourceBuffer() method of the {{domxref("MediaSource")}} interface removes the given {{domxref("SourceBuffer")}} from the {{domxref("SourceBufferList")}} associated with this MediaSource object.

Syntax

js-nolint
removeSourceBuffer(sourceBuffer)

Parameters

  • sourceBuffer
    • : The {{domxref("SourceBuffer")}} object to be removed.

Return value

None ({{jsxref("undefined")}}).

Exceptions

  • NotFoundError {{domxref("DOMException")}}
    • : Thrown if the supplied sourceBuffer doesn't exist in {{domxref("MediaSource.sourceBuffers")}}.

Examples

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

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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{domxref("SourceBuffer")}}
  • {{domxref("SourceBufferList")}}