Missed the live Ionic Event? Check out all the product announcements, new releases, and more.

@capacitor/browser

The Browser API provides the ability to open an in-app browser and subscribe to browser events.

On iOS, this uses SFSafariViewController and is compliant with leading OAuth service in-app-browser requirements.

Install

npm install @capacitor/browser
npx cap sync

This plugin will use the following project variables (defined in your app’s variables.gradle file):

$androidxBrowserVersion: version of androidx.browser:browser (default: 1.3.0)

import { Browser } from '@capacitor/browser';

const openCapacitorSite = async () => {
  await Browser.open({ url: 'http://capacitorjs.com/' });
};

open(options: OpenOptions) => Promise<void>

Open a page with the specified options.

Param	Type
`options`	`OpenOptions`

Since: 1.0.0

close() => Promise<void>

Web & iOS only: Close an open browser window.

No-op on other platforms.

Since: 1.0.0

addListener(eventName: 'browserFinished', listenerFunc: () => void) => PluginListenerHandle

Android & iOS only: Listen for the loading finished event.

Param	Type
`eventName`	`'browserFinished'`
`listenerFunc`	`() => void`

Returns: PluginListenerHandle

Since: 1.0.0

addListener(eventName: 'browserPageLoaded', listenerFunc: () => void) => PluginListenerHandle

Android & iOS only: Listen for the page loaded event.

Param	Type
`eventName`	`'browserPageLoaded'`
`listenerFunc`	`() => void`

Returns: PluginListenerHandle

Since: 1.0.0

removeAllListeners() => void

Remove all native listeners for this plugin.

Since: 1.0.0

Represents the options passed to open.

Prop	Type	Description	Since
`url`	`string`	The URL to which the browser is opened.	1.0.0
`windowName`	`string`	Web only: Optional target for browser open. Follows the `target` property for window.open. Defaults to _blank. Ignored on other platforms.	1.0.0
`toolbarColor`	`string`	A hex color to which the toolbar color is set.	1.0.0
`presentationStyle`	`'fullscreen' \| 'popover'`	iOS only: The presentation style of the browser. Defaults to fullscreen. Ignored on other platforms.	1.0.0

Prop	Type
`remove`	`() => void`