Tab

Summary

The Tab object represents a browser tab, and provides access to the browser and the DOM content window hosted by that tab.

You access Tab objects from the BrowserApp object. BrowserApp provides access to all tabs through its tabs property, and to the currently selected tab through its selectedTab property.

Properties

id

An identifier for this tab.

browser

The XUL browser object hosted by this tab.

window

The DOM content window hosted by this tab.

Examples

This function retrieves the array of open tabs from BrowserApp, then fetches each tab's DOM content window, and logs the title of the DOM document loaded into the window:

function logTabTitles(window) {
  var tabs = window.BrowserApp.tabs;
  tabs.forEach(function(tab) {
    window.console.log(tab.window.document.title);
  });
}

This function retrieves the selected tab, then retrieves its browser property, which it uses to log the current tab's session history:

function logSelectedTabHistory(window) {
  var tab = window.BrowserApp.selectedTab;
  var enumerator = tab.browser.sessionHistory.SHistoryEnumerator;
  while (enumerator.hasMoreElements()) {
    var historyEntry = enumerator.getNext().QueryInterface(Components.interfaces.nsIHistoryEntry);
    window.console.log(historyEntry.URI.spec);
  }
}

If you want to retrieve the selected tab's URL, use this code:

var url = window.BrowserApp.selectedTab.browser.currentURI.spec;