Guide
Comment utiliser In App Browser dans Capacitor
Utilisation de @capgo/capacitor-inappbrowser
@capgo/capacitor-inappbrowser ouvre du contenu web externe depuis une application Capacitor. Utilisez open() pour la surface navigateur de la plateforme, ou openWebView() lorsque votre application nécessite une WebView native gérée avec taille personnalisée, barre d'outils, messages, scripts, téléchargements, proxy, contrôle des popups, stockage privé ou interface Ionic superposée à la page.
Installer
npm install @capgo/capacitor-inappbrowser
npx cap sync
Ce que ce plugin expose
- Flux de navigateur système avec Chrome Custom Tabs sur Android et
SFSafariViewControllersur iOS. - WebViews gérées pouvant être redimensionnées, masquées, affichées, déplacées derrière l'application Capacitor et ramenées au premier plan.
- Transfert des clics, touches et défilements avec
dispatchInputEvent()when app UI sits above the browser. - Navigateurs en écran partiel : les clics hors du cadre de la WebView native sont transmis à l'app Capacitor sur Android et iOS.
- Nettoyage complet des cookies, cache et données de navigation avec
persistWebViewData,clearCookies,clearAllCookies,clearCache, etclearAllBrowsingData. - Communication app vers page avec
postMessage(), communication page vers app avecwindow.mobileApp.postMessage(...), et l'injection de scripts avecexecuteScript(). - Gestion des téléchargements, règles de proxy natives, contrôle des popups, prise en charge de Google Pay,
_blankgestion des liens et instances de navigateur masquées préchargeables.
Cas d'usage courants
Afficher l'interface de l'app au-dessus d'un navigateur live
import { InAppBrowser } from '@capgo/capacitor-inappbrowser';
const { id } = await InAppBrowser.openWebView({
url: 'https://example.com/checkout',
toBack: true,
transparentBackground: true,
});
await InAppBrowser.dispatchInputEvent({
id,
type: 'click',
x: 160,
y: 420,
});
await InAppBrowser.bringToFront({ id });
Utilisez-le pour les overlays de checkout, les flux de paiement via navigateur, les parcours d'assistance guidés ou toute fonctionnalité où les contrôles Ionic doivent rester au-dessus du contenu web live.
Garder l'app cliquable autour d'une sheet navigateur
const { id } = await InAppBrowser.openWebView({
url: 'https://example.com/offers',
height: window.innerHeight - 200,
y: 0,
});
await InAppBrowser.updateDimensions({ id, height: window.innerHeight });
Un navigateur de taille personnalisée ne capture les touches qu'à l'intérieur de son cadre. La partie visible restante de l'app reste tactile sur Android et iOS.
Éviter les sessions web persistantes
const { id } = await InAppBrowser.openWebView({
url: 'https://example.com/login',
persistWebViewData: false,
});
await InAppBrowser.clearAllBrowsingData();
await InAppBrowser.close({ id });
Utilisez-le pour le changement de compte, les tests de checkout, l'impersonation pour le support ou les flux d'authentification où les cookies, le cache, le stockage local et IndexedDB ne doivent pas persister plus longtemps que nécessaire.
Précharger et permuter plusieurs WebViews
const first = await InAppBrowser.openWebView({ url: 'https://example.com/a', hidden: true });
const second = await InAppBrowser.openWebView({ url: 'https://example.com/b', hidden: true });
await InAppBrowser.show({ id: first.id });
await InAppBrowser.hide({ id: first.id });
await InAppBrowser.show({ id: second.id });
Les instances masquées conservent leur état tout en évitant les superpositions natives qui bloquent les touches sur l’app.
Intégrez une web app avancée
const { id } = await InAppBrowser.openWebView({
url: 'https://example.com/portal',
handleDownloads: true,
openBlankTargetInWebView: true,
hiddenPopupWindow: true,
outboundProxyRules: [
{
urlRegex: '^https://example\\.com/api/',
action: 'delegateToJs',
},
],
});
await InAppBrowser.postMessage({
id,
detail: { source: 'app', action: 'refresh' },
});
Utilisez ce pattern pour les portails documentaires, les flux d'upload, les help desks, les appels vidéo, les pages Google Pay ou les web apps interactives qui ont besoin du contrôle de l'app native sans quitter l'app shell.
Référence complète
- GitHub : https://github.com/Cap-go/capacitor-inappbrowser/
- Docs : /docs/plugins/inappbrowser/
Continuer depuis Utiliser @capgo/capacitor-inappbrowser
Si vous utilisez Utilisation de @capgo/capacitor-inappbrowser pour planifier le travail sur les plugins natifs, connectez-l’à @capgo/capacitor-inappbrowser pour les détails d'implémentation dans @capgo/capacitor-inappbrowser, Prise en main pour les détails d'implémentation dans Getting Started Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans les plugins Capacitor par Capgo, et Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Adding or Updating Plugins.