@capgo/capacitor-inappbrowser 8.18.0 → 8.19.0

package/README.md

@@ -1590,7 +1590,8 @@ See the README section "openSecureWindow (OAuth)" for full setup examples.
 | **`useSharedDataStore`**               | <code>boolean</code>                                                                                                                                                   | Share the host Capacitor WebView's website data store (cookies, local storage, etc.). On iOS 17+, InAppBrowser uses an isolated plugin-owned `WKWebsiteDataStore` by default so host and browser data stay separate. Set this to `true` to use `WKWebsiteDataStore.default()` instead, which shares session cookies with the Capacitor host WebView. Useful for SSO / OIDC silent login when the IdP session was established in the main app WebView. Requires `persistWebViewData: true` (the default). When `persistWebViewData` is false, a non-persistent store is used and this option has no effect. On Android this is a no-op: cookies are already process-global via `CookieManager`. On Web this is a no-op. Warning: clearing cookies/cache for a webview opened with this flag can affect the host WebView on iOS, because both share the same store. `clearAllBrowsingData()` still skips the host store. | <code>false</code>                                            | 8.13.6 |
 | **`clientCertificate`**                | <code>'none' \| 'prompt'</code>                                                                                                                                        | Controls Android TLS client certificate prompts during HTTPS handshakes. Use `prompt` to show the system certificate picker; omit or use `none` to cancel silently (default).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <code>"none"</code>                                           | 8.7.5  |
 | **`clientCertificatePrompt`**          | <code>boolean</code>                                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |                                                               |        |
-| **`handleDownloads`**                  | <code>boolean</code>                                                                                                                                                   | Automatically handles downloads triggered inside the webview without requiring a custom JavaScript bridge. When enabled: - Standard attachment responses are written to a temporary file. - `blob:` downloads are also captured when the platform supports them. - Previewable files reopen inside the in-app browser when possible. - Other files are handed off to the native preview or viewer flow. - `downloadCompleted` and `downloadFailed` events notify the host app about the saved file.                                                                                                                                                                                                                                                                                                                                                                                                                    | <code>false</code>                                            | 8.6.0  |
+| **`handleDownloads`**                  | <code>boolean</code>                                                                                                                                                   | Automatically handles downloads triggered inside the webview without requiring a custom JavaScript bridge. When enabled: - Standard attachment responses are written to a temporary file. - `blob:` downloads are also captured when the platform supports them. - Previewable files reopen inside the in-app browser when possible (see `downloadPreview`). - Other files are handed off to the native preview or viewer flow. - `downloadCompleted` and `downloadFailed` events notify the host app about the saved file.                                                                                                                                                                                                                                                                                                                                                                                            | <code>false</code>                                            | 8.6.0  |
+| **`downloadPreview`**                  | <code><a href="#downloadpreview">DownloadPreview</a></code>                                                                                                            | Controls where managed downloads are previewed after saving. - `'inAppBrowser'` (default): Reopens previewable files (PDF, images, text, JSON) inside the same webview. - `'systemPreview'`: Opens the system Quick Look preview with share and Save to Files actions. iOS only; ignored on Android. Requires `handleDownloads: true`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | <code>"inAppBrowser"</code>                                   | 8.19.0 |
 | **`shareDisclaimer`**                  | <code><a href="#disclaimeroptions">DisclaimerOptions</a></code>                                                                                                        | Share options for the webview. When provided, shows a disclaimer dialog before sharing content. This is useful for: - Warning users about sharing sensitive information - Getting user consent before sharing - Explaining what will be shared - Complying with privacy regulations Note: shareSubject is required when using shareDisclaimer                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                               | 0.1.0  |
 | **`toolbarType`**                      | <code><a href="#toolbartype">ToolBarType</a></code>                                                                                                                    | Toolbar type determines the appearance and behavior of the browser's toolbar - "activity": Shows a simple toolbar with just a close button and share button - "navigation": Shows a full navigation toolbar with back/forward buttons - "blank": Shows no toolbar - "": Default toolbar with close button                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <code>ToolBarType.DEFAULT</code>                              | 0.1.0  |
 | **`shareSubject`**                     | <code>string</code>                                                                                                                                                    | Subject text for sharing. Required when using shareDisclaimer. This text will be used as the subject line when sharing content.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |                                                               | 0.1.0  |
