Compartir a través de

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.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

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.

API experimentales

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

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.

1.0.3296.44

Fecha de lanzamiento: 03 de junio de 2025

Paquete NuGet para el SDK de WebView2 1.0.3296.44

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

Promociones

Las siguientes API se han promocionado a Estable y ahora se incluyen en este SDK de versión.

Establecer el color de fondo predeterminado en la inicialización de WebView2 (DefaultBackgroundColor API)

La API DefaultBackgroundColor permite a los usuarios establecer la propiedad en la DefaultBackgroundColor inicialización. Esto evita una interrupción del flash blanco durante el proceso de carga de WebView2.

Correcciones

Solo en tiempo de ejecución
  • Se han corregido los márgenes del PDF impreso.

Versión preliminar 1.0.3344

Fecha de lanzamiento: 03 de junio de 2025

Paquete NuGet para el SDK de WebView2 1.0.3344-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 138.0.3344.0 o posterior de Microsoft Edge.

API experimentales

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

Promociones

Las siguientes API se han promocionado de Experimental a Estable en este SDK de versión preliminar.

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 error que provocaba que un evento del mouse no se desencadenara después de un evento táctil.
  • Captura web deshabilitada en el control WebView2.
  • Se ha corregido el cuadro de diálogo Descargas .
  • Se ha corregido un problema con las descargas en el marco del explorador predeterminado. (Problema 5196)
  • Se han corregido los márgenes del PDF impreso.

1.0.3240.44

Fecha de lanzamiento: 05 de mayo de 2025

Paquete NuGet para el SDK de WebView2 1.0.3240.44

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

Promociones

Las siguientes API se han promocionado a Estable y ahora se incluyen en este SDK de versión.

Seguimiento del historial de navegación de iframes anidados (API FrameCreatedEvent)

La API FrameCreatedEvent admite iframes anidados, como registrar el historial de navegación de un iframe de segundo nivel. Sin esta API, WebView2 solo realiza un seguimiento de los iframes de primer nivel, que son los iframes secundarios directos del marco principal. Con esta API, la aplicación puede suscribirse al evento de creación de iframe anidado, lo que proporciona a la aplicación acceso a todas las propiedades, métodos y eventos de CoreWebView2Frame para el iframe anidado.

Use esta API para administrar el seguimiento de iframe en una página que contiene varios niveles de iframes. Puede optar por realizar un seguimiento de cualquiera de los siguientes elementos:

  • Solo la página principal y los iframes de primer nivel (el comportamiento predeterminado).
  • Árbol de marcos WebView2 parcial con iframes específicos de interés.
  • Árbol de marcos WebView2 completo.

Correcciones

Solo en tiempo de ejecución
  • Se ha corregido un problema por el que las descargas desde dentro del marco predeterminado del explorador no se completaba. (Problema 5196)
  • Se ha corregido un problema por el que el nombre de la canalización se devolvía incorrectamente, lo que provocaba un bloqueo en algunas aplicaciones para UWP.

Versión preliminar 1.0.3296

Fecha de lanzamiento: 12 de mayo de 2025

Paquete NuGet para el SDK de WebView2 1.0.3296-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 137.0.3296.0 o posterior de Microsoft Edge.

API experimentales

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

Promociones

Las siguientes API se han promocionado de Experimental a Estable en este SDK de versión preliminar.

Establecer el color de fondo predeterminado en la inicialización de WebView2 (DefaultBackgroundColor API)

La API DefaultBackgroundColor permite a los usuarios establecer la propiedad en la DefaultBackgroundColor inicialización. Esto evita una interrupción del flash blanco durante el proceso de carga de WebView2.

Correcciones

Solo en tiempo de ejecución
  • Se ha corregido que la barra Buscar ya no aparecía después de cambiar la ventana.
  • Se ha corregido un error por el que la aplicación no podía cancelar la navegación a las páginas de inicio de sesión a través del NavigationStarting evento.
  • Se ha corregido un problema por el que las descargas desde dentro del marco predeterminado del explorador no se completaba. (Problema 5196)
  • Se ha corregido un problema por el que el nombre de la canalización se devolvía incorrectamente, lo que provocaba un bloqueo en algunas aplicaciones para UWP.

1.0.3179.45

Fecha de lanzamiento: 07 de abril de 2025

Paquete NuGet para el SDK de WebView2 1.0.3179.45

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

Promociones

No se ha promocionado ninguna API adicional a Estable y se ha agregado en este SDK de versión.

Correcciones

