« Documentation Home

BrowserWindow.tabs

This documentation relates to Opera's now deprecated .oex Extension API framework for Opera versions <= 12.15 and also provided by our OEX2NEX shim library.

For the latest Opera Extensions API documentation for Opera versions > 12.15 please consult the latest Opera Extensions API documentation online.

Description:

The readonly tabs attribute exposes a window tab manager. The window tab manager is an object that implements the BrowserTabManager interface and manages all browser tabs that are currently open within the context window.

Syntax:

readonly BrowserTabManager tabs

Example:

The following example creates a button in the browser toolbar. When the button is clicked, the last focused window is detected. The number of tabs in the window, including any tab groups, is then displayed in the button's badge.

//
// 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",
  badge: {
    backgroundColor: '#cc0000',
    color: '#ffffff'
  }
};

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

button.addEventListener('click', handleClick, false);

function handleClick() {
  // Get the last focused window
  var win = opera.extension.windows.getLastFocused();
  
  // Get all tabs in the window
  var groups = win.tabs.getAll();
  
  // Display the number of tabs in the button's badge
  button.badge.textContent = groups.length;
}