@@ -1956,6 +1957,13 @@ Construct a type with a set of properties K of type T
 <code>'click' | 'touchstart' | 'touchmove' | 'touchend' | 'touchcancel'</code>
 
 
+#### DownloadPreview
+
+Where managed downloads are previewed after saving.
+
+<code>'inAppBrowser' | 'systemPreview'</code>
+
+
 #### PreferredContentMode
 
 Web content rendering mode for managed WKWebViews on iOS.

package/android/src/main/assets/proxy-bridge.js

@@ -81,7 +81,7 @@
   function resolveProxyBridgeUrl(rawUrl, baseUrl) {
     try {
       return new URL(rawUrl, baseUrl).href;
-    } catch (_error) {
+    } catch (e) {
       return null;
     }
   }
@@ -130,7 +130,7 @@
           form.requestSubmit();
         }
         return;
-      } catch (_error) {
+      } catch (e) {
         delete form.__capgoSkipNextProxySubmit;
       }
     }
@@ -168,7 +168,7 @@
     if (proxyRegexSource) {
       try {
         proxyRequestPattern = new RegExp(proxyRegexSource);
-      } catch (_error) {
+      } catch (e) {
         proxyRequestPattern = null;
       }
     }
@@ -209,7 +209,7 @@
       if (url && !url.match(/^[a-zA-Z][a-zA-Z0-9+\-.]*:\/\//)) {
         try {
           return new URL(url, getDocumentBaseUrl()).href;
-        } catch (_error) {
+        } catch (e) {
           return url;
         }
       }
@@ -289,7 +289,7 @@
       if (submitter instanceof HTMLElement) {
         try {
           return new FormData(form, submitter);
-        } catch (_error) {
+        } catch (e) {
         }
       }
       return new FormData(form);
@@ -450,7 +450,7 @@
         let proxyUrl;
         try {
           proxyUrl = yield storeInterceptedRequest(url, method, headers, body, credentialsMode);
-        } catch (_error) {
+        } catch (e) {
           return originalFetch.call(window, input, init);
         }
         const proxyResponse = yield originalFetch.call(globalThis, proxyUrl, {

package/android/src/main/java/ee/forgr/capacitor_inappbrowser/CapgoInAppBrowserPlugin.java

@@ -1117,6 +1117,18 @@ public class CapgoInAppBrowserPlugin extends Plugin implements WebViewDialog.Per
         options.setAllowScreenshotsFromWebPage(Boolean.TRUE.equals(call.getBoolean("allowScreenshotsFromWebPage", false)));
         options.setCaptureConsoleLogs(Boolean.TRUE.equals(call.getBoolean("captureConsoleLogs", false)));
         options.setHandleDownloads(Boolean.TRUE.equals(call.getBoolean("handleDownloads", false)));
+        String downloadPreview = call.getString("downloadPreview", "inAppBrowser");
+        if (downloadPreview != null) {
+            String normalizedDownloadPreview = downloadPreview.toLowerCase(Locale.ROOT);
+            if ("inappbrowser".equals(normalizedDownloadPreview)) {
+                options.setDownloadPreview("inAppBrowser");
+            } else if ("systempreview".equals(normalizedDownloadPreview)) {
+                options.setDownloadPreview("systemPreview");
+            } else {
+                call.reject("downloadPreview must be 'inAppBrowser' or 'systemPreview'");
+                return;
+            }
+        }
 
         options.setPersistWebViewData(call.getBoolean("persistWebViewData", true));
         options.setClearCookiesOnOpen(Boolean.TRUE.equals(call.getBoolean("clearCookiesOnOpen", false)));
@@ -1394,7 +1406,10 @@ public class CapgoInAppBrowserPlugin extends Plugin implements WebViewDialog.Per
             availableResources.append(drawables[i].getName()).append(", ");
         }
         if (drawables.length > 10) {
-            availableResources.append("... (").append(drawables.length - 10).append(" more)");
+            availableResources
+                .append("... (")
+                .append(drawables.length - 10)
+                .append(" more)");
         }
         return availableResources;
     }

package/android/src/main/java/ee/forgr/capacitor_inappbrowser/Options.java

@@ -204,6 +204,8 @@ public class Options {
     private boolean allowScreenshotsFromWebPage = false;
     private boolean captureConsoleLogs = false;
     private boolean handleDownloads = false;
+    /** Accepted for API parity with iOS; Android already uses an external viewer for managed downloads. */
+    private String downloadPreview = "inAppBrowser";
     private boolean persistWebViewData = true;
     private boolean clearCookiesOnOpen = false;
     private boolean clearCacheOnOpen = false;
@@ -315,6 +317,14 @@ public class Options {
         this.handleDownloads = handleDownloads;
     }
 
+    public String getDownloadPreview() {
+        return downloadPreview;
+    }
+
+    public void setDownloadPreview(String downloadPreview) {
+        this.downloadPreview = downloadPreview;
+    }
+
     public boolean getPersistWebViewData() {
         return persistWebViewData;
     }
@@ -900,6 +910,7 @@ public class Options {
         copy.setAllowScreenshotsFromWebPage(allowScreenshotsFromWebPage);
         copy.setCaptureConsoleLogs(captureConsoleLogs);
         copy.setHandleDownloads(handleDownloads);
+        copy.setDownloadPreview(downloadPreview);
         copy.setInvisibilityMode(invisibilityMode);
         copy.setPopupWindowMode(true);
         copy.setHiddenPopupWindow(hiddenPopupWindow);

package/android/src/main/java/ee/forgr/capacitor_inappbrowser/WebViewDialog.java

@@ -2373,7 +2373,7 @@ public class WebViewDialog extends ComponentDialog implements ProxyResponseRouti
                         "Has camera permission: " +
                             (activity != null &&
                                 activity.checkSelfPermission(android.Manifest.permission.CAMERA) ==
-                                android.content.pm.PackageManager.PERMISSION_GRANTED)
+                                    android.content.pm.PackageManager.PERMISSION_GRANTED)
                     );
 
                     // Check if the file chooser is already open
@@ -6824,22 +6824,19 @@ public class WebViewDialog extends ComponentDialog implements ProxyResponseRouti
         if (executorService.isShutdown()) {
             return;
         }
-        Thread shutdownThread = new Thread(
-            () -> {
-                try {
-                    executorService.shutdown();
-                    if (!executorService.awaitTermination(500, TimeUnit.MILLISECONDS)) {
-                        executorService.shutdownNow();
-                    }
-                } catch (InterruptedException e) {
-                    Thread.currentThread().interrupt();
+        Thread shutdownThread = new Thread(() -> {
+            try {
+                executorService.shutdown();
+                if (!executorService.awaitTermination(500, TimeUnit.MILLISECONDS)) {
                     executorService.shutdownNow();
-                } catch (Exception e) {
-                    Log.e("InAppBrowser", "Error shutting down executor: " + e.getMessage());
                 }
-            },
-            "InAppBrowser-ExecutorShutdown"
-        );
+            } catch (InterruptedException e) {
+                Thread.currentThread().interrupt();
+                executorService.shutdownNow();
+            } catch (Exception e) {
+                Log.e("InAppBrowser", "Error shutting down executor: " + e.getMessage());
+            }
+        }, "InAppBrowser-ExecutorShutdown");
         shutdownThread.setDaemon(true);
         shutdownThread.start();
     }

package/dist/docs.json

@@ -1684,10 +1684,28 @@
               "name": "since"
             }
           ],
