Compartir vía

Notas de la versión del SDK de WebView2

Estas notas de la versión proporcionan información sobre las nuevas características y correcciones de errores que se incluyen en el SDK de versión webView2 y el SDK de versión preliminar de WebView2.

1.0.3650.58

Fecha de lanzamiento: 8 de diciembre de 2025

Paquete NuGet para el SDK de WebView2 1.0.3650.58

Para obtener compatibilidad completa con la API, esta versión de versión del SDK de WebView2 requiere la versión 143.0.3650.58 o posterior de WebView2 Runtime.

Promociones a la fase 3 (estable en versión)

No se ha promocionado ninguna API adicional de Fase 2: Estable en versión preliminar, a Fase 3: Estable en versión, en este SDK de versión.

Correcciones

Solo en tiempo de ejecución
  • Se ha corregido el acceso a la red local que desencadenaba una ventana emergente de alerta de permiso.

Versión preliminar 1.0.3712

Fecha de lanzamiento: 8 de diciembre de 2025

Paquete NuGet para el SDK de WebView2 1.0.3712-prerelease

Para obtener compatibilidad completa con la API, esta versión preliminar del SDK de WebView2 requiere el entorno de ejecución de WebView2 que se incluye con la versión 144.0.3712.0 o posterior de Microsoft Edge.

Promociones a la fase 1 (experimental en versión preliminar)

Las siguientes API están en fase 1: Experimental en versión preliminar y se han agregado en este SDK de versión preliminar.

Personalización del comportamiento del intervalo de puertos

Las API de intervalo de puertos permitidos permiten restringir o personalizar los intervalos de puertos de red que WebView2 puede usar para varios protocolos de transporte y ámbitos. Esto proporciona un control de seguridad mejorado.

  • Use SetAllowedPortRange en la CoreWebView2EnvironmentOptions instancia (o ICoreWebView2ExperimentalEnvironmentOptions) para configurar las restricciones de puerto durante la creación del entorno.

    • Use el scope parámetro para especificar si la configuración se aplica a todos los componentes (Default) o solo a las conexiones punto a punto de WebRTC (WebRtc). Actualmente solo WebRtc se admite.

    • Use el protocol parámetro para especificar el protocolo de transporte (actualmente admite Udp).

    • Especifique minPort y maxPort valores entre 1025-65535 (ambos inclusive) o use (0,0) para restablecer o quitar restricciones.

  • Use GetEffectiveAllowedPortRange en la CoreWebView2EnvironmentOptions instancia (o ICoreWebView2ExperimentalEnvironmentOptions) para recuperar la configuración del intervalo de puertos activo para un ámbito y protocolo específicos.

    • Devuelve el intervalo establecido explícitamente para el ámbito especificado o hereda del Default ámbito si no se establece.

    • Devuelve (0,0) si no hay restricciones configuradas para el ámbito especificado.

Promociones a la fase 2 (estable en versión preliminar)

Las siguientes API se han promocionado de Fase 1: Experimental en versión preliminar, a Fase 2: Estable en versión preliminar, y se incluyen en este SDK de versión preliminar.

Personalizar el comportamiento de arrastrar y colocar (DragStarting API)

La DragStarting API invalida el comportamiento predeterminado de arrastrar y colocar cuando se ejecuta en modo de hospedaje visual. El DragStarting evento notifica a la aplicación cuando el usuario inicia una operación de arrastre en WebView2 y proporciona el estado necesario para invalidar la operación de arrastrar WebView2 predeterminada con su propia lógica.

  • Use DragStarting en ICoreWebView2CompositionController5 para agregar un controlador de eventos que se invoca cuando se inicia la operación de arrastre.
  • Use ICoreWebView2DragStartingEventArgs para iniciar su propia operación de arrastre.
    • Use el GetDeferral método para ejecutar cualquier lógica de arrastre asincrónica y volver a llamar a WebView más adelante.
    • Use la Handled propiedad para que WebView2 sepa si desea usar su propia lógica de arrastre.

Correcciones

