opera.extension.tabs.getSelected()

By Opera Software

From Opera 15 onward, Opera 11 & 12’s extension format is no longer supported, and instead, we’ve switched to Chromium’s extension model. Check out our new documentation for developing extensions for Opera 15 and higher and start building your own extensions.

Description:

The getSelected() method provides a way to obtain the currently selected browser tab, either globally or within the context window or context tab group. The value returned is based on the following algorithm:

  1. If this is the global tab manager, return a BrowserTab object representing the currently selected browser tab within the currently selected browser window, if any. Otherwise, return null.
  2. If this is a window tab manager, return a BrowserTab object representing the currently selected browser tab within the context window, if any. Otherwise, return null.
  3. If this is a group tab manager, return a BrowserTab object representing the currently selected browser tab within the context tab group, if any. Otherwise, return null.

Parameters:

None

Syntax:

BrowserTab getSelected ()

Example:

The following example creates a button on the browser toolbar. When the button is clicked, the current tab is detected and a tab is then created to the left of it.

//
// The background process (e.g. index.html)
//

// Specify the properties of the button before creating it.
var UIItemProperties = {
  disabled: false,
  title: "Example extension",
  icon: "images/icon_18.png",
  onclick: function() {
    // Get the current tab as a BrowserTab object
    var thisTab = opera.extension.tabs.getSelected();

    // Create a tab with the specified URL
    var tab = opera.extension.tabs.create({url: 'http://dev.opera.com/'}, thisTab);
  }
};

// Create the button and add it to the toolbar.
var button = opera.contexts.toolbar.createItem( UIItemProperties );
opera.contexts.toolbar.addItem(button);

This article is licensed under a Creative Commons Attribution 3.0 Unported license.

Comments

  • photo

    Janghou

    Thursday, May 31, 2012

    This function isn't supported in 11.64, probably only 12+
    `Uncaught exception: TypeError: 'opera.extension.tabs.getSelected' is not a function`

    use getFocused() instead
No new comments accepted.