diff -r 000000000000 -r 6474c204b198 dom/webidl/Downloads.webidl
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/dom/webidl/Downloads.webidl	Wed Dec 31 06:09:35 2014 +0100
@@ -0,0 +1,89 @@
+/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* 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/.
+ */
+
+// Represents the state of a download.
+// "downloading": The resource is actively transfering.
+// "stopped"    : No network tranfer is happening.
+// "succeeded"  : The resource has been downloaded successfully.
+// "finalized"  : We won't try to download this resource, but the DOM
+//                object is still alive.
+enum DownloadState {
+  "downloading",
+  "stopped",
+  "succeeded",
+  "finalized"
+};
+
+//
+// XXXTODO: When we have a generic way to do feature detection in marketplace
+//          we will *STOP* using the pref and use the function like DOMDownload
+//          and DownloadEvent.
+//
+[NoInterfaceObject,
+ NavigatorProperty="mozDownloadManager",
+ JSImplementation="@mozilla.org/downloads/manager;1",
+ Pref="dom.mozDownloads.enabled"]
+interface DOMDownloadManager : EventTarget {
+  // This promise returns an array of downloads with all the current
+  // download objects.
+  Promise getDownloads();
+
+  // Removes one download from the downloads set. Returns a promise resolved
+  // with the finalized download.
+  Promise remove(DOMDownload download);
+
+  // Removes all the completed downloads from the set.
+  Promise clearAllDone();
+
+  // Fires when a new download starts.
+  attribute EventHandler ondownloadstart;
+};
+
+[JSImplementation="@mozilla.org/downloads/download;1",
+ Func="Navigator::HasDownloadsSupport"]
+interface DOMDownload : EventTarget {
+  // The full size of the resource.
+  readonly attribute long long totalBytes;
+
+  // The number of bytes that we have currently downloaded.
+  readonly attribute long long currentBytes;
+
+  // The url of the resource.
+  readonly attribute DOMString url;
+
+  // The path in local storage where the file will end up once the download
+  // is complete.
+  readonly attribute DOMString path;
+
+  // The state of the download.
+  readonly attribute DownloadState state;
+
+  // The mime type for this resource.
+  readonly attribute DOMString contentType;
+
+  // The timestamp this download started.
+  readonly attribute Date startTime;
+
+  // An opaque identifier for this download. All instances of the same
+  // download (eg. in different windows) will have the same id.
+  readonly attribute DOMString id;
+
+  // A DOM error object, that will be not null when a download is stopped
+  // because something failed.
+  readonly attribute DOMError? error;
+
+  // Pauses the download.
+  Promise pause();
+
+  // Resumes the download. This resolves only once the download has
+  // succeeded.
+  Promise resume();
+
+  // This event is triggered anytime a property of the object changes:
+  // - when the transfer progresses, updating currentBytes.
+  // - when the state and/or error attributes change.
+  attribute EventHandler onstatechange;
+};