Este SDK de versión preliminar incluye las siguientes correcciones de errores.

Solo en tiempo de ejecución
  • Se ha corregido el acceso a la red local que desencadenaba una ventana emergente de alerta de permiso.
  • Se ha corregido una regresión de la setColorScheme API.
  • Se ha corregido la inicialización diferida para ICoreWebView2NewWindowRequestedEventArgs el modificador enable-new-window-requested-deferred-initializationde línea de comandos .

1.0.3595.46

Fecha de lanzamiento: 3 de noviembre de 2025

Paquete NuGet para el SDK de WebView2 1.0.3595.46

Para obtener compatibilidad completa con la API, esta versión de versión del SDK de WebView2 requiere la versión 142.0.3595.46 o posterior de WebView2 Runtime.

Promociones a la fase 3 (estable en versión)

No se ha promocionado ninguna API adicional de Fase 2: Estable en versión preliminar, a Fase 3: Estable en versión, en este SDK de versión.

Correcciones

Este SDK de versión incluye las siguientes correcciones de errores.

Solo en tiempo de ejecución
  • Se ha deshabilitado la creación de un proceso de "Representador especulativo".

1.0.3650-prelease

Fecha de lanzamiento: 7 de noviembre de 2025

Paquete NuGet para el SDK de WebView2 1.0.3650-prerelease

Para obtener compatibilidad completa con la API, esta versión preliminar del SDK de WebView2 requiere el entorno de ejecución de WebView2 que se incluye con la versión 143.0.3650.0 o posterior de Microsoft Edge.

Promociones a la fase 1 (experimental en versión preliminar)

No se han agregado API experimentales en este SDK de versión preliminar.

Promociones a la fase 2 (estable en versión preliminar)

No se ha promocionado ninguna API de Fase 1: Experimental en versión preliminar, a Fase 2: Estable en versión preliminar, en este SDK de versión preliminar.

Correcciones

Este SDK de versión preliminar incluye las siguientes correcciones de errores.

Solo en tiempo de ejecución
  • Se ha deshabilitado la creación de un proceso de "Representador especulativo".
  • Se ha corregido un problema de sincronización de cuadros de diálogo de búsqueda al realizar una búsqueda mediante programación.

1.0.3537.50

Fecha de lanzamiento: 6 de octubre de 2025

Paquete NuGet para el SDK de WebView2 1.0.3537.50

Para obtener compatibilidad completa con la API, esta versión de versión del SDK de WebView2 requiere la versión 141.0.3537.50 o posterior de WebView2 Runtime.

Promociones a la fase 3 (estable en versión)

No se ha promocionado ninguna API adicional de Fase 2: Estable en versión preliminar, a Fase 3: Estable en versión, en este SDK de versión.

Correcciones

Este SDK de versión incluye las siguientes correcciones de errores.

Solo en tiempo de ejecución
  • Se ha corregido el acceso a la red local que desencadenaba una ventana emergente de alerta de permiso.
Solo SDK
  • Se ha corregido un error de BinSkim para WebView2Loader.dll.

Versión preliminar 1.0.3590

Fecha de lanzamiento: 7 de octubre de 2025

Paquete NuGet para el SDK de WebView2 1.0.3590-prerelease

Para obtener compatibilidad completa con la API, esta versión preliminar del SDK de WebView2 requiere el entorno de ejecución de WebView2 que se incluye con la versión 142.0.3590.0 o posterior de Microsoft Edge.

Promociones a la fase 1 (experimental en versión preliminar)

Las siguientes API están en fase 1: Experimental en versión preliminar y se han agregado en este SDK de versión preliminar.

Compatibilidad con etiquetas de confidencialidad

Una nueva API de información de confidencialidad en WebView2 permite a las aplicaciones acceder a la información de etiquetas de confidencialidad que comunican las páginas web a través del Administrador de restricciones de interacción de página. Esta característica ayuda a las aplicaciones host a detectar y responder a contenido confidencial.

