Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Ces notes de publication fournissent des informations sur les nouvelles fonctionnalités et les correctifs de bogues inclus dans le Kit de développement logiciel (SDK) WebView2 Release et le Kit de développement logiciel (SDK) de préversion WebView2.
1.0.3351.48
Date de publication : 1er juillet 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3351.48
Pour une compatibilité complète de l’API, cette version Release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 138.0.3351.48 ou ultérieure.
Promotions
Les API suivantes ont été promues de Phase 2 : Stable dans la préversion à Phase 3 : Stable dans la version, et sont désormais incluses dans ce Kit de développement logiciel (SDK) Release.
Autoriser le passage des messages d’événement d’entrée dans la fenêtre du navigateur
La CoreWebView2ControllerOptions
classe a maintenant une AllowHostInputProcessing
propriété, qui permet aux messages d’événement d’entrée utilisateur (clavier, souris, interaction tactile ou stylet) de passer par la fenêtre du navigateur, d’être reçus par une fenêtre de processus d’application.
-
CoreWebView2ControllerOptions
Classe:
Bogue
Runtime uniquement
- Correction d’un problème de boîte noire sur les boîtes de dialogue dans l’hébergement visuel.
1.0.3415-préversion
Date de publication : 14 juillet 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3415-prerelease
Pour une compatibilité complète avec l’API, cette version préliminaire du Kit de développement logiciel (SDK) WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 140.0.3415.0 ou ultérieure.
API expérimentales
Les API suivantes sont en phase 1 : Expérimentale en préversion, et ont été ajoutées dans ce KIT DE développement logiciel (SDK) de préversion.
Activer le traitement en arrière-plan et la prise en charge hors connexion (API Worker WebView2)
Les API Worker WebView2 permettent aux applications hôtes d’interagir avec les web Workers pour décharger les tâches du thread main, améliorer la réactivité et prendre en charge les opérations en arrière-plan. Ces web Workers incluent des workers dédiés, des workers partagés et des workers de service.
Ces API fournissent :
- Événements de cycle de vie : Surveiller la création et la destruction des workers.
-
Interfaces de messagerie : Communiquez avec les workers à l’aide de
PostMessage
etWebMessageReceived
. - Gestion des workers : Interroger et récupérer des instances et des inscriptions de worker.
-
CoreWebView2
Classe:
-
CoreWebView2DedicatedWorker, classe
- CoreWebView2DedicatedWorker.DedicatedWorkerCreated, événement
- Événement CoreWebView2DedicatedWorker.Destroying
- CoreWebView2DedicatedWorker.PostWebMessageAsJson, méthode
- CoreWebView2DedicatedWorker.PostWebMessageAsString, méthode
- CoreWebView2DedicatedWorker.ScriptUri, propriété
- CoreWebView2DedicatedWorker.WebMessageReceived, événement
-
CoreWebView2Frame
Classe:
-
CoreWebView2Profile
Classe:
-
CoreWebView2ServiceWorkerRegistration, classe
- CoreWebView2ServiceWorkerRegistration.ActiveServiceWorker, propriété
- CoreWebView2ServiceWorkerRegistration.Origin, propriété
- CoreWebView2ServiceWorkerRegistration.ScopeUri, propriété
- CoreWebView2ServiceWorkerRegistration.ServiceWorkerActivated Event
- CoreWebView2ServiceWorkerRegistration.TopLevelOrigin, propriété
- CoreWebView2ServiceWorkerRegistration.Unregistering Event
Afficher des barres de titre personnalisées (API de superposition des contrôles de fenêtre)
L’API De superposition des contrôles de fenêtre permet aux développeurs de créer des barres de titre personnalisées en affichant légende boutons (réduire, agrandir, restaurer, fermer) directement à l’intérieur de la fenêtre WebView2. La superposition des contrôles de fenêtre apparaît dans le coin supérieur de WebView et s’intègre en toute transparence à l’interface utilisateur de votre application.
Utilisez cette API dans les cas suivants :
- Vous souhaitez remplacer la barre de titre du système d’exploitation par défaut par une barre de titre dans l’application entièrement personnalisée.
- Vous utilisez des fonctionnalités de région non clientes, telles que
app-region: drag
etIsNonClientRegionSupportEnabled
.
Cette API est idéale pour les applications qui nécessitent une expérience d’interface utilisateur moderne et immersive.
Promotions
Les API suivantes ont été promues de phase 1 : Expérimentale en préversion à Phase 2 : Stable dans la préversion, et sont incluses dans ce KIT DE développement logiciel (SDK) de préversion.
Personnaliser le comportement de recherche (API De recherche)
L’API Find vous permet de contrôler par programmation les opérations Find et d’ajouter les fonctionnalités suivantes à votre application :
- Personnalisez les options Rechercher, notamment Rechercher un terme, Respect de la casse, Correspondance Word, Mise en surbrillance des correspondances et Suppression de l’interface utilisateur par défaut.
- Recherchez des chaînes de texte et naviguez entre elles dans un contrôle WebView2.
- Lancez par programmation des opérations De recherche et accédez à Rechercher les résultats.
- Supprimez l’interface utilisateur De recherche par défaut.
- Suivez la status des opérations De recherche.
Il existe des problèmes connus avec l’API Rechercher pour les documents PDF. Lorsque vous affichez un document PDF dans un contrôle WebView2, la fonctionnalité Rechercher fournit uniquement le premier index et le nombre de correspondances trouvées. Par exemple, si la chaîne se produit trois fois dans un fichier PDF, l’interface utilisateur indique 1/3 et ne prend pas en charge l’appel programmatique suivant ou précédent.
Nous étudions activement ces problèmes et vous encourageons à signaler les problèmes que vous rencontrez à l’aide du dépôt WebView2Feedback .
CoreWebView2
Classe:CoreWebView2Environment
Classe:-
- CoreWebView2Find.ActiveMatchIndex, propriété
- CoreWebView2Find.ActiveMatchIndexChanged, événement
- CoreWebView2Find.FindNext, méthode
- CoreWebView2Find.FindPrevious, méthode
- CoreWebView2Find.MatchCount, propriété
- CoreWebView2Find.MatchCountChanged, événement
- CoreWebView2Find.StartAsync, méthode
- CoreWebView2Find.Stop, méthode
Bogue
Runtime uniquement
- Correction d’un problème de boîte noire sur les boîtes de dialogue dans l’hébergement visuel.
- Correction du
put_UserAgent
problème de ne pas fonctionner pour les travailleurs du service. - Correction d’un incident dans DevTools sur Windows Server et Windows 10.
1.0.3296.44
Date de publication : 3 juin 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3296.44
Pour une compatibilité complète de l’API, cette version Release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 137.0.3296.44 ou ultérieure.
Promotions
Les API suivantes ont été promues en Stable et sont désormais incluses dans ce Kit de développement logiciel (SDK) release.
Définir la couleur d’arrière-plan par défaut sur l’initialisation WebView2 (API DefaultBackgroundColor)
L’API DefaultBackgroundColor permet aux utilisateurs de définir la propriété lors de l’initialisation DefaultBackgroundColor
. Cela empêche un flash blanc perturbateur pendant le processus de chargement de WebView2.
-
CoreWebView2ControllerOptions
Classe:
Bogue
Runtime uniquement
- Correction des marges dans le fichier PDF imprimé.
1.0.3344-préversion
Date de publication : 3 juin 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3344-prerelease
Pour une compatibilité complète de l’API, cette version préliminaire du Kit de développement logiciel (SDK) WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 138.0.3344.0 ou ultérieure.
API expérimentales
Aucune API expérimentale n’a été ajoutée dans ce Kit de développement logiciel (SDK) préversion.
Promotions
Les API suivantes ont été promues de Experimental à Stable dans ce Kit de développement logiciel (SDK) préversion.
Autoriser le passage des messages d’événement d’entrée dans la fenêtre du navigateur
La CoreWebView2ControllerOptions
classe a maintenant une AllowHostInputProcessing
propriété, qui permet aux messages d’événement d’entrée utilisateur (clavier, souris, interaction tactile ou stylet) de passer par la fenêtre du navigateur, d’être reçus par une fenêtre de processus d’application.
-
CoreWebView2ControllerOptions
Classe:
Bogue
Runtime uniquement
- Correction d’un bogue dans lequel un événement de souris ne se déclenche pas après un événement tactile.
- Capture Web désactivée sur le contrôle WebView2.
- Correction de la boîte de dialogue Téléchargements .
- Correction d’un problème lié aux téléchargements dans l’image de navigateur par défaut. (Problème n° 5196)
- Correction des marges dans le fichier PDF imprimé.
1.0.3240.44
Date de publication : 5 mai 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3240.44
Pour une compatibilité complète de l’API, cette version Release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 136.0.3240.44 ou ultérieure.
Promotions
Les API suivantes ont été promues en Stable et sont désormais incluses dans ce Kit de développement logiciel (SDK) release.
Suivre l’historique de navigation pour les iframes imbriqués (API FrameCreatedEvent)
L’API FrameCreatedEvent prend en charge les iframes imbriqués, comme l’enregistrement de l’historique de navigation d’un iframe de deuxième niveau. Sans cette API, WebView2 effectue uniquement le suivi des iframes de premier niveau, qui sont les iframes enfants directs du frame main. À l’aide de cette API, votre application peut s’abonner à l’événement de création d’iframe imbriqué, ce qui lui donne accès à toutes les propriétés, méthodes et événements de CoreWebView2Frame
pour l’iframe imbriqué.
Utilisez cette API pour gérer le suivi des iframes sur une page qui contient plusieurs niveaux d’iframes. Vous pouvez choisir de suivre l’un des éléments suivants :
- Seul le main page et les iframes de premier niveau (comportement par défaut).
- Arborescence de trames WebView2 partielle avec des iframes spécifiques intéressants.
- Arborescence complète des images WebView2.
-
CoreWebView2Frame
Classe:
Bogue
Runtime uniquement
- Correction d’un problème où les téléchargements à partir de l’image de navigateur par défaut ne se sont pas terminés. (Problème n° 5196)
- Correction d’un problème où le nom du canal était retourné de manière incorrecte, entraînant un blocage dans certaines applications UWP.
1.0.3296-préversion
Date de publication : 12 mai 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3296-prerelease
Pour une compatibilité complète de l’API, cette version préliminaire du Kit de développement logiciel (SDK) WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 137.0.3296.0 ou ultérieure.
API expérimentales
Aucune API expérimentale n’a été ajoutée dans ce Kit de développement logiciel (SDK) préversion.
Promotions
Les API suivantes ont été promues de Experimental à Stable dans ce Kit de développement logiciel (SDK) préversion.
Définir la couleur d’arrière-plan par défaut sur l’initialisation WebView2 (API DefaultBackgroundColor)
L’API DefaultBackgroundColor permet aux utilisateurs de définir la propriété lors de l’initialisation DefaultBackgroundColor
. Cela empêche un flash blanc perturbateur pendant le processus de chargement de WebView2.
-
CoreWebView2ControllerOptions
Classe:
Bogue
Runtime uniquement
- Correction de l’affichage de la barre de recherche qui n’apparaît plus après le décalage de la fenêtre.
- Correction d’un bogue dans lequel l’application n’était pas en mesure d’annuler la navigation vers les pages de connexion via l’événement
NavigationStarting
. - Correction d’un problème où les téléchargements à partir de l’image de navigateur par défaut ne se sont pas terminés. (Problème n° 5196)
- Correction d’un problème où le nom du canal était retourné de manière incorrecte, entraînant un blocage dans certaines applications UWP.
1.0.3179.45
Date de publication : 7 avril 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3179.45
Pour une compatibilité complète de l’API, cette version release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 135.0.3179.45 ou ultérieure.
Promotions
Aucune API supplémentaire n’a été promue stable et ajoutée dans ce Kit de développement logiciel (SDK) release.
Bogue
Runtime uniquement
- Correction de l’élément HTML Select (<select>) pour le rendre sélectionnable dans les applications WPF.
- Correction de la navigation dans
edge://crashes
un contrôle WebView2. - Correction des problèmes potentiels de blocage et d’interface utilisateur lors de l’appel de l’interface utilisateur des informations d’identification Windows à partir d’un instance WebView2.
- Correction d’un bogue dans lequel les utilisateurs ne pouvaient pas taper un champ d’entrée avec des informations de remplissage automatique. (Problème n° 5144)
1.0.3230-préversion
Date de publication : 7 avril 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3230-prerelease
Pour une compatibilité complète de l’API, cette version préliminaire du Kit de développement logiciel (SDK) WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 136.0.3230.0 ou ultérieure.
API expérimentales
Aucune API expérimentale n’a été ajoutée dans ce Kit de développement logiciel (SDK) préversion.
Promotions
Les API suivantes ont été promues de Experimental à Stable dans ce Kit de développement logiciel (SDK) préversion.
Suivre l’historique de navigation pour les iframes imbriqués (API FrameCreatedEvent)
L’API FrameCreatedEvent prend en charge les iframes imbriqués, comme l’enregistrement de l’historique de navigation d’un iframe de deuxième niveau. Sans cette API, WebView2 effectue uniquement le suivi des iframes de premier niveau, qui sont les iframes enfants directs du frame main. À l’aide de cette API, votre application peut s’abonner à l’événement de création d’iframe imbriqué, ce qui lui donne accès à toutes les propriétés, méthodes et événements de CoreWebView2Frame
pour l’iframe imbriqué.
Utilisez cette API pour gérer le suivi des iframes sur une page qui contient plusieurs niveaux d’iframes. Vous pouvez choisir de suivre l’un des éléments suivants :
- Seul le main page et les iframes de premier niveau (comportement par défaut).
- Arborescence de trames WebView2 partielle avec des iframes spécifiques intéressants.
- Arborescence complète des images WebView2.
-
CoreWebView2Frame
Classe:
Bogue
Runtime uniquement
- Correction d’un problème dans WPF où la <liste déroulante de données> se fermait lorsque la souris se déplaçait en dehors des limites du contrôle WebView2.
- Correction de la navigation dans
edge://crashes
un contrôle WebView2. - Correction de l’élément HTML Select (<select>) pour le rendre sélectionnable dans les applications WPF.
- Correction des problèmes potentiels de blocage et d’interface utilisateur lors de l’appel de l’interface utilisateur des informations d’identification Windows à partir d’un instance WebView2.
- Correction d’un bogue dans lequel les utilisateurs ne pouvaient pas taper le champ d’entrée avec les informations de remplissage automatique. (Problème n° 5144)
- Correction d’une régression dans les API de la barre d’état .
KIT de développement logiciel (SDK) uniquement
- Correction des touches Tab, Maj+Tab et Flèche dans le mode d’hébergement Fenêtre vers visuel.
1.0.3124.44
Date de publication : 10 mars 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3124.44
Pour une compatibilité complète de l’API, cette version Release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 134.0.3124.44 ou ultérieure.
Promotions
Aucune API supplémentaire n’a été promue stable et ajoutée dans ce Kit de développement logiciel (SDK) release.
Bogue
Runtime uniquement
- Les extensions ne seront pas désactivées dans WebView2 à l’aide
AddBrowserExtensionAsync
de , que le mode développeur soit activé ou non. (Problème n° 5113) - Désactivation de la mise à jour en arrière-plan de l’heure réseau. (Problème n° 5047)
- Correction de l’affichage de la fenêtre contextuelle de téléchargement lorsque
target="_blank"
. (Problème n° 5063)
1.0.3171-préversion
Date de publication : 10 mars 2025
Package NuGet pour webView2 SDK 1.0.3171-prerelease
Pour une compatibilité complète de l’API, cette version préliminaire du Kit de développement logiciel (SDK) WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 135.0.3171.0 ou ultérieure.
API expérimentales
Aucune API expérimentale n’a été ajoutée dans ce Kit de développement logiciel (SDK) préversion.
Promotions
Aucune API n’a été promue d’Expérimentale à Stable dans ce KIT de développement logiciel (SDK) préversion.
Bogue
Runtime et KIT de développement logiciel (SDK)
- Correction de la gestion des exceptions de méthode asynchrone de l’objet hôte. (Problème #3402)
- Correction de la documentation pour
CoreWebVIew2.Navigate
. (Problème n° 5091)
Runtime uniquement
- Correction d’une régression d’installation du magasin « Ajouter à Chrome ».
- Correction des chargements de dossiers dans UWP et WinUI. (Problème n° 3275)
- Les extensions ne seront pas désactivées dans WebView2 à l’aide
AddBrowserExtensionAsync
de , que le mode développeur soit activé ou non. (Problème n° 5113) - Désactivation de la mise à jour en arrière-plan de l’heure réseau. (Problème n° 5047)
- Correction de l’affichage de la fenêtre contextuelle de téléchargement lorsque
target="_blank"
. (Problème n° 5063)
KIT de développement logiciel (SDK) uniquement
- Corrige un incident qui peut se produire lorsque le garbage collector appelle
Finalize
sur un thread autre que le thread main.
Voir également
- À propos des notes de publication du Kit de développement logiciel (SDK) WebView2
- Notes de publication archivées pour le Kit de développement logiciel (SDK) WebView2
- Vue d’ensemble des API WebView2 : décrit la plupart des API, par domaine de fonctionnalité, qui se trouvent dans les packages du Kit de développement logiciel (SDK) release.
- Contacter l’équipe Microsoft Edge WebView2
- Notes de publication pour la plateforme web Microsoft Edge
Informations de référence sur l’API :
-
Référence de l’API WebView2
- .NET : Espace de noms Microsoft.Web.WebView2.Core
- WinRT : Espace de noms Microsoft.Web.WebView2.Core
- Win32 : Référence (WebView2 Win32 C++)