browserSettings.newTabPosition

A BrowserSetting object that can be used to control the position of newly opened tabs relative to already open tabs.

The underlying value is a string that can take one of three values:

  • "afterCurrent": Open all new tabs next to the current tab.
  • "relatedAfterCurrent": The default. Open new tabs next to the current tab if they are related to the current tab (for example, if they were opened via a link in the current tab). Otherwise, open new tabs at the end of the tabstrip.
  • "atEnd": Open all tabs at the end of the tabstrip.

Examples

This code sets the value to "afterCurrent" and then logs the new value:

js
async function setAfterCurrent() {
  let result = await browser.browserSettings.newTabPosition.set({
    value: "afterCurrent",
  });
  console.log(`Result: ${result}`);
  let newValue = await browser.browserSettings.newTabPosition.get({});
  console.log(`New value: ${newValue.value}`);
}

Browser compatibility

desktop mobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
newTabPosition
Chrome – No support
Chrome
footnote No support
Edge – No support
Edge
footnote No support
Firefox – Full support
Firefox 61 (Release date: 2018-06-26)
footnote Full support
Opera – No support
Opera
footnote No support
Safari – No support
Safari
footnote No support
Firefox for Android – Full support
Firefox for Android 61 (Release date: 2018-06-26)
footnote
footnote This setting can be changed but has no effect.
Safari on iOS – No support
Safari on iOS
footnote No support

Legend

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

Full support
Full support
No support
No support
See implementation notes.