Funcionalidades clave:

  • Configurar la disponibilidad del Administrador de restricciones de interacción de página: configure una lista de filtros de direcciones URL para el Administrador de restricciones de interacción de página. Una vez configurada la lista, el Administrador de restricciones de interacción de página estará disponible en las páginas de la lista de permitidos. Estas páginas pueden enviar etiquetas de confidencialidad a la plataforma a través de la API.

  • Exposición de información - CoreWebView2 de confidencialidad ahora expone una SensitivityInfo propiedad y un SensitivityInfoChanged evento, lo que permite a las aplicaciones escuchar las actualizaciones de la información de la etiqueta de confidencialidad.

La compatibilidad con etiquetas de confidencialidad está disponible inicialmente solo en Win32. La compatibilidad con .NET y WinRT está prevista para una versión futura.

Promociones a la fase 2 (estable en versión preliminar)

No se ha promocionado ninguna API de Fase 1: Experimental en versión preliminar, a Fase 2: Estable en versión preliminar, en este SDK de versión preliminar.

Correcciones

Este SDK de versión preliminar incluye las siguientes correcciones de errores.

Solo en tiempo de ejecución
  • Se ha corregido un puntero colgante en el contexto de permisos de acceso del sistema de archivos.
  • Se ha corregido la suspensión de la interfaz de usuario durante la arrastrar y colocar en WinUI3.
  • Se ha corregido el acceso a la red local que desencadenaba una ventana emergente de alerta de permiso.
  • Se ha resuelto un problema por el que una región adicional aparecía en el árbol de accesibilidad.
  • Se ha corregido un problema por el que las descargas en el marco predeterminado del explorador no funcionaba.
Solo SDK
  • Se ha corregido un error de BinSkim para WebView2Loader.dll.

1.0.3485.44

Fecha de lanzamiento: 8 de septiembre de 2025

Paquete NuGet para el SDK de WebView2 1.0.3485.44

Para obtener compatibilidad completa con la API, esta versión de versión del SDK de WebView2 requiere la versión 140.0.3485.44 o posterior de WebView2 Runtime.

Cambios generales

Este SDK de versión se centra en mejorar el funcionamiento de WebView2 mediante mejoras en segundo plano.

  • Se ha reforzado la infraestructura de pruebas.
  • Se ha mejorado la validación de las API para garantizar que las API se realicen de forma confiable en distintos escenarios.

Estas mejoras fundamentales proporcionan una funcionalidad estable y exhaustivamente probada para compilar aplicaciones WebView2.

Promociones a la fase 3 (estable en versión)

No se ha promocionado ninguna API adicional de Fase 2: Estable en versión preliminar, a Fase 3: Estable en versión, en este SDK de versión.

Correcciones

No hay correcciones de errores en este SDK de versión.

1.0.3530-prelease

Fecha de lanzamiento: 8 de septiembre de 2025

Paquete NuGet para el SDK de WebView2 1.0.3530-prerelease

Para obtener compatibilidad completa con la API, esta versión preliminar del SDK de WebView2 requiere el entorno de ejecución de WebView2 que se incluye con la versión 141.0.3530.0 o posterior de Microsoft Edge.

Cambios generales

Este SDK de versión preliminar se centra en mejorar el funcionamiento de WebView2 mediante mejoras en segundo plano.

  • Se ha reforzado la infraestructura de pruebas.
  • Se ha mejorado la validación de las API para garantizar que las API se realicen de forma confiable en distintos escenarios.

Estas mejoras fundamentales proporcionan una funcionalidad estable y exhaustivamente probada para compilar aplicaciones WebView2.

Promociones a la fase 1 (experimental en versión preliminar)

No se han agregado API experimentales en este SDK de versión preliminar.

Promociones a la fase 2 (estable en versión preliminar)

No se ha promocionado ninguna API de Fase 1: Experimental en versión preliminar, a Fase 2: Estable en versión preliminar, en este SDK de versión preliminar.

Correcciones

Este SDK de versión preliminar incluye las siguientes correcciones de errores.

Solo SDK
  • Se ha corregido una pérdida de memoria en el controlador de composición de WPF.

