opera.extension.tabs.getAll()

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 getAll() method provides a way to obtain a tab collection. The value returned is based on the following algorithm:

  1. If this is the global tab manager, return an array of BrowserTab objects representing each browser tab that is currently open.
  2. If this is a window tab manager, return an array of BrowserTab objects representing each browser tab that is currently open within the context window.
  3. If this is a group tab manager, return an array of BrowserTab objects representing each browser tab that is currently open within the context tab group.

Parameters:

None

Syntax:

BrowserTab[] getAll ()

Example:

The following example creates a button on the toolbar. When the button is clicked, the number of browser tabs currently open, including tab groups, is shown 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() {
  var tabs = opera.extension.tabs.getAll();
  button.badge.textContent = tabs.length;
}

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

Comments

No new comments accepted.