@capawesome/capacitor-in-app-browser 0.0.1 → 0.1.0

package/README.md

@@ -1,4 +1,4 @@
-# @capawesome/capacitor-in-app-browser
+# Capacitor In-App Browser Plugin
 
 Capacitor plugin to open URLs in the external browser, the system browser or an embedded web view.
 
@@ -10,7 +10,7 @@ Capacitor plugin to open URLs in the external browser, the system browser or an
 
 ## Features
 
-We are proud to offer one of the most complete and feature-rich Capacitor plugins for in-app browsing. Here are some of the key features:
+The Capacitor In-App Browser plugin is one of the most complete in-app browsing solutions for Capacitor apps. Here are some of the key features:
 
 - 🌐 **Three browser modes**: Open URLs in the external browser, the system browser (Custom Tabs on Android, `SFSafariViewController` on iOS) or an embedded web view.
 - 🧭 **Navigation events**: Get notified when the browser is closed, a page has been loaded or a navigation has been completed.
@@ -24,9 +24,15 @@ We are proud to offer one of the most complete and feature-rich Capacitor plugin
 
 Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look!
 
-## Newsletter
+## Use Cases
 
-Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).
+The In-App Browser plugin is typically used whenever an app needs to display web content without losing the user, for example:
+
+- **External links**: Open links, terms of service, or documentation in the system browser without leaving the app context.
+- **Login and checkout flows**: Open a web-based flow in the embedded web view and watch for a redirect using the `browserUrlChanged` event.
+- **Hybrid web content**: Embed a web page with a themed native toolbar and exchange messages between the app and the page.
+- **Background loading**: Load a URL in a hidden web view with the `visible` option and present it once the page has loaded.
+- **Session control**: Clear the cache and session data of the web view, or use an isolated data store on iOS.
 
 ## Compatibility
 
@@ -96,6 +102,12 @@ No configuration required for this plugin.
 
 ## Usage
 
