src/chrome/common/extensions/api/browser.idl

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 // Use the <code>chrome.browser</code> API to interact with the Chrome browser
   6 // associated with the current application and Chrome profile.
   7 [nodoc] namespace browser {
   8   // Options for the $(ref:openTab) function.
   9   dictionary OpenTabOptions {
  10     // The URL to navigate to when the new tab is initially opened.
  11     DOMString url;
  12   };
  13
  14   callback Callback = void();
  15
  16   interface Functions {
  17     // Opens a new tab in a browser window associated with the current
  18     // application and Chrome profile. If no browser window for the Chrome
  19     // profile is opened, a new one is opened prior to creating the new tab. The
  20     // initial URL of the new tab is specified in |options|.
  21     // |options|  : The $(ref:OpenTabOptions) for this function.
  22     // |callback| : Called to indicate success or failure.
  23     static void openTab(OpenTabOptions options,
  24                         Callback callback);
  25   };
  26 };