1.0.3405.78

Fecha de lanzamiento: 11 de agosto de 2025

Paquete NuGet para el SDK de WebView2 1.0.3405.78

Para obtener compatibilidad completa con la API, esta versión de versión del SDK de WebView2 requiere la versión 139.0.3405.78 o posterior de WebView2 Runtime.

Promociones a la fase 3 (estable en versión)

Las siguientes API se han promocionado de Fase 2: Estable en versión preliminar, a Fase 3: Estable en versión y ahora se incluyen en este SDK de versión.

Personalización del comportamiento de búsqueda (Buscar API)

Find API permite controlar mediante programación las operaciones Find y permite agregar la siguiente funcionalidad a la aplicación:

  • Personalice las opciones buscar, como Buscar término, Distinción de mayúsculas y minúsculas, coincidencia de Word, resaltado de coincidencias y supresión predeterminada de la interfaz de usuario.
  • Busque cadenas de texto y navegue entre ellas dentro de un control WebView2.
  • Inicie operaciones find mediante programación y navegue por Buscar resultados.
  • Suprima la interfaz de usuario de búsqueda predeterminada.
  • Realice un seguimiento del estado de las operaciones de búsqueda .

Hay problemas conocidos con los documentos de Find API for PDF. Al ver un documento PDF dentro de un control WebView2, la característica Buscar actualmente solo proporciona el primer índice y el número de coincidencias encontradas. Por ejemplo, si la cadena se produce tres veces en un PDF, la interfaz de usuario diría 1/3 y no admitiría la llamada mediante programación a Next o Previous.

Estamos investigando activamente estos problemas y le recomendamos que informe de los problemas que encuentre mediante el repositorio WebView2Feedback .

Correcciones

Solo en tiempo de ejecución
  • Se ha corregido un bloqueo en Devtools en Windows Server y Windows 10.

Versión preliminar 1.0.3477

Fecha de lanzamiento: 11 de agosto de 2025

Paquete NuGet para el SDK de WebView2 1.0.3477-prerelease

Para obtener compatibilidad completa con la API, esta versión preliminar del SDK de WebView2 requiere el entorno de ejecución de WebView2 que se incluye con la versión 140.0.3477.0 o posterior de Microsoft Edge.

Promociones a la fase 1 (experimental en versión preliminar)

No se han agregado API experimentales en este SDK de versión preliminar.

Promociones a la fase 2 (estable en versión preliminar)

No se ha promocionado ninguna API de Fase 1: Experimental en versión preliminar, a Fase 2: Estable en versión preliminar, en este SDK de versión preliminar.

Correcciones

Solo en tiempo de ejecución
  • Se ha corregido put_UserAgent que no funcionaba para los trabajadores de servicio.
  • Se ha corregido un bloqueo en Devtools en Windows Server y Windows 10.
  • Se quitó el seguimiento de procesos del explorador después de llamar a remove_BrowserProcessExited.
  • Se ha corregido un problema de pérdida de memoria en hostObject las llamadas a funciones asincrónicas.
  • Se ha corregido que el toque no funcionaba en el hospedaje visual después de un toque largo.

1.0.3351.48

Fecha de lanzamiento: 1 de julio de 2025

Paquete NuGet para el SDK de WebView2 1.0.3351.48

Para obtener compatibilidad completa con la API, esta versión de versión del SDK de WebView2 requiere la versión 138.0.3351.48 o posterior de WebView2 Runtime.

Promociones a la fase 3 (estable en versión)

Las siguientes API se han promocionado de Fase 2: Estable en versión preliminar, a Fase 3: Estable en versión y ahora se incluyen en este SDK de versión.

Permitir que los mensajes de evento de entrada pasen a través de la ventana del explorador

La CoreWebView2ControllerOptions clase ahora tiene una AllowHostInputProcessing propiedad, que permite que los mensajes de evento de entrada del usuario (teclado, mouse, toque o lápiz) pasen a través de la ventana del explorador, para que los reciba una ventana de proceso de aplicación.

Correcciones

