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

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.
 
@@ -159,14 +159,17 @@ 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 +187,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 +380,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 +420,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 +445,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 +457,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 +469,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 +604,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 +661,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 +721,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,7 +737,7 @@ 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.
 

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();

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

@@ -12,7 +12,10 @@ import android.os.Bundle;
 import android.text.TextUtils;
 import android.util.TypedValue;
 import android.view.Gravity;
+import android.view.View;
 import android.view.ViewGroup;
+import android.view.Window;
+import android.view.WindowManager;
 import android.webkit.JavascriptInterface;
 import android.webkit.PermissionRequest;
 import android.webkit.ValueCallback;
@@ -35,8 +38,9 @@ public class WebViewDialog extends Dialog {
     public interface Listener {
         void onClosed(@NonNull WebViewDialog dialog);
         void onMessageReceived(@NonNull String data);
+        void onNavigationCompleted(@NonNull String url);
         void onPageLoaded();
-        void onPageNavigationCompleted(@NonNull String url);
+        void onUrlChanged(@NonNull String url);
     }
 
     private static final String BRIDGE_JAVASCRIPT =
@@ -52,6 +56,9 @@ public class WebViewDialog extends Dialog {
 
     private boolean initialLoadNotified = false;
 
+    @Nullable
+    private String lastNotifiedUrl;
+
     @NonNull
     private final Listener listener;
 
@@ -111,6 +118,15 @@ public class WebViewDialog extends Dialog {
         }
     }
 
+    public void showWebView() {
+        Window window = getWindow();
+        if (window == null) {
+            return;
+        }
+        window.clearFlags(WindowManager.LayoutParams.FLAG_NOT_TOUCHABLE | WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE);
+        window.getDecorView().setVisibility(View.VISIBLE);
+    }
+
     @Override
     protected void onCreate(@Nullable Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
@@ -118,6 +134,9 @@ public class WebViewDialog extends Dialog {
         this.webView = webView;
         setContentView(createContentView(webView));
         setOnDismissListener(dialog -> handleDismiss());
+        if (!options.getVisible()) {
+            hideWebView();
+        }
         webView.loadUrl(options.getUri().toString(), options.getHeaders());
     }
 
@@ -223,6 +242,7 @@ public class WebViewDialog extends Dialog {
                 @Override
                 public void onPageStarted(WebView view, String url, Bitmap favicon) {
                     injectBridgeJavaScript();
+                    handleUrlChanged(url);
                 }
 
                 @Override
@@ -235,7 +255,7 @@ public class WebViewDialog extends Dialog {
                         listener.onPageLoaded();
                     }
                     if (url != null) {
-                        listener.onPageNavigationCompleted(url);
+                        listener.onNavigationCompleted(url);
                     }
                 }
 
@@ -243,6 +263,7 @@ public class WebViewDialog extends Dialog {
                 public void doUpdateVisitedHistory(WebView view, String url, boolean isReload) {
                     updateNavigationButtons();
                     updateTitle();
+                    handleUrlChanged(url);
                 }
             }
         );
@@ -293,10 +314,27 @@ public class WebViewDialog extends Dialog {
         }
     }
 
+    private void handleUrlChanged(@Nullable String url) {
+        if (url == null || url.equals(lastNotifiedUrl)) {
+            return;
+        }
+        lastNotifiedUrl = url;
+        listener.onUrlChanged(url);
+    }
+
     private boolean hasPermission(@NonNull String permission) {
         return ContextCompat.checkSelfPermission(getContext(), permission) == PackageManager.PERMISSION_GRANTED;
     }
 
+    private void hideWebView() {
+        Window window = getWindow();
+        if (window == null) {
+            return;
+        }
+        window.addFlags(WindowManager.LayoutParams.FLAG_NOT_TOUCHABLE | WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE);
+        window.getDecorView().setVisibility(View.INVISIBLE);
+    }
+
     private void injectBridgeJavaScript() {
         WebView webView = this.webView;
         if (webView != null) {

package/android/src/main/java/io/capawesome/capacitorjs/plugins/inappbrowser/classes/events/{MessageReceivedEvent.java → BrowserMessageReceivedEvent.java}

@@ -4,12 +4,12 @@ import androidx.annotation.NonNull;
 import com.getcapacitor.JSObject;
 import io.capawesome.capacitorjs.plugins.inappbrowser.interfaces.Result;
 
-public class MessageReceivedEvent implements Result {
+public class BrowserMessageReceivedEvent implements Result {
 
     @NonNull
     private final Object data;
 
-    public MessageReceivedEvent(@NonNull Object data) {
+    public BrowserMessageReceivedEvent(@NonNull Object data) {
         this.data = data;
     }
 

package/android/src/main/java/io/capawesome/capacitorjs/plugins/inappbrowser/classes/events/{BrowserPageNavigationCompletedEvent.java → BrowserNavigationCompletedEvent.java}

@@ -4,12 +4,12 @@ import androidx.annotation.NonNull;
 import com.getcapacitor.JSObject;
 import io.capawesome.capacitorjs.plugins.inappbrowser.interfaces.Result;
 
-public class BrowserPageNavigationCompletedEvent implements Result {
+public class BrowserNavigationCompletedEvent implements Result {
 
     @NonNull
     private final String url;
 
-    public BrowserPageNavigationCompletedEvent(@NonNull String url) {
+    public BrowserNavigationCompletedEvent(@NonNull String url) {
         this.url = url;
     }
 

package/android/src/main/java/io/capawesome/capacitorjs/plugins/inappbrowser/classes/events/BrowserUrlChangedEvent.java

@@ -0,0 +1,23 @@
+package io.capawesome.capacitorjs.plugins.inappbrowser.classes.events;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.inappbrowser.interfaces.Result;
+
+public class BrowserUrlChangedEvent implements Result {
+
+    @NonNull
+    private final String url;
+
+    public BrowserUrlChangedEvent(@NonNull String url) {
+        this.url = url;
+    }
+
+    @Override
+    @NonNull
+    public JSObject toJSObject() {
+        JSObject result = new JSObject();
+        result.put("url", url);
+        return result;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/inappbrowser/classes/options/OpenInWebViewOptions.java

@@ -30,6 +30,8 @@ public class OpenInWebViewOptions {
     @Nullable
     private final String userAgent;
 
+    private final boolean visible;
+
     public OpenInWebViewOptions(@NonNull PluginCall call) throws Exception {
         JSObject androidOptions = call.getObject("android");
         this.allowZoom = androidOptions != null && androidOptions.optBoolean("allowZoom", false);
@@ -40,6 +42,7 @@ public class OpenInWebViewOptions {
         this.toolbar = new WebViewToolbarOptions(call.getObject("toolbar"));
         this.uri = OpenInWebViewOptions.getUriFromCall(call);
         this.userAgent = call.getString("userAgent");
+        this.visible = call.getBoolean("visible", true);
     }
 
     public boolean getAllowZoom() {
@@ -78,6 +81,10 @@ public class OpenInWebViewOptions {
         return userAgent;
     }
 
+    public boolean getVisible() {
+        return visible;
+    }
+
     @NonNull
     private static Map<String, String> getHeadersFromCall(@NonNull PluginCall call) {
         Map<String, String> headers = new HashMap<>();