# apache/cordova-plugin-inappbrowser architecture

> Architecture diagram of the GitHub repository apache/cordova-plugin-inappbrowser, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/apache/cordova-plugin-inappbrowser
- Repository: https://github.com/apache/cordova-plugin-inappbrowser

## Overview

Cordova InAppBrowser opens web content in an app-managed browser view, with options, controls, events, and content-injection APIs. The principal workflow is an app calling `cordova.InAppBrowser.open()`, which uses Cordova’s exec bridge to reach a platform implementation that loads and presents the requested page; `_system` instead opens the system browser. The graph includes Android, iOS, and browser implementations and the documented event/injection capabilities. Some iOS implementation details and bridge wiring are unsampled, so those links are marked unverified.

Main entry points: [`src/ios/CDVWKInAppBrowser.m`](https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/ios/CDVWKInAppBrowser.m) (iOS browser plugin), [`www/inappbrowser.js`](https://github.com/apache/cordova-plugin-inappbrowser/blob/master/www/inappbrowser.js) (InAppBrowser API), [`src/android/InAppBrowser.java`](https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/android/InAppBrowser.java) (Android browser plugin), [`src/browser/InAppBrowserProxy.js`](https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/browser/InAppBrowserProxy.js) (Browser proxy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Plugin API"]
  node_iab_api["InAppBrowser API<br/>[inappbrowser.js]"]
  node_exec["Cordova exec"]
  node_events["Browser events<br/>[inappbrowser.js]"]
  node_injection["Script and CSS injection<br/>[inappbrowser.js]"]
end

subgraph group_android["Android runtime"]
  node_android_plugin["Android browser plugin<br/>[InAppBrowser.java]"]
  node_android_dialog["Browser dialog"]
  node_android_chrome["Chrome client"]
end

subgraph group_ios["iOS runtime"]
  node_ios_plugin["iOS browser plugin"]
  node_ios_options["iOS options"]
  node_ios_ui["Web UI delegate"]
  node_ios_navigation["Navigation controller"]
end

subgraph group_browser["Browser runtime"]
  node_browser_proxy["Browser proxy"]
end

node_app(("Cordova app"))
node_iab_view["In-app browser view"]
node_system_browser["System browser"]

node_app -->|"opens URL"| node_iab_api
node_iab_api -->|"invokes actions"| node_exec
node_exec -.->|"dispatches"| node_android_plugin
node_exec -.->|"dispatches"| node_ios_plugin
node_exec -.->|"dispatches"| node_browser_proxy
node_android_plugin -->|"uses dialog"| node_android_dialog
node_android_plugin -->|"uses client"| node_android_chrome
node_android_plugin -.->|"presents browser"| node_iab_view
node_ios_plugin -.->|"parses options"| node_ios_options
node_ios_plugin -.->|"uses delegate"| node_ios_ui
node_ios_plugin -.->|"uses controller"| node_ios_navigation
node_ios_plugin -.->|"presents browser"| node_iab_view
node_browser_proxy -->|"renders iframe"| node_iab_view
node_iab_api -->|"handles events"| node_events
node_iab_api -->|"requests injection"| node_injection
node_app -->|"opens with _system"| node_system_browser

click node_iab_api "https://github.com/apache/cordova-plugin-inappbrowser/blob/master/www/inappbrowser.js"
click node_android_plugin "https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/android/InAppBrowser.java"
click node_android_dialog "https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/android/InAppBrowserDialog.java"
click node_android_chrome "https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/android/InAppChromeClient.java"
click node_ios_plugin "https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/ios/CDVWKInAppBrowser.m"
click node_ios_options "https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/ios/CDVInAppBrowserOptions.m"
click node_ios_ui "https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/ios/CDVWKInAppBrowserUIDelegate.m"
click node_ios_navigation "https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/ios/CDVInAppBrowserNavigationController.m"
click node_browser_proxy "https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/browser/InAppBrowserProxy.js"
click node_events "https://github.com/apache/cordova-plugin-inappbrowser/blob/master/www/inappbrowser.js"
click node_injection "https://github.com/apache/cordova-plugin-inappbrowser/blob/master/www/inappbrowser.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_iab_api,node_exec,node_events,node_injection,node_iab_view,node_system_browser toneBlue
class node_android_plugin,node_android_dialog,node_android_chrome toneAmber
class node_ios_plugin,node_ios_options,node_ios_ui,node_ios_navigation toneMint
class node_browser_proxy toneRose
class node_app toneIndigo
```

## Components

### Plugin API

- [InAppBrowser API](https://github.com/apache/cordova-plugin-inappbrowser/blob/master/www/inappbrowser.js): `www/inappbrowser.js`
- **Cordova exec**
- [Browser events](https://github.com/apache/cordova-plugin-inappbrowser/blob/master/www/inappbrowser.js): `www/inappbrowser.js`
- [Script and CSS injection](https://github.com/apache/cordova-plugin-inappbrowser/blob/master/www/inappbrowser.js): `www/inappbrowser.js`

### Android runtime

- [Android browser plugin](https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/android/InAppBrowser.java): `src/android/InAppBrowser.java`
- [Browser dialog](https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/android/InAppBrowserDialog.java): `src/android/InAppBrowserDialog.java`
- [Chrome client](https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/android/InAppChromeClient.java): `src/android/InAppChromeClient.java`

### iOS runtime

- [iOS browser plugin](https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/ios/CDVWKInAppBrowser.m): `src/ios/CDVWKInAppBrowser.m`
- [iOS options](https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/ios/CDVInAppBrowserOptions.m): `src/ios/CDVInAppBrowserOptions.m`
- [Web UI delegate](https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/ios/CDVWKInAppBrowserUIDelegate.m): `src/ios/CDVWKInAppBrowserUIDelegate.m`
- [Navigation controller](https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/ios/CDVInAppBrowserNavigationController.m): `src/ios/CDVInAppBrowserNavigationController.m`

### Browser runtime

- [Browser proxy](https://github.com/apache/cordova-plugin-inappbrowser/blob/master/src/browser/InAppBrowserProxy.js): `src/browser/InAppBrowserProxy.js`

### Other components

- **Cordova app**
- **In-app browser view**
- **System browser**

## Connections

- Cordova app → InAppBrowser API: opens URL (evidence: `README.md`)
- InAppBrowser API → Cordova exec: invokes actions (evidence: `www/inappbrowser.js`)
- Cordova exec → Android browser plugin: dispatches
- Cordova exec → iOS browser plugin: dispatches
- Cordova exec → Browser proxy: dispatches
- Android browser plugin → Browser dialog: uses dialog (evidence: `src/android/InAppBrowser.java`)
- Android browser plugin → Chrome client: uses client (evidence: `src/android/InAppBrowser.java`)
- Android browser plugin → In-app browser view: presents browser
- iOS browser plugin → iOS options: parses options
- iOS browser plugin → Web UI delegate: uses delegate
- iOS browser plugin → Navigation controller: uses controller
- iOS browser plugin → In-app browser view: presents browser
- Browser proxy → In-app browser view: renders iframe (evidence: `src/browser/InAppBrowserProxy.js`)
- InAppBrowser API → Browser events: handles events (evidence: `www/inappbrowser.js`)
- InAppBrowser API → Script and CSS injection: requests injection (evidence: `www/inappbrowser.js`)
- Cordova app → System browser: opens with _system (evidence: `README.md`)
