SourceBufferList

Draft
This page is not complete.

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The SourceBufferList interface represents a simple container list for multiple SourceBuffer objects.

The source buffer list containing the SourceBuffers appended to a particular MediaSource can be retrieved using the MediaSource.sourceBuffers property. The individual source buffers can be accessed using array operator (i.e. []) or functions such as forEach() for example.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/SourceBufferList" target="_top"><rect x="151" y="1" width="160" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="231" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">SourceBufferList</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

Properties

SourceBufferList.length Read only: Returns the number of SourceBuffer objects in the list.

Event handlers

SourceBufferList.onaddsourcebuffer: The event handler for the addsourcebuffer event.
SourceBufferList.onremovesourcebuffer: The event handler for the removesourcebuffer event.

Methods

Inherits methods from its parent interface, EventTarget.

SourceBufferList: indexed property getter: This getter allows the SourceBuffer objects in the list to be accessed with an array operator (i.e. [].)

Examples

TBD.

Specifications

Specification	Status	Comment
Media Source Extensions The definition of 'SourceBufferList' in that specification.	Recommendation	Initial definition.

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`SourceBufferList` Experimental	Chrome Full support 31 Full support 31 No support 23 — 31 Prefixed Prefixed Implemented with the vendor prefix: WebKit	Edge Full support 12	Firefox Full support 42 Full support 42 No support 25 — 42 Notes Disabled Notes Limited support to an allowed list of sites, for example YouTube, Netflix, and other popular streaming sites. The limitation was removed when Media Source Extensions was enabled by default in Firefox 42. Disabled From version 25 until version 42 (exclusive): this feature is behind the `media.mediasource.enabled` preference. To change preferences in Firefox, visit about:config.	IE Full support 11 Notes Full support 11 Notes Notes Only works on Windows 8+.	Opera Full support 15	Safari Full support 8	WebView Android Full support 4.4.3	Chrome Android Full support 33	Firefox Android No support No	Opera Android Full support 14	Safari iOS No support No	Samsung Internet Android Full support 3.0
`SourceBuffer` Experimental	Chrome Full support 45	Edge Full support 12	Firefox Full support 42 Full support 42 No support 25 — 42 Notes Disabled Notes Limited support to an allowed list of sites, for example YouTube, Netflix, and other popular streaming sites. The limitation was removed when Media Source Extensions was enabled by default in Firefox 42. Disabled From version 25 until version 42 (exclusive): this feature is behind the `media.mediasource.enabled` preference. To change preferences in Firefox, visit about:config.	IE Full support 11 Notes Full support 11 Notes Notes Only works on Windows 8+.	Opera Full support 32	Safari Full support 8	WebView Android Full support 45	Chrome Android Full support 45	Firefox Android No support No	Opera Android Full support 32	Safari iOS No support No	Samsung Internet Android Full support 5.0
`length` Experimental	Chrome Full support 23	Edge Full support 12	Firefox Full support 42 Full support 42 No support 25 — 42 Notes Disabled Notes Limited support to an allowed list of sites, for example YouTube, Netflix, and other popular streaming sites. The limitation was removed when Media Source Extensions was enabled by default in Firefox 42. Disabled From version 25 until version 42 (exclusive): this feature is behind the `media.mediasource.enabled` preference. To change preferences in Firefox, visit about:config.	IE Full support 11 Notes Full support 11 Notes Notes Only works on Windows 8+.	Opera Full support 15	Safari Full support 8	WebView Android Full support 4.4.3	Chrome Android Full support 33	Firefox Android No support No	Opera Android Full support 14	Safari iOS No support No	Samsung Internet Android Full support 3.0
`onaddsourcebuffer` Experimental	Chrome Full support 53	Edge Full support 17	Firefox Full support 42 Full support 42 No support 25 — 42 Notes Disabled Notes Limited support to an allowed list of sites, for example YouTube, Netflix, and other popular streaming sites. The limitation was removed when Media Source Extensions was enabled by default in Firefox 42. Disabled From version 25 until version 42 (exclusive): this feature is behind the `media.mediasource.enabled` preference. To change preferences in Firefox, visit about:config.	IE Full support 11 Notes Full support 11 Notes Notes Only works on Windows 8+.	Opera Full support 40	Safari Full support 8	WebView Android Full support 53	Chrome Android Full support 53	Firefox Android No support No	Opera Android Full support 41	Safari iOS No support No	Samsung Internet Android Full support 6.0
`onremovesourcebuffer` Experimental	Chrome Full support 53	Edge Full support 17	Firefox Full support 42 Full support 42 No support 25 — 42 Notes Disabled Notes Limited support to an allowed list of sites, for example YouTube, Netflix, and other popular streaming sites. The limitation was removed when Media Source Extensions was enabled by default in Firefox 42. Disabled From version 25 until version 42 (exclusive): this feature is behind the `media.mediasource.enabled` preference. To change preferences in Firefox, visit about:config.	IE Full support 11 Notes Full support 11 Notes Notes Only works on Windows 8+.	Opera Full support 40	Safari Full support 8	WebView Android Full support 53	Chrome Android Full support 53	Firefox Android No support No	Opera Android Full support 41	Safari iOS No support No	Samsung Internet Android Full support 6.0

Legend

Full support: Full support
No support: No support
Experimental. Expect behavior to change in the future.: Experimental. Expect behavior to change in the future.
See implementation notes.: See implementation notes.
User must explicitly enable this feature.: User must explicitly enable this feature.
Requires a vendor prefix or different name for use.: Requires a vendor prefix or different name for use.