-          "docs": "Automatically handles downloads triggered inside the webview without requiring a custom JavaScript bridge.\n\nWhen enabled:\n- Standard attachment responses are written to a temporary file.\n- `blob:` downloads are also captured when the platform supports them.\n- Previewable files reopen inside the in-app browser when possible.\n- Other files are handed off to the native preview or viewer flow.\n- `downloadCompleted` and `downloadFailed` events notify the host app about the saved file.",
+          "docs": "Automatically handles downloads triggered inside the webview without requiring a custom JavaScript bridge.\n\nWhen enabled:\n- Standard attachment responses are written to a temporary file.\n- `blob:` downloads are also captured when the platform supports them.\n- Previewable files reopen inside the in-app browser when possible (see `downloadPreview`).\n- Other files are handed off to the native preview or viewer flow.\n- `downloadCompleted` and `downloadFailed` events notify the host app about the saved file.",
           "complexTypes": [],
           "type": "boolean | undefined"
         },
+        {
+          "name": "downloadPreview",
+          "tags": [
+            {
+              "text": "\"inAppBrowser\"",
+              "name": "default"
+            },
+            {
+              "text": "8.19.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Controls where managed downloads are previewed after saving.\n\n- `'inAppBrowser'` (default): Reopens previewable files (PDF, images, text, JSON) inside the same webview.\n- `'systemPreview'`: Opens the system Quick Look preview with share and Save to Files actions. iOS only; ignored on Android.\n\nRequires `handleDownloads: true`.",
+          "complexTypes": [
+            "DownloadPreview"
+          ],
+          "type": "DownloadPreview"
+        },
         {
           "name": "shareDisclaimer",
           "tags": [
@@ -3861,6 +3879,21 @@
         }
       ]
     },
+    {
+      "name": "DownloadPreview",
+      "slug": "downloadpreview",
+      "docs": "Where managed downloads are previewed after saving.",
+      "types": [
+        {
+          "text": "'inAppBrowser'",
+          "complexTypes": []
+        },
+        {
+          "text": "'systemPreview'",
+          "complexTypes": []
+        }
+      ]
+    },
     {
       "name": "PreferredContentMode",
       "slug": "preferredcontentmode",

package/dist/esm/definitions.d.ts

@@ -331,6 +331,12 @@ export interface ConsoleMessageEvent {
  * @since 8.6.0
  */
 export type DownloadHandledBy = 'inAppBrowser' | 'systemPreview' | 'external';
+/**
+ * Where managed downloads are previewed after saving.
+ *
+ * @since 8.19.0
+ */
+export type DownloadPreview = 'inAppBrowser' | 'systemPreview';
 /**
  * Event emitted after a managed download is saved locally.
  *
@@ -822,7 +828,7 @@ export interface OpenWebViewOptions {
      * When enabled:
      * - Standard attachment responses are written to a temporary file.
      * - `blob:` downloads are also captured when the platform supports them.
-     * - Previewable files reopen inside the in-app browser when possible.
+     * - Previewable files reopen inside the in-app browser when possible (see `downloadPreview`).
      * - Other files are handed off to the native preview or viewer flow.
      * - `downloadCompleted` and `downloadFailed` events notify the host app about the saved file.
      *
@@ -830,6 +836,18 @@ export interface OpenWebViewOptions {
      * @since 8.6.0
      */
     handleDownloads?: boolean;
+    /**
+     * Controls where managed downloads are previewed after saving.
+     *
+     * - `'inAppBrowser'` (default): Reopens previewable files (PDF, images, text, JSON) inside the same webview.
+     * - `'systemPreview'`: Opens the system Quick Look preview with share and Save to Files actions. iOS only; ignored on Android.
+     *
+     * Requires `handleDownloads: true`.
+     *
+     * @default "inAppBrowser"
+     * @since 8.19.0
+     */
+    downloadPreview?: DownloadPreview;
     /**
      * Share options for the webview. When provided, shows a disclaimer dialog before sharing content.
      * This is useful for: