@capgo/capacitor-navegador-en-app

Resumen

@capgo/capacitor-inappbrowser proporciona a las aplicaciones Capacitor dos rutas de navegador: open() para la experiencia del navegador del sistema y openWebView() para un navegador nativo gestionado que su aplicación puede dimensionar, ocultar, enviar mensajes, ejecutar scripts, configurar proxy y superponer con la interfaz de usuario de Ionic.

Utilícelo cuando la página necesita más que una simple ventana externa del navegador: flujos de OAuth y de pago, portales de soporte integrados, pantallas de pago, llamadas de video, portales de documentos, aplicaciones web interactivas o cualquier flujo en el que su aplicación necesita controles nativos alrededor de contenido web en vivo.

El nombre del paquete ha cambiado.

Uso Común

• Presente la interfaz de usuario de Ionic o Capacitor por encima de una página de navegador en vivo con toBack, sendToBack(), bringToFront(), transparentBackgroundy dispatchInputEvent().
• Construye navegadores de pantalla parcial, hojas de información en la parte inferior y vistas de web en miniatura con width, height, x, yy updateDimensions().
• Permita a los usuarios tocar la aplicación Capacitor fuera de una ventana del navegador personalizada de tamaño en Android e iOS.
• Ejecuta flujos de pago, inicio de sesión, soporte o cambio de cuenta sin almacenamiento de sitio web persistente utilizando persistWebViewData: false y clearAllBrowsingData().
• Mantenga varias instancias de navegador cargadas con hidden, hide(), y show() mientras se preserva el estado de la página.
• Integra aplicaciones web avanzadas que necesitan proxy de solicitud, subida de archivos, descarga de archivos, control de pestañas, soporte de Google Pay, _blank gestión de enlaces, y mensajería de aplicación a página.

Capacidades básicas

• open - Abre una URL en Chrome Custom Tabs en Android o iOS SFSafariViewController On iOS.
• openWebView - Abre una vista web nativa gestionada con herramienta de herramienta personalizada, tamaño, navegación nativa, mensajería, scripting, proxy, descargas, ventanas emergentes y controles de datos.
• sendToBack / bringToFront - Mueve un navegador gestionado detrás o encima de la Capacitor vista web nativa.
• dispatchInputEvent - Envía eventos de clic, toque y desplazamiento a un navegador que se encuentra detrás de la interfaz de usuario de la aplicación nativa.
• updateDimensions - Cambia el tamaño y la posición de la vista web gestionada sin recargar la página.
• hide / show - Mantiene las vistas web gestionadas cargadas mientras se eliminan o restauran su presentación nativa.
• postMessage / executeScript - Conecta la aplicación Capacitor con JavaScript que se ejecuta dentro de la página gestionada.
• clearAllBrowsingData / persistWebViewData - Controla la persistencia de cookies, caché, almacenamiento, IndexedDB y sesión.
• handleDownloads- Soporte para reglas de proxy, eventos de ventanas emergentes y documentación de puertas - Soporte para flujos de carga, páginas de pago y aplicaciones web incorporadas.

Privado API

