@capawesome/capacitor-in-app-browser 0.1.1 → 0.2.0

package/README.md

@@ -17,8 +17,9 @@ The Capacitor In-App Browser plugin is one of the most complete in-app browsing
 - 💉 **JavaScript execution**: Execute any JavaScript code in the embedded web view.
 - 💬 **Messaging**: Exchange messages between your app and the web page in both directions.
 - 🎨 **Toolbar theming**: Customize the toolbar color, title, close button and navigation buttons.
-- 🍪 **Session control**: Clear the cache and session data, or use an isolated data store on iOS.
+- 🍪 **Session control**: Clear the cache and cookies, or use an isolated data store on iOS.
 - 🎥 **Media permissions**: Camera and microphone permission requests from web pages are forwarded to the app.
+- 🤝 **Compatibility**: Works alongside the [App Launcher](https://capawesome.io/docs/sdks/capacitor/app-launcher/), [OAuth](https://capawesome.io/docs/sdks/capacitor/oauth/) and [System WebView](https://capawesome.io/docs/sdks/capacitor/system-webview/) plugins.
 - 📦 **CocoaPods & SPM**: Supports CocoaPods and Swift Package Manager for iOS.
 - 🔁 **Up-to-date**: Always supports the latest Capacitor version.
 
@@ -32,7 +33,7 @@ The In-App Browser plugin is typically used whenever an app needs to display web
 - **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.
+- **Session control**: Clear the cache and cookies of the web view, or use an isolated data store on iOS.
 
 ## Compatibility
 
@@ -200,9 +201,9 @@ const postMessage = async () => {
 };
 ```
 
-### Clear the cache and session data
+### Clear the cache and cookies
 
-Clear the cache or the session data (cookies and web storage) of the web view. Only available on Android and iOS:
+Clear the cache or the cookies of the web view, either for all URLs or only for a specific URL. Only available on Android and iOS:
 
 ```typescript
 import { InAppBrowser } from '@capawesome/capacitor-in-app-browser';
@@ -211,8 +212,12 @@ const clearCache = async () => {
   await InAppBrowser.clearCache();
 };
 
-const clearSessionData = async () => {
-  await InAppBrowser.clearSessionData();
+const clearAllCookies = async () => {
+  await InAppBrowser.clearCookies();
+};
+
+const clearCookiesForUrl = async () => {
+  await InAppBrowser.clearCookies({ url: 'https://capawesome.io' });
 };
 ```
 
@@ -247,7 +252,7 @@ const addListeners = async () => {
 <docgen-index>
 
 * [`clearCache()`](#clearcache)
-* [`clearSessionData()`](#clearsessiondata)
+* [`clearCookies(...)`](#clearcookies)
 * [`close()`](#close)
 * [`executeScript(...)`](#executescript)
 * [`getCookies(...)`](#getcookies)
@@ -285,17 +290,24 @@ Only available on Android and iOS.
 --------------------
 
 
-### clearSessionData()
+### clearCookies(...)
 
 ```typescript
-clearSessionData() => Promise<void>
+clearCookies(options?: ClearCookiesOptions | undefined) => Promise<void>
 ```
 
-Clear the session data (cookies and web storage) of the web view.
+Clear the cookies of the web view.
+
+Provide the `url` option to clear only the cookies of a specific URL.
+Otherwise, all cookies are cleared.
 
 Only available on Android and iOS.
 
-**Since:** 0.1.0
+| Param         | Type                                                                |
+| ------------- | ------------------------------------------------------------------- |
+| **`options`** | <code><a href="#clearcookiesoptions">ClearCookiesOptions</a></code> |
+
+**Since:** 0.2.0
 
 --------------------
 
@@ -607,6 +619,13 @@ Remove all listeners for this plugin.
 ### Interfaces
 
 
+#### ClearCookiesOptions
+
+| Prop      | Type                | Description                                                                 | Since |
+| --------- | ------------------- | --------------------------------------------------------------------------- | ----- |
+| **`url`** | <code>string</code> | The URL to clear the cookies for. If not provided, all cookies are cleared. | 0.2.0 |
+
+
 #### ExecuteScriptResult
 
 | Prop         | Type                        | Description                                                                                                                                  | Since |
@@ -853,6 +872,10 @@ Stay up to date with the latest news and updates about the Capawesome, Capacitor
 
 See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/in-app-browser/CHANGELOG.md).
 
+## Breaking Changes
+
+See [BREAKING.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/in-app-browser/BREAKING.md).
+
 ## License
 
 See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/in-app-browser/LICENSE).

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

@@ -2,8 +2,8 @@ package io.capawesome.capacitorjs.plugins.inappbrowser;
 
 import android.content.ActivityNotFoundException;
 import android.content.Intent;
+import android.net.Uri;
 import android.webkit.CookieManager;
-import android.webkit.WebStorage;
 import android.webkit.WebView;
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
@@ -14,6 +14,7 @@ import io.capawesome.capacitorjs.plugins.inappbrowser.classes.WebViewDialog;
 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.ClearCookiesOptions;
 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;
@@ -44,85 +45,91 @@ public class InAppBrowser {
     }
 
     public void clearCache(@NonNull EmptyCallback callback) {
-        plugin
-            .getActivity()
-            .runOnUiThread(() -> {
-                WebView webView = new WebView(plugin.getContext());
-                webView.clearCache(true);
-                webView.destroy();
-                callback.success();
-            });
+        plugin.getActivity().runOnUiThread(() -> {
+            WebView webView = new WebView(plugin.getContext());
+            webView.clearCache(true);
+            webView.destroy();
+            callback.success();
+        });
     }
 
-    public void clearSessionData(@NonNull EmptyCallback callback) {
-        plugin
-            .getActivity()
-            .runOnUiThread(() -> {
-                CookieManager cookieManager = CookieManager.getInstance();
+    public void clearCookies(@NonNull ClearCookiesOptions options, @NonNull EmptyCallback callback) {
+        plugin.getActivity().runOnUiThread(() -> {
+            CookieManager cookieManager = CookieManager.getInstance();
+            String url = options.getUrl();
+            if (url == null) {
                 cookieManager.removeAllCookies(value -> {
                     cookieManager.flush();
-                    WebStorage.getInstance().deleteAllData();
                     callback.success();
                 });
-            });
+            } else {
+                String cookieString = cookieManager.getCookie(url);
+                if (cookieString != null) {
+                    String host = Uri.parse(url).getHost();
+                    for (String cookie : cookieString.split("; ")) {
+                        int separatorIndex = cookie.indexOf('=');
+                        if (separatorIndex < 0) {
+                            continue;
+                        }
+                        expireCookie(cookieManager, url, host, cookie.substring(0, separatorIndex));
+                    }
+                }
+                cookieManager.flush();
+                callback.success();
+            }
+        });
     }
 
     public void close(@NonNull EmptyCallback callback) {
-        plugin
-            .getActivity()
-            .runOnUiThread(() -> {
-                WebViewDialog webViewDialog = this.webViewDialog;
-                if (webViewDialog != null) {
-                    webViewDialog.dismiss();
-                    callback.success();
-                    return;
-                }
-                if (customTabOpened) {
-                    Intent intent = new Intent(plugin.getContext(), plugin.getActivity().getClass());
-                    intent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_SINGLE_TOP);
-                    plugin.getActivity().startActivity(intent);
-                    callback.success();
-                    return;
-                }
-                callback.error(CustomExceptions.NO_BROWSER_OPEN);
-            });
+        plugin.getActivity().runOnUiThread(() -> {
+            WebViewDialog webViewDialog = this.webViewDialog;
+            if (webViewDialog != null) {
+                webViewDialog.dismiss();
+                callback.success();
+                return;
+            }
+            if (customTabOpened) {
+                Intent intent = new Intent(plugin.getContext(), plugin.getActivity().getClass());
+                intent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_SINGLE_TOP);
+                plugin.getActivity().startActivity(intent);
+                callback.success();
+                return;
+            }
+            callback.error(CustomExceptions.NO_BROWSER_OPEN);
+        });
     }
 
     public void executeScript(@NonNull ExecuteScriptOptions options, @NonNull NonEmptyResultCallback<ExecuteScriptResult> callback) {
-        plugin
-            .getActivity()
-            .runOnUiThread(() -> {
-                WebViewDialog webViewDialog = this.webViewDialog;
-                if (webViewDialog == null) {
-                    callback.error(CustomExceptions.NO_BROWSER_OPEN);
-                    return;
-                }
-                webViewDialog.executeScript(options.getScript(), value -> {
-                    String result = value == null || value.equals("null") ? null : value;
-                    callback.success(new ExecuteScriptResult(result));
-                });
+        plugin.getActivity().runOnUiThread(() -> {
+            WebViewDialog webViewDialog = this.webViewDialog;
+            if (webViewDialog == null) {
+                callback.error(CustomExceptions.NO_BROWSER_OPEN);
+                return;
+            }
+            webViewDialog.executeScript(options.getScript(), value -> {
+                String result = value == null || value.equals("null") ? null : value;
+                callback.success(new ExecuteScriptResult(result));
             });
+        });
     }
 
     public void getCookies(@NonNull GetCookiesOptions options, @NonNull NonEmptyResultCallback<GetCookiesResult> callback) {
-        plugin
-            .getActivity()
-            .runOnUiThread(() -> {
-                Map<String, String> cookies = new HashMap<>();
-                String cookieString = CookieManager.getInstance().getCookie(options.getUrl());
-                if (cookieString != null) {
-                    for (String cookie : cookieString.split("; ")) {
-                        int separatorIndex = cookie.indexOf('=');
-                        if (separatorIndex < 0) {
-                            continue;
-                        }
-                        String name = cookie.substring(0, separatorIndex);
-                        String value = cookie.substring(separatorIndex + 1);
-                        cookies.put(name, value);
+        plugin.getActivity().runOnUiThread(() -> {
+            Map<String, String> cookies = new HashMap<>();
+            String cookieString = CookieManager.getInstance().getCookie(options.getUrl());
+            if (cookieString != null) {
+                for (String cookie : cookieString.split("; ")) {
+                    int separatorIndex = cookie.indexOf('=');
+                    if (separatorIndex < 0) {
+                        continue;
                     }
+                    String name = cookie.substring(0, separatorIndex);
+                    String value = cookie.substring(separatorIndex + 1);
+                    cookies.put(name, value);
                 }
-                callback.success(new GetCookiesResult(cookies));
-            });
+            }
+            callback.success(new GetCookiesResult(cookies));
+        });
     }
 
     public void handleOnPause() {
@@ -154,100 +161,92 @@ public class InAppBrowser {
     }
 
     public void openInSystemBrowser(@NonNull OpenInSystemBrowserOptions options, @NonNull EmptyCallback callback) {
-        plugin
-            .getActivity()
-            .runOnUiThread(() -> {
-                CustomTabsIntent.Builder builder = new CustomTabsIntent.Builder();
-                Integer toolbarColor = options.getToolbarColor();
-                if (toolbarColor != null) {
-                    builder.setDefaultColorSchemeParams(new CustomTabColorSchemeParams.Builder().setToolbarColor(toolbarColor).build());
-                }
-                builder.setShowTitle(options.getShowTitle());
-                builder.setUrlBarHidingEnabled(options.getHideToolbarOnScroll());
-                CustomTabsIntent customTabsIntent = builder.build();
-                try {
-                    customTabsIntent.launchUrl(plugin.getActivity(), options.getUri());
-                    customTabOpened = true;
-                    callback.success();
-                } catch (ActivityNotFoundException exception) {
-                    callback.error(CustomExceptions.BROWSER_NOT_FOUND);
-                }
-            });
+        plugin.getActivity().runOnUiThread(() -> {
+            CustomTabsIntent.Builder builder = new CustomTabsIntent.Builder();
+            Integer toolbarColor = options.getToolbarColor();
+            if (toolbarColor != null) {
+                builder.setDefaultColorSchemeParams(new CustomTabColorSchemeParams.Builder().setToolbarColor(toolbarColor).build());
+            }
+            builder.setShowTitle(options.getShowTitle());
+            builder.setUrlBarHidingEnabled(options.getHideToolbarOnScroll());
+            CustomTabsIntent customTabsIntent = builder.build();
+            try {
+                customTabsIntent.launchUrl(plugin.getActivity(), options.getUri());
+                customTabOpened = true;
+                callback.success();
+            } catch (ActivityNotFoundException exception) {
+                callback.error(CustomExceptions.BROWSER_NOT_FOUND);
+            }
+        });
     }
 
     public void openInWebView(@NonNull OpenInWebViewOptions options, @NonNull EmptyCallback callback) {
-        plugin
-            .getActivity()
-            .runOnUiThread(() -> {
-                WebViewDialog existingWebViewDialog = this.webViewDialog;
-                if (existingWebViewDialog != null) {
-                    existingWebViewDialog.dismiss();
-                }
-                WebViewDialog webViewDialog = new WebViewDialog(
-                    plugin.getActivity(),
-                    options,
-                    new WebViewDialog.Listener() {
-                        @Override
-                        public void onClosed(@NonNull WebViewDialog dialog) {
-                            if (InAppBrowser.this.webViewDialog == dialog) {
-                                InAppBrowser.this.webViewDialog = null;
-                            }
-                            plugin.notifyBrowserClosedListeners();
+        plugin.getActivity().runOnUiThread(() -> {
+            WebViewDialog existingWebViewDialog = this.webViewDialog;
+            if (existingWebViewDialog != null) {
+                existingWebViewDialog.dismiss();
+            }
+            WebViewDialog webViewDialog = new WebViewDialog(
+                plugin.getActivity(),
+                options,
+                new WebViewDialog.Listener() {
+                    @Override
+                    public void onClosed(@NonNull WebViewDialog dialog) {
+                        if (InAppBrowser.this.webViewDialog == dialog) {
+                            InAppBrowser.this.webViewDialog = null;
                         }
+                        plugin.notifyBrowserClosedListeners();
+                    }
 
-                        @Override
-                        public void onMessageReceived(@NonNull String data) {
-                            handleMessageReceived(data);
-                        }
+                    @Override
+                    public void onMessageReceived(@NonNull String data) {
+                        handleMessageReceived(data);
+                    }
 
-                        @Override
-                        public void onNavigationCompleted(@NonNull String url) {
-                            plugin.notifyBrowserNavigationCompletedListeners(new BrowserNavigationCompletedEvent(url));
-                        }
+                    @Override
+                    public void onNavigationCompleted(@NonNull String url) {
+                        plugin.notifyBrowserNavigationCompletedListeners(new BrowserNavigationCompletedEvent(url));
+                    }
 
-                        @Override
-                        public void onPageLoaded() {
-                            plugin.notifyBrowserPageLoadedListeners();
-                        }
+                    @Override
+                    public void onPageLoaded() {
+                        plugin.notifyBrowserPageLoadedListeners();
+                    }
 
-                        @Override
-                        public void onUrlChanged(@NonNull String url) {
-                            plugin.notifyBrowserUrlChangedListeners(new BrowserUrlChangedEvent(url));
-                        }
+                    @Override
+                    public void onUrlChanged(@NonNull String url) {
+                        plugin.notifyBrowserUrlChangedListeners(new BrowserUrlChangedEvent(url));
                     }
-                );
-                this.webViewDialog = webViewDialog;
-                webViewDialog.show();
-                callback.success();
-            });
+                }
+            );
+            this.webViewDialog = webViewDialog;
+            webViewDialog.show();
+            callback.success();
+        });
     }
 
     public void postMessage(@NonNull PostMessageOptions options, @NonNull EmptyCallback callback) {
-        plugin
-            .getActivity()
-            .runOnUiThread(() -> {
-                WebViewDialog webViewDialog = this.webViewDialog;
-                if (webViewDialog == null) {
-                    callback.error(CustomExceptions.NO_BROWSER_OPEN);
-                    return;
-                }
-                webViewDialog.postMessage(options.getData().toString());
-                callback.success();
-            });
+        plugin.getActivity().runOnUiThread(() -> {
+            WebViewDialog webViewDialog = this.webViewDialog;
+            if (webViewDialog == null) {
+                callback.error(CustomExceptions.NO_BROWSER_OPEN);
+                return;
+            }
+            webViewDialog.postMessage(options.getData().toString());
+            callback.success();
+        });
     }
 
     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();
-            });
+        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) {
@@ -259,4 +258,16 @@ public class InAppBrowser {
         }
         plugin.notifyBrowserMessageReceivedListeners(new BrowserMessageReceivedEvent(value));
     }
+
+    private void expireCookie(@NonNull CookieManager cookieManager, @NonNull String url, @Nullable String host, @NonNull String name) {
+        String expiredCookie = name + "=; Expires=Thu, 01 Jan 1970 00:00:00 GMT; Max-Age=0; Path=/";
+        cookieManager.setCookie(url, expiredCookie);
+        // Also expire the domain cookie variants of all parent domains
+        // because the cookie string does not reveal the cookie domain.
+        String domain = host;
+        while (domain != null && domain.indexOf('.') != -1) {
+            cookieManager.setCookie(url, expiredCookie + "; Domain=" + domain);
+            domain = domain.substring(domain.indexOf('.') + 1);
+        }
+    }
 }

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

@@ -12,6 +12,7 @@ import io.capawesome.capacitorjs.plugins.inappbrowser.classes.CustomException;
 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.ClearCookiesOptions;
 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;
@@ -60,8 +61,9 @@ public class InAppBrowserPlugin extends Plugin {
     }
 
     @PluginMethod
-    public void clearSessionData(PluginCall call) {
+    public void clearCookies(PluginCall call) {
         try {
+            ClearCookiesOptions options = new ClearCookiesOptions(call);
             EmptyCallback callback = new EmptyCallback() {
                 @Override
                 public void success() {
@@ -74,7 +76,7 @@ public class InAppBrowserPlugin extends Plugin {
                 }
             };
 
-            implementation.clearSessionData(callback);
+            implementation.clearCookies(options, callback);
         } catch (Exception exception) {
             rejectCall(call, exception);
         }

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

@@ -0,0 +1,21 @@
+package io.capawesome.capacitorjs.plugins.inappbrowser.classes.options;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import com.getcapacitor.PluginCall;
+
+public class ClearCookiesOptions {
+
+    @Nullable
+    private final String url;
+
+    public ClearCookiesOptions(@NonNull PluginCall call) {
+        String url = call.getString("url");
+        this.url = url == null || url.isEmpty() ? null : url;
+    }
+
+    @Nullable
+    public String getUrl() {
+        return url;
+    }
+}

package/dist/docs.json

@@ -21,19 +21,27 @@
         "slug": "clearcache"
       },
       {
-        "name": "clearSessionData",
-        "signature": "() => Promise<void>",
-        "parameters": [],
+        "name": "clearCookies",
+        "signature": "(options?: ClearCookiesOptions | undefined) => Promise<void>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "ClearCookiesOptions | undefined"
+          }
+        ],
         "returns": "Promise<void>",
         "tags": [
           {
             "name": "since",
-            "text": "0.1.0"
+            "text": "0.2.0"
           }
         ],
-        "docs": "Clear the session data (cookies and web storage) of the web view.\n\nOnly available on Android and iOS.",
-        "complexTypes": [],
-        "slug": "clearsessiondata"
+        "docs": "Clear the cookies of the web view.\n\nProvide the `url` option to clear only the cookies of a specific URL.\nOtherwise, all cookies are cleared.\n\nOnly available on Android and iOS.",
+        "complexTypes": [
+          "ClearCookiesOptions"
+        ],
+        "slug": "clearcookies"
       },
       {
         "name": "close",
@@ -367,6 +375,36 @@
     "properties": []
   },
   "interfaces": [
+    {
+      "name": "ClearCookiesOptions",
+      "slug": "clearcookiesoptions",
+      "docs": "",
+      "tags": [
+        {
+          "text": "0.2.0",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "url",
+          "tags": [
+            {
+              "text": "'https://capawesome.io'",
+              "name": "example"
+            },
+            {
+              "text": "0.2.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The URL to clear the cookies for.\n\nIf not provided, all cookies are cleared.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
+    },
     {
       "name": "ExecuteScriptResult",
       "slug": "executescriptresult",

package/dist/esm/definitions.d.ts

@@ -9,13 +9,16 @@ export interface InAppBrowserPlugin {
      */
     clearCache(): Promise<void>;
     /**
-     * Clear the session data (cookies and web storage) of the web view.
+     * Clear the cookies of the web view.
+     *
+     * Provide the `url` option to clear only the cookies of a specific URL.
+     * Otherwise, all cookies are cleared.
      *
      * Only available on Android and iOS.
      *
-     * @since 0.1.0
+     * @since 0.2.0
      */
-    clearSessionData(): Promise<void>;
+    clearCookies(options?: ClearCookiesOptions): Promise<void>;
     /**
      * Close the currently open browser.
      *
@@ -490,6 +493,20 @@ export interface PostMessageOptions {
         [key: string]: unknown;
     };
 }
+/**
+ * @since 0.2.0
+ */
+export interface ClearCookiesOptions {
+    /**
+     * The URL to clear the cookies for.
+     *
+     * If not provided, all cookies are cleared.
+     *
+     * @example 'https://capawesome.io'
+     * @since 0.2.0
+     */
+    url?: string;
+}
 /**
  * @since 0.1.0
  */

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AA0lBA;;GAEG;AACH,MAAM,CAAN,IAAY,SAaX;AAbD,WAAY,SAAS;IACnB;;;;OAIG;IACH,kDAAqC,CAAA;IACrC;;;;OAIG;IACH,8CAAiC,CAAA;AACnC,CAAC,EAbW,SAAS,KAAT,SAAS,QAapB","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport interface InAppBrowserPlugin {\n  /**\n   * Clear the cache of the web view.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  clearCache(): Promise<void>;\n  /**\n   * Clear the session data (cookies and web storage) of the web view.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  clearSessionData(): Promise<void>;\n  /**\n   * Close the currently open browser.\n   *\n   * This closes browsers opened with `openInWebView(...)` or\n   * `openInSystemBrowser(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  close(): Promise<void>;\n  /**\n   * Execute a JavaScript script in the currently open web view.\n   *\n   * This method is only available for browsers opened with\n   * `openInWebView(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  executeScript(options: ExecuteScriptOptions): Promise<ExecuteScriptResult>;\n  /**\n   * Get the cookies for a specific URL.\n   *\n   * On iOS, only cookies from the shared data store are returned. Cookies from\n   * a web view opened with `dataStore: 'isolated'` are not included.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  getCookies(options: GetCookiesOptions): Promise<GetCookiesResult>;\n  /**\n   * Open a URL in the default browser app of the device.\n   *\n   * @since 0.1.0\n   */\n  openInExternalBrowser(options: OpenInExternalBrowserOptions): Promise<void>;\n  /**\n   * Open a URL in the system browser (Custom Tabs on Android,\n   * `SFSafariViewController` on iOS).\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  openInSystemBrowser(options: OpenInSystemBrowserOptions): Promise<void>;\n  /**\n   * Open a URL in an embedded web view with a native toolbar.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  openInWebView(options: OpenInWebViewOptions): Promise<void>;\n  /**\n   * Post a message to the currently open web view.\n   *\n   * The web page receives the message by listening for the\n   * `capacitorInAppBrowserMessage` window event. The message data is\n   * available in the `detail` property of the event.\n   *\n   * This method is only available for browsers opened with\n   * `openInWebView(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  postMessage(options: PostMessageOptions): Promise<void>;\n  /**\n   * Show the web view if it was opened with `visible: false`.\n   *\n   * This method is only available for browsers opened with\n   * `openInWebView(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  show(): Promise<void>;\n  /**\n   * Called when the browser is closed.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  addListener(\n    eventName: 'browserClosed',\n    listenerFunc: () => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Called when the web page posts a message to the app using the injected\n   * `window.CapacitorInAppBrowser.postMessage(...)` function.\n   *\n   * This event is only emitted for browsers opened with `openInWebView(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  addListener(\n    eventName: 'browserMessageReceived',\n    listenerFunc: (event: BrowserMessageReceivedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Called when a page navigation has been completed in the web view.\n   *\n   * This event is only emitted for browsers opened with `openInWebView(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  addListener(\n    eventName: 'browserNavigationCompleted',\n    listenerFunc: (event: BrowserNavigationCompletedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Called when the initial page of the browser has finished loading.\n   *\n   * On Android, this event is only emitted for browsers opened with\n   * `openInWebView(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  addListener(\n    eventName: 'browserPageLoaded',\n    listenerFunc: () => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Called when the current URL of the web view changes, e.g. when the user\n   * navigates to a new page, a server redirect occurs, or a single-page\n   * application updates the browser history.\n   *\n   * This event is also emitted for the initial URL and fires earlier than\n   * `browserNavigationCompleted`.\n   *\n   * This event is only emitted for browsers opened with `openInWebView(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  addListener(\n    eventName: 'browserUrlChanged',\n    listenerFunc: (event: BrowserUrlChangedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @since 0.1.0\n   */\n  removeAllListeners(): Promise<void>;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface OpenInExternalBrowserOptions {\n  /**\n   * The URL to open in the external browser.\n   *\n   * @example 'https://capawesome.io'\n   * @since 0.1.0\n   */\n  url: string;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface OpenInSystemBrowserOptions {\n  /**\n   * Options that are only applied on Android.\n   *\n   * Only available on Android.\n   *\n   * @since 0.1.0\n   */\n  android?: OpenInSystemBrowserAndroidOptions;\n  /**\n   * Options that are only applied on iOS.\n   *\n   * Only available on iOS.\n   *\n   * @since 0.1.0\n   */\n  ios?: OpenInSystemBrowserIosOptions;\n  /**\n   * The URL to open in the system browser.\n   *\n   * @example 'https://capawesome.io'\n   * @since 0.1.0\n   */\n  url: string;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface OpenInSystemBrowserAndroidOptions {\n  /**\n   * Whether or not the toolbar should be hidden when the user scrolls down\n   * and shown when the user scrolls up.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  hideToolbarOnScroll?: boolean;\n  /**\n   * Whether or not the title of the web page should be shown in the toolbar.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  showTitle?: boolean;\n  /**\n   * The background color of the toolbar as a hex color code.\n   *\n   * @example '#008080'\n   * @since 0.1.0\n   */\n  toolbarColor?: string;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface OpenInSystemBrowserIosOptions {\n  /**\n   * Whether or not the toolbar should collapse when the user scrolls down.\n   *\n   * @default true\n   * @since 0.1.0\n   */\n  barCollapsing?: boolean;\n  /**\n   * The style of the dismiss button in the toolbar.\n   *\n   * @default 'done'\n   * @since 0.1.0\n   */\n  dismissButtonStyle?: DismissButtonStyle;\n  /**\n   * Whether or not the reader mode should be entered if it is available for\n   * the web page.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  readerMode?: boolean;\n  /**\n   * The background color of the toolbar as a hex color code.\n   *\n   * @example '#008080'\n   * @since 0.1.0\n   */\n  toolbarColor?: string;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface OpenInWebViewOptions {\n  /**\n   * Options that are only applied on Android.\n   *\n   * Only available on Android.\n   *\n   * @since 0.1.0\n   */\n  android?: OpenInWebViewAndroidOptions;\n  /**\n   * The data store to use for the web view.\n   *\n   * On Android, this option is ignored. The web view always uses the\n   * app-global (`shared`) data store.\n   *\n   * Only available on iOS.\n   *\n   * @default 'shared'\n   * @since 0.1.0\n   */\n  dataStore?: WebViewDataStore;\n  /**\n   * Additional HTTP headers to send with the initial request.\n   *\n   * @since 0.1.0\n   */\n  headers?: { [key: string]: string };\n  /**\n   * Options that are only applied on iOS.\n   *\n   * Only available on iOS.\n   *\n   * @since 0.1.0\n   */\n  ios?: OpenInWebViewIosOptions;\n  /**\n   * Whether or not media playback requires user action.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  mediaPlaybackRequiresUserAction?: boolean;\n  /**\n   * Options for the toolbar of the web view.\n   *\n   * @since 0.1.0\n   */\n  toolbar?: WebViewToolbarOptions;\n  /**\n   * The URL to open in the web view.\n   *\n   * @example 'https://capawesome.io'\n   * @since 0.1.0\n   */\n  url: string;\n  /**\n   * The custom user agent to use for the web view.\n   *\n   * @since 0.1.0\n   */\n  userAgent?: string;\n  /**\n   * Whether or not the web view is presented when opened.\n   *\n   * If `false`, the web view loads the URL in the background and stays\n   * hidden until `show()` is called. The `browserPageLoaded` event is\n   * still emitted and `close()` can be called while the web view is\n   * hidden.\n   *\n   * @default true\n   * @since 0.1.0\n   */\n  visible?: boolean;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface WebViewToolbarOptions {\n  /**\n   * The background color of the toolbar as a hex color code.\n   *\n   * @example '#008080'\n   * @since 0.1.0\n   */\n  backgroundColor?: string;\n  /**\n   * The text of the close button in the toolbar.\n   *\n   * @default 'Close'\n   * @since 0.1.0\n   */\n  closeButtonText?: string;\n  /**\n   * The text color of the toolbar as a hex color code.\n   *\n   * @example '#FFFFFF'\n   * @since 0.1.0\n   */\n  color?: string;\n  /**\n   * Whether or not the back and forward navigation buttons should be shown\n   * in the toolbar.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  showNavigationButtons?: boolean;\n  /**\n   * Whether or not the current URL should be displayed in the toolbar\n   * instead of the title.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  showUrl?: boolean;\n  /**\n   * The fixed title to display in the toolbar.\n   *\n   * If not set, the title of the current web page is displayed.\n   *\n   * @since 0.1.0\n   */\n  title?: string;\n  /**\n   * Whether or not the toolbar should be visible.\n   *\n   * @default true\n   * @since 0.1.0\n   */\n  visible?: boolean;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface OpenInWebViewAndroidOptions {\n  /**\n   * Whether or not the user can zoom the web page.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  allowZoom?: boolean;\n  /**\n   * Whether or not the hardware back button navigates back in the web view's\n   * history before closing the web view.\n   *\n   * If `false`, the hardware back button closes the web view immediately.\n   *\n   * @default true\n   * @since 0.1.0\n   */\n  hardwareBackButton?: boolean;\n  /**\n   * Whether or not media playback is paused when the app is hidden.\n   *\n   * @default true\n   * @since 0.1.0\n   */\n  pauseMediaWhenHidden?: boolean;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface OpenInWebViewIosOptions {\n  /**\n   * Whether or not horizontal swipe gestures navigate back and forward in\n   * the web view's history.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  allowsBackForwardNavigationGestures?: boolean;\n  /**\n   * Whether or not the web view bounces when scrolled past the edge of the\n   * content.\n   *\n   * @default true\n   * @since 0.1.0\n   */\n  overscroll?: boolean;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface ExecuteScriptOptions {\n  /**\n   * The JavaScript code to execute in the web view.\n   *\n   * @example 'document.title'\n   * @since 0.1.0\n   */\n  script: string;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface ExecuteScriptResult {\n  /**\n   * The result of the script execution serialized as a JSON string.\n   *\n   * If the script does not return a JSON-serializable value, `null` is\n   * returned.\n   *\n   * @example '\"Capawesome\"'\n   * @since 0.1.0\n   */\n  result: string | null;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface PostMessageOptions {\n  /**\n   * The message data to post to the web view.\n   *\n   * Must be a JSON-serializable object.\n   *\n   * @example { name: 'Capawesome' }\n   * @since 0.1.0\n   */\n  data: { [key: string]: unknown };\n}\n\n/**\n * @since 0.1.0\n */\nexport interface GetCookiesOptions {\n  /**\n   * The URL to get the cookies for.\n   *\n   * @example 'https://capawesome.io'\n   * @since 0.1.0\n   */\n  url: string;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface GetCookiesResult {\n  /**\n   * The cookies for the URL as a map of cookie names to values.\n   *\n   * @since 0.1.0\n   */\n  cookies: { [key: string]: string };\n}\n\n/**\n * @since 0.1.0\n */\nexport interface BrowserMessageReceivedEvent {\n  /**\n   * The message data posted by the web page.\n   *\n   * @since 0.1.0\n   */\n  data: unknown;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface BrowserNavigationCompletedEvent {\n  /**\n   * The URL of the page that was navigated to.\n   *\n   * @example 'https://capawesome.io'\n   * @since 0.1.0\n   */\n  url: string;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface BrowserUrlChangedEvent {\n  /**\n   * The new URL of the web view.\n   *\n   * @example 'https://capawesome.io'\n   * @since 0.1.0\n   */\n  url: string;\n}\n\n/**\n * The style of the dismiss button in the toolbar of the system browser.\n *\n * - `cancel`: A button with the text \"Cancel\".\n * - `close`: A button with the text \"Close\".\n * - `done`: A button with the text \"Done\".\n *\n * @since 0.1.0\n */\nexport type DismissButtonStyle = 'cancel' | 'close' | 'done';\n\n/**\n * The data store to use for the web view.\n *\n * - `isolated`: The web view uses a non-persistent data store. Cookies and\n *   web storage are discarded when the web view is closed.\n * - `shared`: The web view uses the app-global data store which is shared\n *   with other web views.\n *\n * @since 0.1.0\n */\nexport type WebViewDataStore = 'isolated' | 'shared';\n\n/**\n * @since 0.1.0\n */\nexport enum ErrorCode {\n  /**\n   * No app was found on the device that can open the URL.\n   *\n   * @since 0.1.0\n   */\n  BrowserNotFound = 'BROWSER_NOT_FOUND',\n  /**\n   * No browser is currently open.\n   *\n   * @since 0.1.0\n   */\n  NoBrowserOpen = 'NO_BROWSER_OPEN',\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AA4mBA;;GAEG;AACH,MAAM,CAAN,IAAY,SAaX;AAbD,WAAY,SAAS;IACnB;;;;OAIG;IACH,kDAAqC,CAAA;IACrC;;;;OAIG;IACH,8CAAiC,CAAA;AACnC,CAAC,EAbW,SAAS,KAAT,SAAS,QAapB","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport interface InAppBrowserPlugin {\n  /**\n   * Clear the cache of the web view.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  clearCache(): Promise<void>;\n  /**\n   * Clear the cookies of the web view.\n   *\n   * Provide the `url` option to clear only the cookies of a specific URL.\n   * Otherwise, all cookies are cleared.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.2.0\n   */\n  clearCookies(options?: ClearCookiesOptions): Promise<void>;\n  /**\n   * Close the currently open browser.\n   *\n   * This closes browsers opened with `openInWebView(...)` or\n   * `openInSystemBrowser(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  close(): Promise<void>;\n  /**\n   * Execute a JavaScript script in the currently open web view.\n   *\n   * This method is only available for browsers opened with\n   * `openInWebView(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  executeScript(options: ExecuteScriptOptions): Promise<ExecuteScriptResult>;\n  /**\n   * Get the cookies for a specific URL.\n   *\n   * On iOS, only cookies from the shared data store are returned. Cookies from\n   * a web view opened with `dataStore: 'isolated'` are not included.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  getCookies(options: GetCookiesOptions): Promise<GetCookiesResult>;\n  /**\n   * Open a URL in the default browser app of the device.\n   *\n   * @since 0.1.0\n   */\n  openInExternalBrowser(options: OpenInExternalBrowserOptions): Promise<void>;\n  /**\n   * Open a URL in the system browser (Custom Tabs on Android,\n   * `SFSafariViewController` on iOS).\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  openInSystemBrowser(options: OpenInSystemBrowserOptions): Promise<void>;\n  /**\n   * Open a URL in an embedded web view with a native toolbar.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  openInWebView(options: OpenInWebViewOptions): Promise<void>;\n  /**\n   * Post a message to the currently open web view.\n   *\n   * The web page receives the message by listening for the\n   * `capacitorInAppBrowserMessage` window event. The message data is\n   * available in the `detail` property of the event.\n   *\n   * This method is only available for browsers opened with\n   * `openInWebView(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  postMessage(options: PostMessageOptions): Promise<void>;\n  /**\n   * Show the web view if it was opened with `visible: false`.\n   *\n   * This method is only available for browsers opened with\n   * `openInWebView(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  show(): Promise<void>;\n  /**\n   * Called when the browser is closed.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  addListener(\n    eventName: 'browserClosed',\n    listenerFunc: () => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Called when the web page posts a message to the app using the injected\n   * `window.CapacitorInAppBrowser.postMessage(...)` function.\n   *\n   * This event is only emitted for browsers opened with `openInWebView(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  addListener(\n    eventName: 'browserMessageReceived',\n    listenerFunc: (event: BrowserMessageReceivedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Called when a page navigation has been completed in the web view.\n   *\n   * This event is only emitted for browsers opened with `openInWebView(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  addListener(\n    eventName: 'browserNavigationCompleted',\n    listenerFunc: (event: BrowserNavigationCompletedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Called when the initial page of the browser has finished loading.\n   *\n   * On Android, this event is only emitted for browsers opened with\n   * `openInWebView(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  addListener(\n    eventName: 'browserPageLoaded',\n    listenerFunc: () => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Called when the current URL of the web view changes, e.g. when the user\n   * navigates to a new page, a server redirect occurs, or a single-page\n   * application updates the browser history.\n   *\n   * This event is also emitted for the initial URL and fires earlier than\n   * `browserNavigationCompleted`.\n   *\n   * This event is only emitted for browsers opened with `openInWebView(...)`.\n   *\n   * Only available on Android and iOS.\n   *\n   * @since 0.1.0\n   */\n  addListener(\n    eventName: 'browserUrlChanged',\n    listenerFunc: (event: BrowserUrlChangedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @since 0.1.0\n   */\n  removeAllListeners(): Promise<void>;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface OpenInExternalBrowserOptions {\n  /**\n   * The URL to open in the external browser.\n   *\n   * @example 'https://capawesome.io'\n   * @since 0.1.0\n   */\n  url: string;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface OpenInSystemBrowserOptions {\n  /**\n   * Options that are only applied on Android.\n   *\n   * Only available on Android.\n   *\n   * @since 0.1.0\n   */\n  android?: OpenInSystemBrowserAndroidOptions;\n  /**\n   * Options that are only applied on iOS.\n   *\n   * Only available on iOS.\n   *\n   * @since 0.1.0\n   */\n  ios?: OpenInSystemBrowserIosOptions;\n  /**\n   * The URL to open in the system browser.\n   *\n   * @example 'https://capawesome.io'\n   * @since 0.1.0\n   */\n  url: string;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface OpenInSystemBrowserAndroidOptions {\n  /**\n   * Whether or not the toolbar should be hidden when the user scrolls down\n   * and shown when the user scrolls up.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  hideToolbarOnScroll?: boolean;\n  /**\n   * Whether or not the title of the web page should be shown in the toolbar.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  showTitle?: boolean;\n  /**\n   * The background color of the toolbar as a hex color code.\n   *\n   * @example '#008080'\n   * @since 0.1.0\n   */\n  toolbarColor?: string;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface OpenInSystemBrowserIosOptions {\n  /**\n   * Whether or not the toolbar should collapse when the user scrolls down.\n   *\n   * @default true\n   * @since 0.1.0\n   */\n  barCollapsing?: boolean;\n  /**\n   * The style of the dismiss button in the toolbar.\n   *\n   * @default 'done'\n   * @since 0.1.0\n   */\n  dismissButtonStyle?: DismissButtonStyle;\n  /**\n   * Whether or not the reader mode should be entered if it is available for\n   * the web page.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  readerMode?: boolean;\n  /**\n   * The background color of the toolbar as a hex color code.\n   *\n   * @example '#008080'\n   * @since 0.1.0\n   */\n  toolbarColor?: string;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface OpenInWebViewOptions {\n  /**\n   * Options that are only applied on Android.\n   *\n   * Only available on Android.\n   *\n   * @since 0.1.0\n   */\n  android?: OpenInWebViewAndroidOptions;\n  /**\n   * The data store to use for the web view.\n   *\n   * On Android, this option is ignored. The web view always uses the\n   * app-global (`shared`) data store.\n   *\n   * Only available on iOS.\n   *\n   * @default 'shared'\n   * @since 0.1.0\n   */\n  dataStore?: WebViewDataStore;\n  /**\n   * Additional HTTP headers to send with the initial request.\n   *\n   * @since 0.1.0\n   */\n  headers?: { [key: string]: string };\n  /**\n   * Options that are only applied on iOS.\n   *\n   * Only available on iOS.\n   *\n   * @since 0.1.0\n   */\n  ios?: OpenInWebViewIosOptions;\n  /**\n   * Whether or not media playback requires user action.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  mediaPlaybackRequiresUserAction?: boolean;\n  /**\n   * Options for the toolbar of the web view.\n   *\n   * @since 0.1.0\n   */\n  toolbar?: WebViewToolbarOptions;\n  /**\n   * The URL to open in the web view.\n   *\n   * @example 'https://capawesome.io'\n   * @since 0.1.0\n   */\n  url: string;\n  /**\n   * The custom user agent to use for the web view.\n   *\n   * @since 0.1.0\n   */\n  userAgent?: string;\n  /**\n   * Whether or not the web view is presented when opened.\n   *\n   * If `false`, the web view loads the URL in the background and stays\n   * hidden until `show()` is called. The `browserPageLoaded` event is\n   * still emitted and `close()` can be called while the web view is\n   * hidden.\n   *\n   * @default true\n   * @since 0.1.0\n   */\n  visible?: boolean;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface WebViewToolbarOptions {\n  /**\n   * The background color of the toolbar as a hex color code.\n   *\n   * @example '#008080'\n   * @since 0.1.0\n   */\n  backgroundColor?: string;\n  /**\n   * The text of the close button in the toolbar.\n   *\n   * @default 'Close'\n   * @since 0.1.0\n   */\n  closeButtonText?: string;\n  /**\n   * The text color of the toolbar as a hex color code.\n   *\n   * @example '#FFFFFF'\n   * @since 0.1.0\n   */\n  color?: string;\n  /**\n   * Whether or not the back and forward navigation buttons should be shown\n   * in the toolbar.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  showNavigationButtons?: boolean;\n  /**\n   * Whether or not the current URL should be displayed in the toolbar\n   * instead of the title.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  showUrl?: boolean;\n  /**\n   * The fixed title to display in the toolbar.\n   *\n   * If not set, the title of the current web page is displayed.\n   *\n   * @since 0.1.0\n   */\n  title?: string;\n  /**\n   * Whether or not the toolbar should be visible.\n   *\n   * @default true\n   * @since 0.1.0\n   */\n  visible?: boolean;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface OpenInWebViewAndroidOptions {\n  /**\n   * Whether or not the user can zoom the web page.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  allowZoom?: boolean;\n  /**\n   * Whether or not the hardware back button navigates back in the web view's\n   * history before closing the web view.\n   *\n   * If `false`, the hardware back button closes the web view immediately.\n   *\n   * @default true\n   * @since 0.1.0\n   */\n  hardwareBackButton?: boolean;\n  /**\n   * Whether or not media playback is paused when the app is hidden.\n   *\n   * @default true\n   * @since 0.1.0\n   */\n  pauseMediaWhenHidden?: boolean;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface OpenInWebViewIosOptions {\n  /**\n   * Whether or not horizontal swipe gestures navigate back and forward in\n   * the web view's history.\n   *\n   * @default false\n   * @since 0.1.0\n   */\n  allowsBackForwardNavigationGestures?: boolean;\n  /**\n   * Whether or not the web view bounces when scrolled past the edge of the\n   * content.\n   *\n   * @default true\n   * @since 0.1.0\n   */\n  overscroll?: boolean;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface ExecuteScriptOptions {\n  /**\n   * The JavaScript code to execute in the web view.\n   *\n   * @example 'document.title'\n   * @since 0.1.0\n   */\n  script: string;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface ExecuteScriptResult {\n  /**\n   * The result of the script execution serialized as a JSON string.\n   *\n   * If the script does not return a JSON-serializable value, `null` is\n   * returned.\n   *\n   * @example '\"Capawesome\"'\n   * @since 0.1.0\n   */\n  result: string | null;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface PostMessageOptions {\n  /**\n   * The message data to post to the web view.\n   *\n   * Must be a JSON-serializable object.\n   *\n   * @example { name: 'Capawesome' }\n   * @since 0.1.0\n   */\n  data: { [key: string]: unknown };\n}\n\n/**\n * @since 0.2.0\n */\nexport interface ClearCookiesOptions {\n  /**\n   * The URL to clear the cookies for.\n   *\n   * If not provided, all cookies are cleared.\n   *\n   * @example 'https://capawesome.io'\n   * @since 0.2.0\n   */\n  url?: string;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface GetCookiesOptions {\n  /**\n   * The URL to get the cookies for.\n   *\n   * @example 'https://capawesome.io'\n   * @since 0.1.0\n   */\n  url: string;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface GetCookiesResult {\n  /**\n   * The cookies for the URL as a map of cookie names to values.\n   *\n   * @since 0.1.0\n   */\n  cookies: { [key: string]: string };\n}\n\n/**\n * @since 0.1.0\n */\nexport interface BrowserMessageReceivedEvent {\n  /**\n   * The message data posted by the web page.\n   *\n   * @since 0.1.0\n   */\n  data: unknown;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface BrowserNavigationCompletedEvent {\n  /**\n   * The URL of the page that was navigated to.\n   *\n   * @example 'https://capawesome.io'\n   * @since 0.1.0\n   */\n  url: string;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface BrowserUrlChangedEvent {\n  /**\n   * The new URL of the web view.\n   *\n   * @example 'https://capawesome.io'\n   * @since 0.1.0\n   */\n  url: string;\n}\n\n/**\n * The style of the dismiss button in the toolbar of the system browser.\n *\n * - `cancel`: A button with the text \"Cancel\".\n * - `close`: A button with the text \"Close\".\n * - `done`: A button with the text \"Done\".\n *\n * @since 0.1.0\n */\nexport type DismissButtonStyle = 'cancel' | 'close' | 'done';\n\n/**\n * The data store to use for the web view.\n *\n * - `isolated`: The web view uses a non-persistent data store. Cookies and\n *   web storage are discarded when the web view is closed.\n * - `shared`: The web view uses the app-global data store which is shared\n *   with other web views.\n *\n * @since 0.1.0\n */\nexport type WebViewDataStore = 'isolated' | 'shared';\n\n/**\n * @since 0.1.0\n */\nexport enum ErrorCode {\n  /**\n   * No app was found on the device that can open the URL.\n   *\n   * @since 0.1.0\n   */\n  BrowserNotFound = 'BROWSER_NOT_FOUND',\n  /**\n   * No browser is currently open.\n   *\n   * @since 0.1.0\n   */\n  NoBrowserOpen = 'NO_BROWSER_OPEN',\n}\n"]}

package/dist/esm/web.d.ts

@@ -3,7 +3,7 @@ import type { ExecuteScriptResult, GetCookiesResult, InAppBrowserPlugin, OpenInE
 export declare class InAppBrowserWeb extends WebPlugin implements InAppBrowserPlugin {
     private static errorUrlMissing;
     clearCache(): Promise<void>;
-    clearSessionData(): Promise<void>;
+    clearCookies(): Promise<void>;
     close(): Promise<void>;
     executeScript(): Promise<ExecuteScriptResult>;
     getCookies(): Promise<GetCookiesResult>;

package/dist/esm/web.js

@@ -3,7 +3,7 @@ export class InAppBrowserWeb extends WebPlugin {
     async clearCache() {
         throw this.unimplemented('Not implemented on web.');
     }
-    async clearSessionData() {
+    async clearCookies() {
         throw this.unimplemented('Not implemented on web.');
     }
     async close() {

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAG5C,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,qBAAqB,CACzB,OAAqC;QAErC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;;AA7Cc,+BAAe,GAAG,uBAAuB,CAAC","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  ExecuteScriptResult,\n  GetCookiesResult,\n  InAppBrowserPlugin,\n  OpenInExternalBrowserOptions,\n} from './definitions';\n\nexport class InAppBrowserWeb extends WebPlugin implements InAppBrowserPlugin {\n  private static errorUrlMissing = 'url must be provided.';\n\n  async clearCache(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async clearSessionData(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async close(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async executeScript(): Promise<ExecuteScriptResult> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async getCookies(): Promise<GetCookiesResult> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async openInExternalBrowser(\n    options: OpenInExternalBrowserOptions,\n  ): Promise<void> {\n    if (!options.url) {\n      throw new Error(InAppBrowserWeb.errorUrlMissing);\n    }\n    window.open(options.url, '_blank');\n  }\n\n  async openInSystemBrowser(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async openInWebView(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async postMessage(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async show(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAG5C,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,qBAAqB,CACzB,OAAqC;QAErC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;;AA7Cc,+BAAe,GAAG,uBAAuB,CAAC","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  ExecuteScriptResult,\n  GetCookiesResult,\n  InAppBrowserPlugin,\n  OpenInExternalBrowserOptions,\n} from './definitions';\n\nexport class InAppBrowserWeb extends WebPlugin implements InAppBrowserPlugin {\n  private static errorUrlMissing = 'url must be provided.';\n\n  async clearCache(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async clearCookies(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async close(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async executeScript(): Promise<ExecuteScriptResult> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async getCookies(): Promise<GetCookiesResult> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async openInExternalBrowser(\n    options: OpenInExternalBrowserOptions,\n  ): Promise<void> {\n    if (!options.url) {\n      throw new Error(InAppBrowserWeb.errorUrlMissing);\n    }\n    window.open(options.url, '_blank');\n  }\n\n  async openInSystemBrowser(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async openInWebView(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async postMessage(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async show(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -29,7 +29,7 @@ class InAppBrowserWeb extends core.WebPlugin {
     async clearCache() {
         throw this.unimplemented('Not implemented on web.');
     }
-    async clearSessionData() {
+    async clearCookies() {
         throw this.unimplemented('Not implemented on web.');
     }
     async close() {

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/**\n * @since 0.1.0\n */\nexport var ErrorCode;\n(function (ErrorCode) {\n    /**\n     * No app was found on the device that can open the URL.\n     *\n     * @since 0.1.0\n     */\n    ErrorCode[\"BrowserNotFound\"] = \"BROWSER_NOT_FOUND\";\n    /**\n     * No browser is currently open.\n     *\n     * @since 0.1.0\n     */\n    ErrorCode[\"NoBrowserOpen\"] = \"NO_BROWSER_OPEN\";\n})(ErrorCode || (ErrorCode = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\nconst InAppBrowser = registerPlugin('InAppBrowser', {\n    web: () => import('./web').then(m => new m.InAppBrowserWeb()),\n});\nexport * from './definitions';\nexport { InAppBrowser };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class InAppBrowserWeb extends WebPlugin {\n    async clearCache() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async clearSessionData() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async close() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async executeScript() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getCookies() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async openInExternalBrowser(options) {\n        if (!options.url) {\n            throw new Error(InAppBrowserWeb.errorUrlMissing);\n        }\n        window.open(options.url, '_blank');\n    }\n    async openInSystemBrowser() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async openInWebView() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async postMessage() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async show() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n}\nInAppBrowserWeb.errorUrlMissing = 'url must be provided.';\n//# sourceMappingURL=web.js.map"],"names":["ErrorCode","registerPlugin","WebPlugin"],"mappings":";;;;AAAA;AACA;AACA;AACWA;AACX,CAAC,UAAU,SAAS,EAAE;AACtB;AACA;AACA;AACA;AACA;AACA,IAAI,SAAS,CAAC,iBAAiB,CAAC,GAAG,mBAAmB;AACtD;AACA;AACA;AACA;AACA;AACA,IAAI,SAAS,CAAC,eAAe,CAAC,GAAG,iBAAiB;AAClD,CAAC,EAAEA,iBAAS,KAAKA,iBAAS,GAAG,EAAE,CAAC,CAAC;;AChB5B,MAAC,YAAY,GAAGC,mBAAc,CAAC,cAAc,EAAE;AACpD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;AACjE,CAAC;;ACFM,MAAM,eAAe,SAASC,cAAS,CAAC;AAC/C,IAAI,MAAM,UAAU,GAAG;AACvB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,KAAK,GAAG;AAClB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,aAAa,GAAG;AAC1B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,UAAU,GAAG;AACvB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,qBAAqB,CAAC,OAAO,EAAE;AACzC,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;AAC1B,YAAY,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,eAAe,CAAC;AAC5D,QAAQ;AACR,QAAQ,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC;AAC1C,IAAI;AACJ,IAAI,MAAM,mBAAmB,GAAG;AAChC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,aAAa,GAAG;AAC1B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,WAAW,GAAG;AACxB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,IAAI,GAAG;AACjB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ;AACA,eAAe,CAAC,eAAe,GAAG,uBAAuB;;;;;;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/**\n * @since 0.1.0\n */\nexport var ErrorCode;\n(function (ErrorCode) {\n    /**\n     * No app was found on the device that can open the URL.\n     *\n     * @since 0.1.0\n     */\n    ErrorCode[\"BrowserNotFound\"] = \"BROWSER_NOT_FOUND\";\n    /**\n     * No browser is currently open.\n     *\n     * @since 0.1.0\n     */\n    ErrorCode[\"NoBrowserOpen\"] = \"NO_BROWSER_OPEN\";\n})(ErrorCode || (ErrorCode = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\nconst InAppBrowser = registerPlugin('InAppBrowser', {\n    web: () => import('./web').then(m => new m.InAppBrowserWeb()),\n});\nexport * from './definitions';\nexport { InAppBrowser };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class InAppBrowserWeb extends WebPlugin {\n    async clearCache() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async clearCookies() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async close() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async executeScript() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getCookies() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async openInExternalBrowser(options) {\n        if (!options.url) {\n            throw new Error(InAppBrowserWeb.errorUrlMissing);\n        }\n        window.open(options.url, '_blank');\n    }\n    async openInSystemBrowser() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async openInWebView() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async postMessage() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async show() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n}\nInAppBrowserWeb.errorUrlMissing = 'url must be provided.';\n//# sourceMappingURL=web.js.map"],"names":["ErrorCode","registerPlugin","WebPlugin"],"mappings":";;;;AAAA;AACA;AACA;AACWA;AACX,CAAC,UAAU,SAAS,EAAE;AACtB;AACA;AACA;AACA;AACA;AACA,IAAI,SAAS,CAAC,iBAAiB,CAAC,GAAG,mBAAmB;AACtD;AACA;AACA;AACA;AACA;AACA,IAAI,SAAS,CAAC,eAAe,CAAC,GAAG,iBAAiB;AAClD,CAAC,EAAEA,iBAAS,KAAKA,iBAAS,GAAG,EAAE,CAAC,CAAC;;AChB5B,MAAC,YAAY,GAAGC,mBAAc,CAAC,cAAc,EAAE;AACpD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;AACjE,CAAC;;ACFM,MAAM,eAAe,SAASC,cAAS,CAAC;AAC/C,IAAI,MAAM,UAAU,GAAG;AACvB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,YAAY,GAAG;AACzB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,KAAK,GAAG;AAClB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,aAAa,GAAG;AAC1B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,UAAU,GAAG;AACvB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,qBAAqB,CAAC,OAAO,EAAE;AACzC,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;AAC1B,YAAY,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,eAAe,CAAC;AAC5D,QAAQ;AACR,QAAQ,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC;AAC1C,IAAI;AACJ,IAAI,MAAM,mBAAmB,GAAG;AAChC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,aAAa,GAAG;AAC1B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,WAAW,GAAG;AACxB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,IAAI,GAAG;AACjB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ;AACA,eAAe,CAAC,eAAe,GAAG,uBAAuB;;;;;;;;;"}

package/dist/plugin.js

@@ -28,7 +28,7 @@ var capacitorInAppBrowser = (function (exports, core) {
         async clearCache() {
             throw this.unimplemented('Not implemented on web.');
         }
-        async clearSessionData() {
+        async clearCookies() {
             throw this.unimplemented('Not implemented on web.');
         }
         async close() {

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/**\n * @since 0.1.0\n */\nexport var ErrorCode;\n(function (ErrorCode) {\n    /**\n     * No app was found on the device that can open the URL.\n     *\n     * @since 0.1.0\n     */\n    ErrorCode[\"BrowserNotFound\"] = \"BROWSER_NOT_FOUND\";\n    /**\n     * No browser is currently open.\n     *\n     * @since 0.1.0\n     */\n    ErrorCode[\"NoBrowserOpen\"] = \"NO_BROWSER_OPEN\";\n})(ErrorCode || (ErrorCode = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\nconst InAppBrowser = registerPlugin('InAppBrowser', {\n    web: () => import('./web').then(m => new m.InAppBrowserWeb()),\n});\nexport * from './definitions';\nexport { InAppBrowser };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class InAppBrowserWeb extends WebPlugin {\n    async clearCache() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async clearSessionData() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async close() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async executeScript() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getCookies() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async openInExternalBrowser(options) {\n        if (!options.url) {\n            throw new Error(InAppBrowserWeb.errorUrlMissing);\n        }\n        window.open(options.url, '_blank');\n    }\n    async openInSystemBrowser() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async openInWebView() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async postMessage() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async show() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n}\nInAppBrowserWeb.errorUrlMissing = 'url must be provided.';\n//# sourceMappingURL=web.js.map"],"names":["ErrorCode","registerPlugin","WebPlugin"],"mappings":";;;IAAA;IACA;IACA;AACWA;IACX,CAAC,UAAU,SAAS,EAAE;IACtB;IACA;IACA;IACA;IACA;IACA,IAAI,SAAS,CAAC,iBAAiB,CAAC,GAAG,mBAAmB;IACtD;IACA;IACA;IACA;IACA;IACA,IAAI,SAAS,CAAC,eAAe,CAAC,GAAG,iBAAiB;IAClD,CAAC,EAAEA,iBAAS,KAAKA,iBAAS,GAAG,EAAE,CAAC,CAAC;;AChB5B,UAAC,YAAY,GAAGC,mBAAc,CAAC,cAAc,EAAE;IACpD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;IACjE,CAAC;;ICFM,MAAM,eAAe,SAASC,cAAS,CAAC;IAC/C,IAAI,MAAM,UAAU,GAAG;IACvB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,KAAK,GAAG;IAClB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,aAAa,GAAG;IAC1B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,UAAU,GAAG;IACvB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,qBAAqB,CAAC,OAAO,EAAE;IACzC,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;IAC1B,YAAY,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,eAAe,CAAC;IAC5D,QAAQ;IACR,QAAQ,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC;IAC1C,IAAI;IACJ,IAAI,MAAM,mBAAmB,GAAG;IAChC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,aAAa,GAAG;IAC1B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,WAAW,GAAG;IACxB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,IAAI,GAAG;IACjB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ;IACA,eAAe,CAAC,eAAe,GAAG,uBAAuB;;;;;;;;;;;;;;;"}
+{"version":3,"file":"plugin.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/**\n * @since 0.1.0\n */\nexport var ErrorCode;\n(function (ErrorCode) {\n    /**\n     * No app was found on the device that can open the URL.\n     *\n     * @since 0.1.0\n     */\n    ErrorCode[\"BrowserNotFound\"] = \"BROWSER_NOT_FOUND\";\n    /**\n     * No browser is currently open.\n     *\n     * @since 0.1.0\n     */\n    ErrorCode[\"NoBrowserOpen\"] = \"NO_BROWSER_OPEN\";\n})(ErrorCode || (ErrorCode = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\nconst InAppBrowser = registerPlugin('InAppBrowser', {\n    web: () => import('./web').then(m => new m.InAppBrowserWeb()),\n});\nexport * from './definitions';\nexport { InAppBrowser };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class InAppBrowserWeb extends WebPlugin {\n    async clearCache() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async clearCookies() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async close() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async executeScript() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getCookies() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async openInExternalBrowser(options) {\n        if (!options.url) {\n            throw new Error(InAppBrowserWeb.errorUrlMissing);\n        }\n        window.open(options.url, '_blank');\n    }\n    async openInSystemBrowser() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async openInWebView() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async postMessage() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async show() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n}\nInAppBrowserWeb.errorUrlMissing = 'url must be provided.';\n//# sourceMappingURL=web.js.map"],"names":["ErrorCode","registerPlugin","WebPlugin"],"mappings":";;;IAAA;IACA;IACA;AACWA;IACX,CAAC,UAAU,SAAS,EAAE;IACtB;IACA;IACA;IACA;IACA;IACA,IAAI,SAAS,CAAC,iBAAiB,CAAC,GAAG,mBAAmB;IACtD;IACA;IACA;IACA;IACA;IACA,IAAI,SAAS,CAAC,eAAe,CAAC,GAAG,iBAAiB;IAClD,CAAC,EAAEA,iBAAS,KAAKA,iBAAS,GAAG,EAAE,CAAC,CAAC;;AChB5B,UAAC,YAAY,GAAGC,mBAAc,CAAC,cAAc,EAAE;IACpD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;IACjE,CAAC;;ICFM,MAAM,eAAe,SAASC,cAAS,CAAC;IAC/C,IAAI,MAAM,UAAU,GAAG;IACvB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,YAAY,GAAG;IACzB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,KAAK,GAAG;IAClB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,aAAa,GAAG;IAC1B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,UAAU,GAAG;IACvB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,qBAAqB,CAAC,OAAO,EAAE;IACzC,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;IAC1B,YAAY,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,eAAe,CAAC;IAC5D,QAAQ;IACR,QAAQ,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC;IAC1C,IAAI;IACJ,IAAI,MAAM,mBAAmB,GAAG;IAChC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,aAAa,GAAG;IAC1B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,WAAW,GAAG;IACxB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,IAAI,GAAG;IACjB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ;IACA,eAAe,CAAC,eAAe,GAAG,uBAAuB;;;;;;;;;;;;;;;"}

package/ios/Plugin/Classes/Options/ClearCookiesOptions.swift

@@ -0,0 +1,20 @@
+import Foundation
+import Capacitor
+
+@objc public class ClearCookiesOptions: NSObject {
+    let url: URL?
+
+    init(_ call: CAPPluginCall) throws {
+        self.url = try ClearCookiesOptions.getUrlFromCall(call)
+    }
+
+    private static func getUrlFromCall(_ call: CAPPluginCall) throws -> URL? {
+        guard let urlString = call.getString("url"), !urlString.isEmpty else {
+            return nil
+        }
+        guard let url = URL(string: urlString) else {
+            throw CustomError.urlInvalid
+        }
+        return url
+    }
+}

package/ios/Plugin/InAppBrowser.swift

@@ -24,11 +24,30 @@ import WebKit
         }
     }
 
-    @objc public func clearSessionData(completion: @escaping (_ error: Error?) -> Void) {
+    @objc public func clearCookies(_ options: ClearCookiesOptions, completion: @escaping (_ error: Error?) -> Void) {
         DispatchQueue.main.async {
-            let types: Set<String> = [WKWebsiteDataTypeCookies, WKWebsiteDataTypeLocalStorage, WKWebsiteDataTypeSessionStorage]
-            WKWebsiteDataStore.default().removeData(ofTypes: types, modifiedSince: .distantPast) {
-                completion(nil)
+            let dataStore = WKWebsiteDataStore.default()
+            guard let url = options.url else {
+                dataStore.removeData(ofTypes: [WKWebsiteDataTypeCookies], modifiedSince: .distantPast) {
+                    completion(nil)
+                }
+                return
+            }
+            let cookieStore = dataStore.httpCookieStore
+            cookieStore.getAllCookies { cookies in
+                let cookiesToDelete = cookies.filter { cookie in
+                    InAppBrowserHelper.isCookie(cookie, matchingURL: url)
+                }
+                let dispatchGroup = DispatchGroup()
+                for cookie in cookiesToDelete {
+                    dispatchGroup.enter()
+                    cookieStore.delete(cookie) {
+                        dispatchGroup.leave()
+                    }
+                }
+                dispatchGroup.notify(queue: .main) {
+                    completion(nil)
+                }
             }
         }
     }

package/ios/Plugin/InAppBrowserPlugin.swift

@@ -7,7 +7,7 @@ public class InAppBrowserPlugin: CAPPlugin, CAPBridgedPlugin {
     public let jsName = "InAppBrowser"
     public let pluginMethods: [CAPPluginMethod] = [
         CAPPluginMethod(name: "clearCache", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "clearSessionData", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "clearCookies", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "close", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "executeScript", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "getCookies", returnType: CAPPluginReturnPromise),
@@ -37,14 +37,20 @@ public class InAppBrowserPlugin: CAPPlugin, CAPBridgedPlugin {
         })
     }
 
-    @objc func clearSessionData(_ call: CAPPluginCall) {
-        implementation?.clearSessionData(completion: { error in
-            if let error = error {
-                self.rejectCall(call, error)
-                return
-            }
-            self.resolveCall(call)
-        })
+    @objc func clearCookies(_ call: CAPPluginCall) {
+        do {
+            let options = try ClearCookiesOptions(call)
+
+            implementation?.clearCookies(options, completion: { error in
+                if let error = error {
+                    self.rejectCall(call, error)
+                    return
+                }
+                self.resolveCall(call)
+            })
+        } catch {
+            rejectCall(call, error)
+        }
     }
 
     @objc func close(_ call: CAPPluginCall) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capawesome/capacitor-in-app-browser",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Capacitor plugin to open URLs in the external browser, the system browser or an embedded web view on Android, iOS, and Web.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -67,15 +67,15 @@
   },
   "devDependencies": {
     "@capacitor/android": "8.0.0",
-    "@capacitor/cli": "8.0.0",
+    "@capacitor/cli": "8.4.2",
     "@capacitor/core": "8.0.0",
     "@capacitor/docgen": "0.3.1",
     "@capacitor/ios": "8.0.0",
     "@ionic/eslint-config": "0.4.0",
     "eslint": "8.57.0",
-    "prettier-plugin-java": "2.6.7",
+    "prettier-plugin-java": "2.9.7",
     "rimraf": "6.1.2",
-    "rollup": "4.53.3",
+    "rollup": "4.62.3",
     "swiftlint": "2.0.0",
     "typescript": "5.9.3"
   },