tabs.warmup()

To optimize system resource usage, browsers may drop GPU resources associated with tabs that the user has not accessed for a certain amount of time. If a browser has done this for a tab, then reactivating the tab (for example, when the user switches to it) may take longer than it normally would.

The tabs.warmup() API enables an extension to start the process of rendering the resources for an inactive tab, if the extension expects that the user might switch to the tab soon. This then makes the actual tab switch faster than it would be otherwise.

Note this API does not work on discarded tabs and does not need to be called immediately prior to switching tabs. It is merely a performance improvement when the tab switch can be anticipated, such as when hovering over a button that when clicked would switch to the tab.

It is expected that this API would mostly be useful to tab management extensions.

This is an asynchronous function that returns a Promise.

Syntax

js
let warming = browser.tabs.warmup(
  tabId               // integer
)

Parameters

tabId

integer. ID of the tab to warm up. If the argument passed here is not an integer (in particular, if it is null or undefined) then warmup() will throw an exception synchronously.

Return value

A Promise that will be fulfilled with no arguments if the tab identified by tabId is successfully warmed up. If tabId does not identify an open tab, or if warming up fails for some other reason, then the promise will be rejected with an error message.

Examples

This code adds a listener to the browserAction.onClicked event. The listener retrieves all tabs in the current window that contain pages under "https://developer.mozilla.org/" and warms up the first one that it finds.

js
function onSuccess() {
  console.log("success!");
}

function onFailure(error) {
  // e.g. ID of a nonexistent tab
  console.error(error);
}

async function warmupMDN() {
  const mdnTabs = await browser.tabs.query({
    currentWindow: true,
    url: "https://developer.mozilla.org/*",
  });

  if (mdnTabs.length > 0) {
    const warming = browser.tabs.warmup(mdnTabs[0].id);
    warming.then(onSuccess, onFailure);
  }
}

browser.browserAction.onClicked.addListener(warmupMDN);

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
warmup

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support