SourceBuffer: update event

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 update event of the SourceBuffer interface signals the successful completion of an SourceBuffer.appendBuffer() or SourceBuffer.remove() operation. The updating attribute transitions from true to false. This event is fired before the updateend event.

Syntax

Use the event name in methods like addEventListener(), or set an event handler property.

js
addEventListener("update", (event) => { })

onupdate = (event) => { }

Event type

A generic Event.

Examples

Handling the update event after appending data

This example demonstrates how to handle the update event after a successful appendBuffer() operation.

js
const sourceBuffer = source.addSourceBuffer(mimeCodec);
sourceBuffer.addEventListener("error", () => {
  downloadStatus.textContent = "Error occurred during decoding";
});
sourceBuffer.addEventListener("update", () => {
  downloadStatus.textContent = "Done";
});
sourceBuffer.addEventListener("updateend", () => {
  source.endOfStream();
});
downloadStatus.textContent = "Downloading...";
fetch(assetURL)
  .then((response) => response.arrayBuffer())
  .then((data) => {
    downloadStatus.textContent = "Decoding...";
    sourceBuffer.appendBuffer(data);
  });

Specifications

Specification
Media Source Extensions™
# dfn-update
Media Source Extensions™
# dom-sourcebuffer-onupdate

Browser compatibility

See also