« 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 update() method provides a way to update the properties of a browser tab.



void update (BrowserTabProperties properties)


The following example creates a button on the browser toolbar. When the button is clicked, the current tab is detected and is then locked (pinned).

// 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() {
    // Detect the currently selected tab
    var thisTab = opera.extension.tabs.getSelected();
    // Make the current tab locked (pinned)
    thisTab.update({locked: true});

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