Solo en tiempo de ejecución
  • Se ha corregido el elemento SELECT HTML (<seleccionar>) para que se pueda seleccionar en aplicaciones WPF.
  • Se ha corregido la navegación de dentro de edge://crashes un control WebView2.
  • Se han corregido posibles problemas de bloqueo e interfaz de usuario al invocar la interfaz de usuario de credenciales de Windows desde una instancia de WebView2.
  • Se ha corregido un error por el que los usuarios no podían escribir un campo de entrada con información de autorrellenar. (Problema 5144)

Versión preliminar 1.0.3230

Fecha de lanzamiento: 07 de abril de 2025

Paquete NuGet para el SDK de WebView2 1.0.3230-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 136.0.3230.0 o posterior de Microsoft Edge.

API experimentales

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

Promociones

Las siguientes API se han promocionado de Experimental a Estable en este SDK de versión preliminar.

Seguimiento del historial de navegación de iframes anidados (API FrameCreatedEvent)

La API FrameCreatedEvent admite iframes anidados, como registrar el historial de navegación de un iframe de segundo nivel. Sin esta API, WebView2 solo realiza un seguimiento de los iframes de primer nivel, que son los iframes secundarios directos del marco principal. Con esta API, la aplicación puede suscribirse al evento de creación de iframe anidado, lo que proporciona a la aplicación acceso a todas las propiedades, métodos y eventos de CoreWebView2Frame para el iframe anidado.

Use esta API para administrar el seguimiento de iframe en una página que contiene varios niveles de iframes. Puede optar por realizar un seguimiento de cualquiera de los siguientes elementos:

  • Solo la página principal y los iframes de primer nivel (el comportamiento predeterminado).
  • Árbol de marcos WebView2 parcial con iframes específicos de interés.
  • Árbol de marcos WebView2 completo.

Correcciones

Solo en tiempo de ejecución
  • Se ha corregido un problema en WPF que provocaba que la <lista desplegable de listas> de datos se cerrara cuando el mouse se movía fuera de los límites del control WebView2.
  • Se ha corregido la navegación de dentro de edge://crashes un control WebView2.
  • Se ha corregido el elemento SELECT HTML (<seleccionar>) para que se pueda seleccionar en aplicaciones WPF.
  • Se han corregido posibles problemas de bloqueo e interfaz de usuario al invocar la interfaz de usuario de credenciales de Windows desde una instancia de WebView2.
  • Se ha corregido un error por el que los usuarios no podían escribir en el campo de entrada con información de autorrellenar. (Problema 5144)
  • Se ha corregido una regresión en las API de la barra de estado .
Solo SDK
  • Se han corregido las teclas Tab, Mayús+Tab y Arrow en el modo de hospedaje Ventana a objeto visual.

1.0.3124.44

Fecha de lanzamiento: 10 de marzo de 2025

Paquete NuGet para el SDK de WebView2 1.0.3124.44

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

Promociones

No se ha promocionado ninguna API adicional a Estable y se ha agregado en este SDK de versión.

Correcciones

Solo en tiempo de ejecución
  • Las extensiones no se deshabilitarán en WebView2 mediante AddBrowserExtensionAsync, independientemente de si el modo de desarrollador está activado. (Problema 5113)
  • Actualización en segundo plano deshabilitada de la hora de red. (Problema 5047)
  • Se ha corregido el elemento emergente de descarga que no se mostraba cuando target="_blank". (Problema 5063)

1.0.3171-versión preliminar

Fecha de lanzamiento: 10 de marzo de 2025

Paquete NuGet para el SDK de WebView2 1.0.3171-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 135.0.3171.0 o posterior de Microsoft Edge.

API experimentales

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

Promociones

No se ha promocionado ninguna API de Experimental a Estable en este SDK de versión preliminar.

Correcciones

Runtime y SDK
  • Se ha corregido el control de excepciones del método asincrónico de objetos host. (Problema n.º 3402)
  • Se ha corregido la documentación de CoreWebVIew2.Navigate. (Problema 5091)
Solo en tiempo de ejecución
  • Se ha corregido una regresión de instalación del almacén "Agregar a Chrome".
  • Se han corregido las cargas de carpetas en UWP y WinUI. (Problema n.º 3275)
  • Las extensiones no se deshabilitarán en WebView2 mediante AddBrowserExtensionAsync, independientemente de si el modo de desarrollador está activado. (Problema 5113)
  • Actualización en segundo plano deshabilitada de la hora de red. (Problema 5047)
  • Se ha corregido el elemento emergente de descarga que no se mostraba cuando target="_blank". (Problema 5063)
Solo SDK
  • Corrige un bloqueo que podría producirse cuando el recolector de elementos no utilizados llama a Finalize en un subproceso distinto del subproceso principal.

Consulte también

Referencia de API: