Aller au contenu principal
@capgo/capacitor-inappbrowser Renommé Renommé de @capgo/inappbrowser en @capgo/capacitor-inappbrowser. UI & système Open source

Navigateur intégré à l'application Plugin Capacitor

Ouvrez des WebViews gérées dans l'application avec superposition d'UI native, sessions privées, téléchargements, proxy et messagerie

Installer

bun add @capgo/capacitor-inappbrowser bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-inappbrowser
  • pnpm add @capgo/capacitor-inappbrowser
  • yarn add @capgo/capacitor-inappbrowser

Guide

Comment utiliser In App Browser dans Capacitor

Tester sur l'appareil

Téléchargez l'application Capgo, puis scannez le QR code.

QR d'aperçu du plugin In App Browser code

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 SFSafariViewController sur 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, et clearAllBrowsingData.
  • Communication app vers page avec postMessage(), communication page vers app avec window.mobileApp.postMessage(...), et l'injection de scripts avec executeScript().
  • Gestion des téléchargements, règles de proxy natives, contrôle des popups, prise en charge de Google Pay, _blank gestion 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

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.

FAQ

FAQ du plugin In App Browser

Comment installer le plugin In App Browser dans une application Capacitor ?

Exécutez « bun add @capgo/capacitor-inappbrowser » (ou « npm install @capgo/capacitor-inappbrowser »), puis lancez « bunx cap sync » pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis « @capgo/capacitor-inappbrowser » dans le code de votre application.

Est-ce que @capgo/capacitor-inappbrowser fonctionne avec React, Vue et Angular ?

Oui. In App Browser est un package Capacitor : il fonctionne donc avec n'importe quel framework web qui tourne dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript simple.

Quelle version de Capacitor est supportée par @capgo/capacitor-inappbrowser ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

@capgo/capacitor-inappbrowser est-il gratuit et open source ?

Oui. Le code source est public sur GitHub à l’adresse https://github.com/Cap-go/capacitor-inappbrowser/ et le package est gratuit à installer depuis npm. Les signalements de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code qui utilise In App Browser sans revue de l’App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements d'In App Browser sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo