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
Stay organized with collections
Save and categorize content based on your preferences.
Description
Use the chrome.browser API to interact with the Chrome browser associated with the current application and Chrome profile.
Permissions
browserAvailability
ChromeOS only
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,
): Promise<void>
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
callbackparameter looks like:() => void
Returns
-
Promise<void>
Chrome 117+Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.