tabs.getCurrent()

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.

Syntax

js

const gettingCurrent = browser.tabs.getCurrent()

Parameters

None.

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.

Examples

Get information about the current tab:

js

function onGot(tabInfo) {
  console.log(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.