index.md

---

title: tabs.getCurrent()
slug: Mozilla/Add-ons/WebExtensions/API/tabs/getCurrent
page-type: webextension-api-function
tags:
  - API
  - Add-ons
  - Extensions
  - Method
  - Non-standard
  - Reference
  - WebExtensions
  - getCurrent
  - tabs
browser-compat: webextensions.api.tabs.getCurrent

---

{{AddonSidebar()}}

Get a {{WebExtAPIRef("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 {{jsxref("Promise")}}.

Syntax

const gettingCurrent = browser.tabs.getCurrent()

Parameters

None.

Return value

A {{jsxref("Promise")}} that will be fulfilled with a {{WebExtAPIRef('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:

function onGot(tabInfo) {
  console.log(tabInfo);
}

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

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

{{WebExtExamples}}

Browser compatibility

{{Compat}}

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