chrome.browser

Description

Use the chrome.browser API to interact with the Chrome browser associated with the current application and Chrome profile.

Permissions

browser

Types

OpenTabOptions

Properties

  • url

    string

    The URL to navigate to when the new tab is initially opened.

Methods

openTab()

Promise
chrome.browser.openTab(
  options: OpenTabOptions,
  callback?: function,
)

Opens a new tab in a browser window associated with the current application and Chrome profile. If no browser window for the Chrome profile is opened, a new one is opened prior to creating the new tab.

Parameters

  • options

    Configures how the tab should be opened.

  • callback

    function optional

    The callback parameter looks like:

    () => void

Returns

  • Promise<void>

    Chrome 117+

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.