This page is part of the documentation for 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.

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

OpenTabOptions

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.