Método	Descripción
goBack	Navega hacia atrás en la historia del WebView si es posible.
open	Abre la URL en una ventana nueva en pantalla completa, en Android utiliza Chrome Custom Tabs, en iOS utiliza SFSafariViewController.
clearCookies	Elimina las cookies de la URL Cuando id se omite, se aplica a todos los webviews abiertos.
clearAllCookies	Elimina todas las cookies Cuando id se omite, se aplica a todos los webviews abiertos.
clearCache	Elimina la caché Cuando id se omite, se aplica a todos los webviews abiertos.
clearAllBrowsingData	Elimina las cookies, caché, almacenamiento local, almacenamiento de sesión, IndexedDB y otros datos de navegación del almacén predeterminado y de los WebViews administrados.
getCookies	Obtiene las cookies para una URL específica.
close	Cierra el webview. Cuando id is omitido, cierra el navegador web activo.
hide	Oculta el navegador web sin cerrarlo. Utiliza show() para volver a mostrarlo. Cuando id is omitido, apunta al navegador web activo.
show	Muestra un navegador web previamente oculto. Cuando id is omitido, apunta al navegador web activo.
sendToBack	Mueve el navegador nativo detrás del Capacitor host WebView para que la interfaz de usuario del app pueda aparecer encima de él.
bringToFront	Mueve un navegador que estaba detrás del host WebView de nuevo a la parte delantera.
dispatchInputEvent	Envía clic, toque o evento de desplazamiento a un navegador gestionado; las coordenadas son relativas a la vista previa del navegador.
openWebView	Abre la url en un nuevo navegador web con barras de herramientas y capacidades mejoradas, como acceso a la cámara, acceso a archivos, escucha eventos, inyecta javascript, comunicación bidireccional, etc.
executeScript	Inyecta JavaScript code en la ventana del navegador InAppBrowser. Cuando id is omitido, se ejecuta en todos los navegadores web abiertos.
postMessage	Envía un evento al navegador web (navegador en la aplicación). Escucha en la página con window.addEventListener('messageFromNative', listenerFunc)El payload debe ser serializable en formato JSON. Cuando detail Captura la vista actual del navegador web como una captura de pantalla PNG. Cuando id Establece la URL del navegador web. Cuando
takeScreenshot	Escucha el cambio de URL, solo para navegador web abierto. id Escucha
setUrl	; el payload contiene el navegador web id Escucha solo el clic de cierre para navegador web abierto.
addListener	Se disparará cuando el usuario haga clic en el botón de confirmación cuando se requiera un aviso, funciona con openWebView shareDisclaimer y closeModal.
addListener	__CAPGO_KEEP_0__ buttonNearDoneClick__CAPGO_KEEP_0__ id.
addListener	__CAPGO_KEEP_0__
addListener	__CAPGO_KEEP_0__
addListener	Se dispara cuando el webview envía un evento de vuelta a la aplicación. Utilice window.mobileApp.postMessage(...) en la página, y mantenga el payload serializable en formato JSON.
addListener	Se disparará cada vez que se capture una captura de pantalla desde el plugin API, el botón de captura de pantalla nativa o el puente de JavaScript inyectado.
addListener	Se disparará cuando se cargue la página.
addListener	Se disparará cuando se produzca un error de carga de página.
addListener	Se disparará después de que el manejo de descargas nativas guarde un archivo localmente. Active esto con handleDownloads: true al abrir el webview.
addListener	Se disparará cuando el manejo de descargas nativas falla. Active esto con handleDownloads: true al abrir el webview.
addListener	Se disparará cada vez que una página abra una ventana emergente/nueva. Utilice el id de ventana emergente devuelto con executeScript, postMessage, show, hide, y close.
addListener	Escuche las solicitudes delegadas por el runtime nativo. Prefiera addProxyHandler() en lugar de llamar esto directamente.
addListener	Escucha la salida de consola de JavaScript emitida por la página administrada. Habilita esto con captureConsoleLogs: true cuando se abre la vista web.
handleProxyRequest	Método interno utilizado por addProxyHandler() para enviar una decisión de proxy hacia nativo. Envía el original phase cuando se responde a una solicitud manual proxyRequest escuchador.
removeAllListeners	Elimina todos los escuchadores para este plugin.
reload	Recarga la página web actual.
updateDimensions	Actualiza las dimensiones de la vista web. Permite cambiar el tamaño y la posición de la vista web en tiempo de ejecución. Cuando id se omite, se dirige a la vista web activa.
setEnabledSafeTopMargin	Establece la margen superior segura habilitada de la vista web en tiempo de ejecución. Cuando id is omitido, apunta a la vista activa de la web. En la web, este método es una operación no realizada y resuelve sin cambiar la disposición.
setEnabledSafeBottomMargin	Establece la margen inferior segura habilitada del navegador web en tiempo de ejecución. Cuando id is omitido, apunta a la vista activa de la web. En la web, este método es una operación no realizada y resuelve sin cambiar la disposición.
openSecureWindow	Abre una ventana de OAuth2 segura. En la web, devuelve la URL redirigida a través de un BroadcastChannel; en móvil, registra una URI de redirección personalizada en la configuración de la aplicación. Consulte la guía de inicio rápido para obtener el ejemplo completo de HTML, Info.plist y AndroidManifest.

Fuente de Verdad

Esta referencia está sincronizada desde src/definitions.ts en capacitor-inappbrowser.

Sigue adelante desde @capgo/capacitor-inappbrowser

Si estás utilizando @capgo/capacitor-inappbrowser para planificar el trabajo de plugin nativo, conecta con Usando @capgo/capacitor-inappbrowser para la capacidad nativa en Usando @capgo/capacitor-inappbrowser, Directorio de Plugins Capgo para el flujo de trabajo del producto en Directorio de Plugins Capgo, Plugins de Capacitor por Capgo para el detalle de implementación en Plugins de Capacitor por Capgo, Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, y Alternativas de Plugins de Empresa de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Ionic Enterprise Plugin.