/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this file,
 * You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * The origin of this IDL file is
 * http://dvcs.w3.org/hg/html-media/raw-file/default/media-source/media-source.html
 *
 * Copyright © 2012 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C
 * liability, trademark and document use rules apply.
 */

enum MediaSourceReadyState {
  "closed",
  "open",
  "ended"
};

enum MediaSourceEndOfStreamError {
  "network",
  "decode"
};

[Pref="media.mediasource.enabled",
 Exposed=Window]
interface MediaSource : EventTarget {
  [Throws]
  constructor();

  readonly attribute SourceBufferList sourceBuffers;
  readonly attribute SourceBufferList activeSourceBuffers;
  readonly attribute MediaSourceReadyState readyState;
  [SetterThrows]
  attribute unrestricted double duration;
  attribute EventHandler onsourceopen;
  attribute EventHandler onsourceended;
  attribute EventHandler onsourceclose;
  [NewObject, Throws]
  SourceBuffer addSourceBuffer(DOMString type);
  [Throws]
  undefined removeSourceBuffer(SourceBuffer sourceBuffer);
  [Throws]
  undefined endOfStream(optional MediaSourceEndOfStreamError error);
  [Throws]
  undefined setLiveSeekableRange(double start, double end);
  [Throws]
  undefined clearLiveSeekableRange();
  static boolean isTypeSupported(DOMString type);
  [NewObject, ChromeOnly]
  Promise<MediaSourceDecoderDebugInfo> mozDebugReaderData();
};