+The following examples show how to open URLs in the external, system, and in-app browsers, control the embedded web view, exchange messages with the loaded page, clear browsing data, and listen for browser events.
+
+### Open a URL in the external browser
+
+Open a URL in the default browser app of the device. Since the browser is opened in a separate app, no events are emitted in this mode:
+
 ```typescript
 import { InAppBrowser } from '@capawesome/capacitor-in-app-browser';
 
@@ -104,6 +116,14 @@ const openInExternalBrowser = async () => {
     url: 'https://capawesome.io',
   });
 };
+```
+
+### Open a URL in the system browser
+
+Open a URL in the system browser (Custom Tabs on Android, `SFSafariViewController` on iOS) and customize the toolbar with platform-specific options. Only available on Android and iOS:
+
+```typescript
+import { InAppBrowser } from '@capawesome/capacitor-in-app-browser';
 
 const openInSystemBrowser = async () => {
   await InAppBrowser.openInSystemBrowser({
@@ -118,6 +138,14 @@ const openInSystemBrowser = async () => {
     },
   });
 };
+```
+
+### Open a URL in an embedded web view
+
+Open a URL in an embedded web view with a native toolbar whose color, title, and buttons can be customized. Only available on Android and iOS:
+
+```typescript
+import { InAppBrowser } from '@capawesome/capacitor-in-app-browser';
 
 const openInWebView = async () => {
   await InAppBrowser.openInWebView({
@@ -129,10 +157,26 @@ const openInWebView = async () => {
     },
   });
 };
+```
+
+### Close the browser
+
+Close the currently open browser. This closes browsers opened with `openInWebView(...)` or `openInSystemBrowser(...)`. Only available on Android and iOS:
+
+```typescript
+import { InAppBrowser } from '@capawesome/capacitor-in-app-browser';
 
 const close = async () => {
   await InAppBrowser.close();
 };
+```
+
+### Execute JavaScript in the web view
+
+Execute any JavaScript code in the currently open web view. This method is only available for browsers opened with `openInWebView(...)` on Android and iOS:
+
+```typescript
+import { InAppBrowser } from '@capawesome/capacitor-in-app-browser';
 
 const executeScript = async () => {
   const { result } = await InAppBrowser.executeScript({
@@ -140,12 +184,28 @@ const executeScript = async () => {
   });
   return result;
 };
+```
+
+### Post a message to the web page
+
+Post a message to the currently open web view. The web page receives the message by listening for the `capacitorInAppBrowserMessage` window event, see [Messaging](#messaging). This method is only available for browsers opened with `openInWebView(...)` on Android and iOS:
+
+```typescript
+import { InAppBrowser } from '@capawesome/capacitor-in-app-browser';
 
 const postMessage = async () => {
   await InAppBrowser.postMessage({
     data: { name: 'Capawesome' },
   });
 };
+```
+
+### Clear the cache and session data
+
+Clear the cache or the session data (cookies and web storage) of the web view. Only available on Android and iOS:
+
+```typescript
+import { InAppBrowser } from '@capawesome/capacitor-in-app-browser';
 
 const clearCache = async () => {
   await InAppBrowser.clearCache();
@@ -154,19 +214,30 @@ const clearCache = async () => {
 const clearSessionData = async () => {
   await InAppBrowser.clearSessionData();
 };
+```
+
+### Listen for browser events
+
+Get notified when the browser is closed, a message is received, a navigation has been completed, a page has been loaded, or the URL has changed:
+
+```typescript
+import { InAppBrowser } from '@capawesome/capacitor-in-app-browser';
 
 const addListeners = async () => {
   await InAppBrowser.addListener('browserClosed', () => {
     console.log('Browser closed');
   });
-  await InAppBrowser.addListener('browserPageLoaded', () => {
-    console.log('Browser page loaded');
+  await InAppBrowser.addListener('browserMessageReceived', event => {
+    console.log('Message received', event.data);
   });
-  await InAppBrowser.addListener('browserPageNavigationCompleted', event => {
+  await InAppBrowser.addListener('browserNavigationCompleted', event => {
     console.log('Navigation completed', event.url);
   });
-  await InAppBrowser.addListener('messageReceived', event => {
-    console.log('Message received', event.data);
+  await InAppBrowser.addListener('browserPageLoaded', () => {
+    console.log('Browser page loaded');
+  });
+  await InAppBrowser.addListener('browserUrlChanged', event => {
+    console.log('URL changed', event.url);
   });
 };
 ```
@@ -184,10 +255,12 @@ const addListeners = async () => {
 * [`openInSystemBrowser(...)`](#openinsystembrowser)
 * [`openInWebView(...)`](#openinwebview)
 * [`postMessage(...)`](#postmessage)
+* [`show()`](#show)
 * [`addListener('browserClosed', ...)`](#addlistenerbrowserclosed-)
+* [`addListener('browserMessageReceived', ...)`](#addlistenerbrowsermessagereceived-)
+* [`addListener('browserNavigationCompleted', ...)`](#addlistenerbrowsernavigationcompleted-)
 * [`addListener('browserPageLoaded', ...)`](#addlistenerbrowserpageloaded-)
-* [`addListener('browserPageNavigationCompleted', ...)`](#addlistenerbrowserpagenavigationcompleted-)
-* [`addListener('messageReceived', ...)`](#addlistenermessagereceived-)
+* [`addListener('browserUrlChanged', ...)`](#addlistenerbrowserurlchanged-)
 * [`removeAllListeners()`](#removealllisteners)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
@@ -375,6 +448,24 @@ Only available on Android and iOS.
 --------------------
 
 
+### show()
+
+```typescript
+show() => Promise<void>
+```
+
+Show the web view if it was opened with `visible: false`.
+
+This method is only available for browsers opened with
+`openInWebView(...)`.
+
+Only available on Android and iOS.
+
+**Since:** 0.1.0
+
+--------------------
+
+
 ### addListener('browserClosed', ...)
 
 ```typescript
@@ -397,23 +488,23 @@ Only available on Android and iOS.
 --------------------
 
 
-### addListener('browserPageLoaded', ...)
+### addListener('browserMessageReceived', ...)
 
 ```typescript
-addListener(eventName: 'browserPageLoaded', listenerFunc: () => void) => Promise<PluginListenerHandle>
+addListener(eventName: 'browserMessageReceived', listenerFunc: (event: BrowserMessageReceivedEvent) => void) => Promise<PluginListenerHandle>
 ```
 
-Called when the initial page of the browser has finished loading.
+Called when the web page posts a message to the app using the injected
+`window.CapacitorInAppBrowser.postMessage(...)` function.
 
-On Android, this event is only emitted for browsers opened with
-`openInWebView(...)`.
+This event is only emitted for browsers opened with `openInWebView(...)`.
 
 Only available on Android and iOS.
 
-| Param              | Type                             |
-| ------------------ | -------------------------------- |
-| **`eventName`**    | <code>'browserPageLoaded'</code> |
-| **`listenerFunc`** | <code>() =&gt; void</code>       |
+| Param              | Type                                                                                                    |
+| ------------------ | ------------------------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code>'browserMessageReceived'</code>                                                                   |
+| **`listenerFunc`** | <code>(event: <a href="#browsermessagereceivedevent">BrowserMessageReceivedEvent</a>) =&gt; void</code> |
 
 **Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
 
@@ -422,10 +513,10 @@ Only available on Android and iOS.
 --------------------
 
 
-### addListener('browserPageNavigationCompleted', ...)
+### addListener('browserNavigationCompleted', ...)
 
 ```typescript
-addListener(eventName: 'browserPageNavigationCompleted', listenerFunc: (event: BrowserPageNavigationCompletedEvent) => void) => Promise<PluginListenerHandle>
+addListener(eventName: 'browserNavigationCompleted', listenerFunc: (event: BrowserNavigationCompletedEvent) => void) => Promise<PluginListenerHandle>
 ```
 
 Called when a page navigation has been completed in the web view.
@@ -434,10 +525,10 @@ This event is only emitted for browsers opened with `openInWebView(...)`.
 
 Only available on Android and iOS.
 
-| Param              | Type                                                                                                                    |
-| ------------------ | ----------------------------------------------------------------------------------------------------------------------- |
-| **`eventName`**    | <code>'browserPageNavigationCompleted'</code>                                                                           |
-| **`listenerFunc`** | <code>(event: <a href="#browserpagenavigationcompletedevent">BrowserPageNavigationCompletedEvent</a>) =&gt; void</code> |
+| Param              | Type                                                                                                            |
+| ------------------ | --------------------------------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code>'browserNavigationCompleted'</code>                                                                       |
+| **`listenerFunc`** | <code>(event: <a href="#browsernavigationcompletedevent">BrowserNavigationCompletedEvent</a>) =&gt; void</code> |
 
 **Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
 
@@ -446,23 +537,52 @@ Only available on Android and iOS.
 --------------------
 
 
-### addListener('messageReceived', ...)
+### addListener('browserPageLoaded', ...)
 
 ```typescript
-addListener(eventName: 'messageReceived', listenerFunc: (event: MessageReceivedEvent) => void) => Promise<PluginListenerHandle>
+addListener(eventName: 'browserPageLoaded', listenerFunc: () => void) => Promise<PluginListenerHandle>
 ```
 
-Called when the web page posts a message to the app using the injected
-`window.CapacitorInAppBrowser.postMessage(...)` function.
+Called when the initial page of the browser has finished loading.
+
+On Android, this event is only emitted for browsers opened with
+`openInWebView(...)`.
+
+Only available on Android and iOS.
+
+| Param              | Type                             |
+| ------------------ | -------------------------------- |
+| **`eventName`**    | <code>'browserPageLoaded'</code> |
+| **`listenerFunc`** | <code>() =&gt; void</code>       |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### addListener('browserUrlChanged', ...)
+
+```typescript
+addListener(eventName: 'browserUrlChanged', listenerFunc: (event: BrowserUrlChangedEvent) => void) => Promise<PluginListenerHandle>
+```
+
+Called when the current URL of the web view changes, e.g. when the user
+navigates to a new page, a server redirect occurs, or a single-page
+application updates the browser history.
+
+This event is also emitted for the initial URL and fires earlier than
+`browserNavigationCompleted`.
 
 This event is only emitted for browsers opened with `openInWebView(...)`.
 
 Only available on Android and iOS.
 
-| Param              | Type                                                                                      |
-| ------------------ | ----------------------------------------------------------------------------------------- |
-| **`eventName`**    | <code>'messageReceived'</code>                                                            |
-| **`listenerFunc`** | <code>(event: <a href="#messagereceivedevent">MessageReceivedEvent</a>) =&gt; void</code> |
+| Param              | Type                                                                                          |
+| ------------------ | --------------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code>'browserUrlChanged'</code>                                                              |
+| **`listenerFunc`** | <code>(event: <a href="#browserurlchangedevent">BrowserUrlChangedEvent</a>) =&gt; void</code> |
 
 **Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
 
@@ -552,16 +672,17 @@ Remove all listeners for this plugin.
 
 #### OpenInWebViewOptions
 
-| Prop                                  | Type                                                                                | Description                                                                                                                                                       | Default               | Since |
-| ------------------------------------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ----- |
-| **`android`**                         | <code><a href="#openinwebviewandroidoptions">OpenInWebViewAndroidOptions</a></code> | Options that are only applied on Android. Only available on Android.                                                                                              |                       | 0.1.0 |
-| **`dataStore`**                       | <code><a href="#webviewdatastore">WebViewDataStore</a></code>                       | The data store to use for the web view. On Android, this option is ignored. The web view always uses the app-global (`shared`) data store. Only available on iOS. | <code>'shared'</code> | 0.1.0 |
-| **`headers`**                         | <code>{ [key: string]: string; }</code>                                             | Additional HTTP headers to send with the initial request.                                                                                                         |                       | 0.1.0 |
-| **`ios`**                             | <code><a href="#openinwebviewiosoptions">OpenInWebViewIosOptions</a></code>         | Options that are only applied on iOS. Only available on iOS.                                                                                                      |                       | 0.1.0 |
-| **`mediaPlaybackRequiresUserAction`** | <code>boolean</code>                                                                | Whether or not media playback requires user action.                                                                                                               | <code>false</code>    | 0.1.0 |
-| **`toolbar`**                         | <code><a href="#webviewtoolbaroptions">WebViewToolbarOptions</a></code>             | Options for the toolbar of the web view.                                                                                                                          |                       | 0.1.0 |
-| **`url`**                             | <code>string</code>                                                                 | The URL to open in the web view.                                                                                                                                  |                       | 0.1.0 |
-| **`userAgent`**                       | <code>string</code>                                                                 | The custom user agent to use for the web view.                                                                                                                    |                       | 0.1.0 |
+| Prop                                  | Type                                                                                | Description                                                                                                                                                                                                                                                        | Default               | Since |
+| ------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------- | ----- |
+| **`android`**                         | <code><a href="#openinwebviewandroidoptions">OpenInWebViewAndroidOptions</a></code> | Options that are only applied on Android. Only available on Android.                                                                                                                                                                                               |                       | 0.1.0 |
+| **`dataStore`**                       | <code><a href="#webviewdatastore">WebViewDataStore</a></code>                       | The data store to use for the web view. On Android, this option is ignored. The web view always uses the app-global (`shared`) data store. Only available on iOS.                                                                                                  | <code>'shared'</code> | 0.1.0 |
+| **`headers`**                         | <code>{ [key: string]: string; }</code>                                             | Additional HTTP headers to send with the initial request.                                                                                                                                                                                                          |                       | 0.1.0 |
+| **`ios`**                             | <code><a href="#openinwebviewiosoptions">OpenInWebViewIosOptions</a></code>         | Options that are only applied on iOS. Only available on iOS.                                                                                                                                                                                                       |                       | 0.1.0 |
+| **`mediaPlaybackRequiresUserAction`** | <code>boolean</code>                                                                | Whether or not media playback requires user action.                                                                                                                                                                                                                | <code>false</code>    | 0.1.0 |
+| **`toolbar`**                         | <code><a href="#webviewtoolbaroptions">WebViewToolbarOptions</a></code>             | Options for the toolbar of the web view.                                                                                                                                                                                                                           |                       | 0.1.0 |
+| **`url`**                             | <code>string</code>                                                                 | The URL to open in the web view.                                                                                                                                                                                                                                   |                       | 0.1.0 |
+| **`userAgent`**                       | <code>string</code>                                                                 | The custom user agent to use for the web view.                                                                                                                                                                                                                     |                       | 0.1.0 |
+| **`visible`**                         | <code>boolean</code>                                                                | Whether or not the web view is presented when opened. If `false`, the web view loads the URL in the background and stays hidden until `show()` is called. The `browserPageLoaded` event is still emitted and `close()` can be called while the web view is hidden. | <code>true</code>     | 0.1.0 |
 
 
 #### OpenInWebViewAndroidOptions
@@ -608,18 +729,25 @@ Remove all listeners for this plugin.
 | **`remove`** | <code>() =&gt; Promise&lt;void&gt;</code> |
 
 
-#### BrowserPageNavigationCompletedEvent
+#### BrowserMessageReceivedEvent
+
+| Prop       | Type                 | Description                              | Since |
+| ---------- | -------------------- | ---------------------------------------- | ----- |
+| **`data`** | <code>unknown</code> | The message data posted by the web page. | 0.1.0 |
+
+
+#### BrowserNavigationCompletedEvent
 
 | Prop      | Type                | Description                                | Since |
 | --------- | ------------------- | ------------------------------------------ | ----- |
 | **`url`** | <code>string</code> | The URL of the page that was navigated to. | 0.1.0 |
 
 
-#### MessageReceivedEvent
+#### BrowserUrlChangedEvent
 
-| Prop       | Type                 | Description                              | Since |
-| ---------- | -------------------- | ---------------------------------------- | ----- |
-| **`data`** | <code>unknown</code> | The message data posted by the web page. | 0.1.0 |
+| Prop      | Type                | Description                  | Since |
+| --------- | ------------------- | ---------------------------- | ----- |
+| **`url`** | <code>string</code> | The new URL of the web view. | 0.1.0 |
 
 
 ### Type Aliases
@@ -661,7 +789,7 @@ The web page can post a message to the app using the injected `window.CapacitorI
 window.CapacitorInAppBrowser.postMessage({ name: 'Capawesome' });
 ```
 
-The app receives the message via the `messageReceived` event.
+The app receives the message via the `browserMessageReceived` event.
 
 ### From the app to the web page
 
@@ -677,10 +805,50 @@ window.addEventListener('capacitorInAppBrowserMessage', event => {
 
 The three browser modes behave differently on each platform. Keep the following differences in mind:
 
-- **System browser**: Tracking the visited URLs is not possible by design. If you need the `browserPageNavigationCompleted` event, use the `openInWebView(...)` method instead. On Android, the `browserPageLoaded` event is not emitted for the system browser and the `browserClosed` event is emitted when the user returns to the app.
+- **System browser**: Tracking the visited URLs is not possible by design. If you need the `browserNavigationCompleted` or `browserUrlChanged` event, use the `openInWebView(...)` method instead. On Android, the `browserPageLoaded` event is not emitted for the system browser and the `browserClosed` event is emitted when the user returns to the app.
 - **Embedded web view**: The web view always uses the app-global (`shared`) data store on Android. The `dataStore` option is only supported on iOS. On iOS, hiding the toolbar removes the close button, so the browser can then only be closed using the `close(...)` method.
 - **External browser**: The browser is opened in a separate app. For this reason, no events are emitted and the `close(...)` method has no effect.
 
+## FAQ
+
+### How is this plugin different from other similar plugins?
+
+It covers three browsing modes in one fully typed API — the external browser, the system browser (Custom Tabs on Android, `SFSafariViewController` on iOS), and an embedded web view with a themed native toolbar, JavaScript execution, two-way messaging, navigation events, and session control. Camera and microphone requests from web pages are forwarded to the app, and you can even load a URL hidden in the background and present it once it's ready. If you only need to open a link, the external mode is a simple one-liner; if you need to embed, theme, and communicate with web content, this plugin is designed for exactly that.
+
+### What is the difference between the external browser, the system browser and the embedded web view?
+
+The `openInExternalBrowser(...)` method opens the URL in the default browser app of the device, so no events are emitted and the `close()` method has no effect. The `openInSystemBrowser(...)` method presents the system browser (Custom Tabs on Android, `SFSafariViewController` on iOS) inside your app with a customizable toolbar. The `openInWebView(...)` method opens an embedded web view with a native toolbar and offers the most control, including JavaScript execution, messaging, and navigation events. See [Platform Behavior](#platform-behavior) for the differences between the modes.
+
+### How can I track which URLs the user visits?
+
+Tracking the visited URLs is only possible in the embedded web view. Open the URL with `openInWebView(...)` and listen for the `browserUrlChanged` or `browserNavigationCompleted` event. In the system browser, tracking the visited URLs is not possible by design, and in the external browser no events are emitted at all.
+
+### How can I exchange data between my app and the opened web page?
+
+The embedded web view injects a small message bridge into every web page. The web page can post messages to the app using the injected `window.CapacitorInAppBrowser.postMessage(...)` function, which the app receives via the `browserMessageReceived` event. The app can post messages to the web page using the `postMessage(...)` method, which the web page receives via the `capacitorInAppBrowserMessage` window event. See [Messaging](#messaging) for more details.
+
+### Can web pages access the camera or microphone?
+
+Yes, camera and microphone permission requests from web pages opened in the embedded web view are forwarded to the app. On Android, the corresponding permissions must be declared in your `AndroidManifest.xml` and granted before a web page requests access. On iOS, the `NSCameraUsageDescription` and `NSMicrophoneUsageDescription` keys must be added to your `Info.plist` file. See [Installation](#installation) for details.
+
+### Can I load a URL in the background before showing it?
+
+Yes, open the URL with `openInWebView(...)` and set the `visible` option to `false`. The web view then loads the URL in the background and stays hidden until you call the `show()` method. The `browserPageLoaded` event is still emitted and `close()` can be called while the web view is hidden.
+
+### Can I use this plugin with Ionic, React, Vue or Angular?
+
+Yes, the plugin is framework-agnostic. It works in any Capacitor app regardless of the web framework, including Ionic with Angular, React, or Vue, as well as plain JavaScript projects.
+
+## Related Plugins
+
+- [App Launcher](https://capawesome.io/docs/sdks/capacitor/app-launcher/): Check if an app can be opened and open it.
+- [OAuth](https://capawesome.io/docs/sdks/capacitor/oauth/): Communicate with OAuth 2.0 and OpenID Connect providers.
+- [System WebView](https://capawesome.io/docs/sdks/capacitor/system-webview/): Detect an outdated Android System WebView and guide users to update it.
+
+## Newsletter
+
+Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).
+
 ## Changelog
 
 See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/in-app-browser/CHANGELOG.md).

package/android/src/main/java/io/capawesome/capacitorjs/plugins/inappbrowser/InAppBrowser.java

@@ -11,8 +11,9 @@ import androidx.browser.customtabs.CustomTabColorSchemeParams;
 import androidx.browser.customtabs.CustomTabsIntent;
 import io.capawesome.capacitorjs.plugins.inappbrowser.classes.CustomExceptions;
 import io.capawesome.capacitorjs.plugins.inappbrowser.classes.WebViewDialog;
-import io.capawesome.capacitorjs.plugins.inappbrowser.classes.events.BrowserPageNavigationCompletedEvent;
-import io.capawesome.capacitorjs.plugins.inappbrowser.classes.events.MessageReceivedEvent;
+import io.capawesome.capacitorjs.plugins.inappbrowser.classes.events.BrowserMessageReceivedEvent;
+import io.capawesome.capacitorjs.plugins.inappbrowser.classes.events.BrowserNavigationCompletedEvent;
+import io.capawesome.capacitorjs.plugins.inappbrowser.classes.events.BrowserUrlChangedEvent;
 import io.capawesome.capacitorjs.plugins.inappbrowser.classes.options.ExecuteScriptOptions;
 import io.capawesome.capacitorjs.plugins.inappbrowser.classes.options.GetCookiesOptions;
 import io.capawesome.capacitorjs.plugins.inappbrowser.classes.options.OpenInExternalBrowserOptions;
@@ -199,14 +200,19 @@ public class InAppBrowser {
                             handleMessageReceived(data);
                         }
 
+                        @Override
+                        public void onNavigationCompleted(@NonNull String url) {
+                            plugin.notifyBrowserNavigationCompletedListeners(new BrowserNavigationCompletedEvent(url));
+                        }
+
                         @Override
                         public void onPageLoaded() {
                             plugin.notifyBrowserPageLoadedListeners();
                         }
 
                         @Override
-                        public void onPageNavigationCompleted(@NonNull String url) {
-                            plugin.notifyBrowserPageNavigationCompletedListeners(new BrowserPageNavigationCompletedEvent(url));
+                        public void onUrlChanged(@NonNull String url) {
+                            plugin.notifyBrowserUrlChangedListeners(new BrowserUrlChangedEvent(url));
                         }
                     }
                 );
@@ -230,6 +236,20 @@ public class InAppBrowser {
             });
     }
 
+    public void show(@NonNull EmptyCallback callback) {
+        plugin
+            .getActivity()
+            .runOnUiThread(() -> {
+                WebViewDialog webViewDialog = this.webViewDialog;
+                if (webViewDialog == null) {
+                    callback.error(CustomExceptions.NO_BROWSER_OPEN);
+                    return;
+                }
+                webViewDialog.showWebView();
+                callback.success();
+            });
+    }
+
     private void handleMessageReceived(@NonNull String data) {
         Object value;
         try {
@@ -237,6 +257,6 @@ public class InAppBrowser {
         } catch (JSONException exception) {
             value = data;
         }
-        plugin.notifyMessageReceivedListeners(new MessageReceivedEvent(value));
+        plugin.notifyBrowserMessageReceivedListeners(new BrowserMessageReceivedEvent(value));
     }
 }

package/android/src/main/java/io/capawesome/capacitorjs/plugins/inappbrowser/InAppBrowserPlugin.java

@@ -9,8 +9,9 @@ import com.getcapacitor.PluginCall;
 import com.getcapacitor.PluginMethod;
 import com.getcapacitor.annotation.CapacitorPlugin;
 import io.capawesome.capacitorjs.plugins.inappbrowser.classes.CustomException;
-import io.capawesome.capacitorjs.plugins.inappbrowser.classes.events.BrowserPageNavigationCompletedEvent;
-import io.capawesome.capacitorjs.plugins.inappbrowser.classes.events.MessageReceivedEvent;
+import io.capawesome.capacitorjs.plugins.inappbrowser.classes.events.BrowserMessageReceivedEvent;
+import io.capawesome.capacitorjs.plugins.inappbrowser.classes.events.BrowserNavigationCompletedEvent;
+import io.capawesome.capacitorjs.plugins.inappbrowser.classes.events.BrowserUrlChangedEvent;
 import io.capawesome.capacitorjs.plugins.inappbrowser.classes.options.ExecuteScriptOptions;
 import io.capawesome.capacitorjs.plugins.inappbrowser.classes.options.GetCookiesOptions;
 import io.capawesome.capacitorjs.plugins.inappbrowser.classes.options.OpenInExternalBrowserOptions;
@@ -27,9 +28,10 @@ import io.capawesome.capacitorjs.plugins.inappbrowser.interfaces.Result;
 public class InAppBrowserPlugin extends Plugin {
 
     public static final String EVENT_BROWSER_CLOSED = "browserClosed";
+    public static final String EVENT_BROWSER_MESSAGE_RECEIVED = "browserMessageReceived";
+    public static final String EVENT_BROWSER_NAVIGATION_COMPLETED = "browserNavigationCompleted";
     public static final String EVENT_BROWSER_PAGE_LOADED = "browserPageLoaded";
-    public static final String EVENT_BROWSER_PAGE_NAVIGATION_COMPLETED = "browserPageNavigationCompleted";
-    public static final String EVENT_MESSAGE_RECEIVED = "messageReceived";
+    public static final String EVENT_BROWSER_URL_CHANGED = "browserUrlChanged";
     public static final String TAG = "InAppBrowserPlugin";
 
     private static final String ERROR_UNKNOWN_ERROR = "An unknown error occurred.";
@@ -152,16 +154,20 @@ public class InAppBrowserPlugin extends Plugin {
         notifyListeners(EVENT_BROWSER_CLOSED, new JSObject());
     }
 
-    public void notifyBrowserPageLoadedListeners() {
-        notifyListeners(EVENT_BROWSER_PAGE_LOADED, new JSObject());
+    public void notifyBrowserMessageReceivedListeners(@NonNull BrowserMessageReceivedEvent event) {
+        notifyListeners(EVENT_BROWSER_MESSAGE_RECEIVED, event.toJSObject());
     }
 
-    public void notifyBrowserPageNavigationCompletedListeners(@NonNull BrowserPageNavigationCompletedEvent event) {
-        notifyListeners(EVENT_BROWSER_PAGE_NAVIGATION_COMPLETED, event.toJSObject());
+    public void notifyBrowserNavigationCompletedListeners(@NonNull BrowserNavigationCompletedEvent event) {
+        notifyListeners(EVENT_BROWSER_NAVIGATION_COMPLETED, event.toJSObject());
     }
 
-    public void notifyMessageReceivedListeners(@NonNull MessageReceivedEvent event) {
-        notifyListeners(EVENT_MESSAGE_RECEIVED, event.toJSObject());
+    public void notifyBrowserPageLoadedListeners() {
+        notifyListeners(EVENT_BROWSER_PAGE_LOADED, new JSObject());
+    }
+
+    public void notifyBrowserUrlChangedListeners(@NonNull BrowserUrlChangedEvent event) {
+        notifyListeners(EVENT_BROWSER_URL_CHANGED, event.toJSObject());
     }
 
     @PluginMethod
@@ -252,6 +258,27 @@ public class InAppBrowserPlugin extends Plugin {
         }
     }
 
+    @PluginMethod
+    public void show(PluginCall call) {
+        try {
+            EmptyCallback callback = new EmptyCallback() {
+                @Override
+                public void success() {
+                    resolveCall(call);
+                }
+
+                @Override
+                public void error(@NonNull Exception exception) {
+                    rejectCall(call, exception);
+                }
+            };
+
+            implementation.show(callback);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
     @Override
     protected void handleOnPause() {
         implementation.handleOnPause();