Implementation of the "Redirect URLs to Packaged Apps" feature.

chrome/common/extensions/api/app_runtime.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.
 
 namespace app.runtime {
 
   [inline_doc] dictionary LaunchItem {
     // FileEntry for the file.
     [instanceOf=FileEntry] object entry;
 
     // The MIME type of the file.
     DOMString type;
   };
 
   // Optional data for the launch.
   [inline_doc] dictionary LaunchData {
-    // The id of the file handler that the app is being invoked with.
+    // The id of the file or URL handler that the app is being invoked with.
     DOMString? id;
 
+    // Option 1: the file enries for onLaunched corresponding to a file
+    // handler (file_handlers in the manifest).
     LaunchItem[]? items;
+
+    // Option 2: the URL and referrer's URL for onLaunched corresponding to
+    // a URL handler (url_handlers in the manifest).
+    DOMString? url;
+    DOMString? referrerUrl;

[asargent_no_longer_on_chrome, 2013/08/14 18:05:12]

We might consider wrapping these 2 together into a separate dictionary, e.g.

[inline_doc] dictionary RedirectedUrlData {
  DOMString url;
  DOMString? referrerUrl;  // Null for omnibox navigations, bookmark clicks,
etc.
};

[inline_doc] dictionary LaunchData {
  ...
  RedirectedUrlData? redirect;
  ...
};


That gives a clean separation if we think we might someday want to provide some
additional information, e.g. an enum of "navigation type", etc.

[sergeygs, 2013/08/18 11:40:24]

This would be visible on the external API side, in the signature of onLaunched,
and no objection/suggestion has ever come up in the API reviews about the
proposed signature, so I'm not sure I'm at liberty to do that change.
On 2013/08/14 18:05:12, Antony Sargent wrote:

   };
 
   interface Events {
     // Fired when an app is launched from the launcher.
     static void onLaunched(optional LaunchData launchData);
 
     // Fired at Chrome startup to apps that were running when Chrome last shut
     // down.
     static void onRestarted();
   };
 };