<br />

> [!NOTE]
> **Important:** This API works **only on ChromeOS**.

<br />

<br />

## Description

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

<br />

<br />

## Permissions

`browser`  

<br />

<br />

## Availability

ChromeOS only

<br />

<br />

<br />

## Types

### OpenTabOptions

#### Properties

- url string

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

## Methods

### openTab()

Promise

```typescript
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 [OpenTabOptions](https://developer.chrome.com/docs/apps/reference/browser#type-OpenTabOptions)

  Configures how the tab should be opened.
- callback function optional


  The `callback` parameter looks like:

  ```typescript
  () => void
  ```

  <br />

#### Returns

- Promise\<void\>
  Chrome 117+


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

<br />