Welcome What's new in Chrome extensions API reference Samples
Welcome What's new in Chrome extensions API reference Samples

chrome.browser

This API is part of the Chrome Apps platform, which was deprecated in 2020. It remains supported for Enterprise and Education customers on ChromeOS until at least Jan 2025. Learn more about migrating your app.
  • Description

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

  • Permissions
    browser

Summary

Types

OpenTabOptions

Properties

  • url

    string

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

Methods

openTab

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

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

  • Configures how the tab should be opened.

  • callback

    function optional

    The callback parameter looks like: () => void

Returns

  • Promise<void>

    Chrome 117+

    Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback.

This site uses cookies to deliver and enhance the quality of its services and to analyze traffic. If you agree, cookies are also used to serve advertising and to personalize the content and advertisements that you see. Learn more about our use of cookies.