chrome.downloads.open()

chrome/common/extensions/api/downloads.idl

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 [permissions=downloads]
 namespace downloads {
   [inline_doc] dictionary HeaderNameValuePair {
     // Name of the HTTP header.
     DOMString name;
 
@@ skipping 340 matching lines @@
     // including state of the download, platform, registered file types and
     // visual theme. If a file icon cannot be determined, <a
     // href='extension.html#property-lastError'>chrome.extension.lastError</a>
     // will contain an error message.
     // |downloadId|: The identifier for the download.
     // |callback|: A URL to an image that represents the download.
     static void getFileIcon(long downloadId,
                             optional GetFileIconOptions options,
                             GetFileIconCallback callback);
 
+    // Open the downloaded file now if the <a
+    // href='#type-DownloadItem'>DownloadItem</a> is complete, or when it
+    // completes if it's still in progress. An <a
+    // href='#event-onChanged'>onChanged</a> event will fire when the item is
+    // opened for the first time.
+    // |downloadId|: The identifier for the download.
+    static void open(long downloadId);
+
     // Erase matching <a href='#type-DownloadItem'>DownloadItems</a> from
     // history
     [nodoc] static void erase(DownloadQuery query,
                               optional EraseCallback callback);
 
     // TODO(benjhayden) Comment.
     [nodoc] static void setDestination(long downloadId, DOMString relativePath);
 
     // Prompt the user to either accept or cancel a dangerous download.
     // <code>acceptDanger()</code> does not automatically accept dangerous
     // downloads.
     [nodoc] static void acceptDanger(long downloadId);
 
     // Show the downloaded file in its folder in a file manager.
     [nodoc] static void show(long downloadId);
 
-    // Open the downloaded file.
-    [nodoc] static void open(long downloadId);
-
     // Initiate dragging the file to another application.
     [nodoc] static void drag(long downloadId);
   };
 
   interface Events {
     // This event fires with the <a href='#type-DownloadItem'>DownloadItem</a>
     // object when a download begins.
     static void onCreated(DownloadItem downloadItem);
 
     // Fires with the <code>downloadId</code> when a download is erased from
     // history.
     // |downloadId|: The <code>id</code> of the <a href='#type-DownloadItem'>DownloadItem</a> that was erased.
     static void onErased(long downloadId);
 
     // When any of a <a href='#type-DownloadItem'>DownloadItem</a>'s properties
     // except <code>bytesReceived</code> changes, this event fires with the
     // <code>downloadId</code> and an object containing the properties that changed.
     static void onChanged(DownloadDelta downloadDelta);
   };
 };