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};
27