Get a tabs.Tab containing information about the tab that this script is running in.

Note: This function is only useful in contexts where there is a browser tab, such as an options page.

If you call it from a background script or a popup, it will return undefined.

This is an asynchronous function that returns a Promise.


const gettingCurrent = browser.tabs.getCurrent()



Return value

A Promise that will be fulfilled with a tabs.Tab object containing information about the current tab. If any error occurs the promise will be rejected with an error message.


Get information about the current tab:

function onGot(tabInfo) {

function onError(error) {
  console.log(`Error: ${error}`);

const gettingCurrent = browser.tabs.getCurrent();
gettingCurrent.then(onGot, onError);

Browser compatibility

BCD tables only load in the browser

Note: This API is based on Chromium's chrome.tabs API. This documentation is derived from tabs.json in the Chromium code.