Solo en tiempo de ejecución
  • Se ha corregido un problema de caja negra en los cuadros de diálogo en el hospedaje visual.

Versión preliminar 1.0.3415

Fecha de lanzamiento: 14 de julio de 2025

Paquete NuGet para el SDK de WebView2 1.0.3415-prerelease

Para obtener compatibilidad completa con la API, esta versión preliminar del SDK de WebView2 requiere el entorno de ejecución de WebView2 que se incluye con la versión 140.0.3415.0 o posterior de Microsoft Edge.

Promociones a la fase 1 (experimental en versión preliminar)

Las siguientes API están en fase 1: Experimental en versión preliminar y se han agregado en este SDK de versión preliminar.

Habilitar el procesamiento en segundo plano y la compatibilidad sin conexión (API de trabajo de WebView2)

Las API de trabajo de WebView2 permiten que las aplicaciones host interactúen con trabajos web para descargar tareas desde el subproceso principal, mejorar la capacidad de respuesta y admitir operaciones en segundo plano. Estos trabajadores web incluyen trabajadores dedicados, trabajadores compartidos y trabajadores de servicio.

Estas API proporcionan:

  • Eventos del ciclo de vida: Supervisar la creación y destrucción de trabajadores.
  • Interfaces de mensajería: Comunicarse con los trabajadores mediante PostMessage y WebMessageReceived.
  • Administración de trabajadores: Consulta y recuperación de registros e instancias de trabajo.
Representar barras de título personalizadas (API de superposición de controles de ventana)

La API de superposición de controles de ventana permite a los desarrolladores crear barras de título personalizadas mediante la representación de botones subtítulo (minimizar, maximizar, restaurar y cerrar) directamente dentro de la ventana WebView2. La superposición de controles de ventana aparece en la esquina superior de WebView y se integra perfectamente con la interfaz de usuario de la aplicación.

Use esta API cuando:

  • Quiere reemplazar la barra de título del sistema operativo predeterminada por una barra de título totalmente personalizada desde la aplicación.
  • Está trabajando con características de región que no son de cliente, como app-region: drag y IsNonClientRegionSupportEnabled.

Esta API es ideal para aplicaciones que requieren una experiencia de interfaz de usuario inmersiva y moderna.

Promociones a la fase 2 (estable en versión preliminar)

Las siguientes API se han promocionado de Fase 1: Experimental en versión preliminar, a Fase 2: Estable en versión preliminar, y se incluyen en este SDK de versión preliminar.

Personalización del comportamiento de búsqueda (Buscar API)

Find API permite controlar mediante programación las operaciones Find y permite agregar la siguiente funcionalidad a la aplicación:

  • Personalice las opciones buscar, como Buscar término, Distinción de mayúsculas y minúsculas, coincidencia de Word, resaltado de coincidencias y supresión predeterminada de la interfaz de usuario.
  • Busque cadenas de texto y navegue entre ellas dentro de un control WebView2.
  • Inicie operaciones find mediante programación y navegue por Buscar resultados.
  • Suprima la interfaz de usuario de búsqueda predeterminada.
  • Realice un seguimiento del estado de las operaciones de búsqueda .

Hay problemas conocidos con los documentos de Find API for PDF. Al ver un documento PDF dentro de un control WebView2, la característica Buscar actualmente solo proporciona el primer índice y el número de coincidencias encontradas. Por ejemplo, si la cadena se produce tres veces en un PDF, la interfaz de usuario diría 1/3 y no admitiría la llamada mediante programación a Next o Previous.

Estamos investigando activamente estos problemas y le recomendamos que informe de los problemas que encuentre mediante el repositorio WebView2Feedback .

Correcciones

Solo en tiempo de ejecución
  • Se ha corregido un problema de caja negra en los cuadros de diálogo en el hospedaje visual.
  • Se ha corregido put_UserAgent que no funcionaba para los trabajadores de servicio.
  • Se ha corregido el bloqueo en DevTools en Windows Server y Windows 10.

Consulte también

Referencia de API:

  • Last updated on