« Documentation Home

BrowserTab.faviconUrl

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 faviconUrl attribute exposes the current favicon for the browser tab. On getting, the browser returns the URL of the favicon for the current document if an icon exists and if the browser tab is not closed. Otherwise, an empty string is returned.

Syntax:

readonly string faviconUrl // maps to document.readyState

Example:

The following example creates a button on the browser toolbar. When the button is clicked, the URL of the current tab's favicon is retrieved. Then a new tab is opened containing the favicon.

//
// 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 currently selected tab
    var thisTab = opera.extension.tabs.getSelected();
    
    // Get the URL of its favicon
    var favicon = thisTab.faviconUrl;
    
    // Create a new tab containing the favicon
    opera.extension.tabs.create({url: favicon});
  }
};

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