« Documentation Home


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.


The readonly position attribute gets the tab position of this browser tab group, if the tab group is open. Otherwise, it returns NaN.


readonly unsigned long position


The following example creates a button on the browser toolbar. When the button is clicked, the position of the first tab group is 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 );  

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

function handleClick() {
  // Get all tab groups in the current window
  var groups = opera.extension.tabGroups.getAll();
  // Display the first group's position in the button's badge
  button.badge.textContent = groups[0].position;