Remarque
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.3650.58
Date de publication : 8 décembre 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3650.58
Pour une compatibilité complète de l’API, cette version Release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 143.0.3650.58 ou ultérieure.
Promotions vers la phase 3 (stable dans la version)
Aucune API supplémentaire n’a été promue de Phase 2 : Stable en préversion à Phase 3 : Stable dans la version, dans ce Kit de développement logiciel (SDK) release.
Bogue
Runtime uniquement
- Correction de l’accès au réseau local déclenchant une fenêtre contextuelle d’alerte d’autorisation.
1.0.3712-préversion
Date de publication : 8 décembre 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3712-preversion
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 144.0.3712.0 ou ultérieure.
Promotions à la phase 1 (expérimentale en préversion)
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.
Personnaliser le comportement des plages de ports
Les API Plage de ports autorisées permettent de restreindre ou de personnaliser les plages de ports réseau que WebView2 peut utiliser pour différents protocoles et étendues de transport. Cela fournit un contrôle de sécurité amélioré.
Utilisez
SetAllowedPortRangesur le instance (ouICoreWebView2ExperimentalEnvironmentOptions) pour configurer des restrictions de port lors de laCoreWebView2EnvironmentOptionscréation de l’environnement.Utilisez le
scopeparamètre pour spécifier si la configuration s’applique à tous les composants (Default) ou uniquement aux connexions d’égal à égal WebRTC (WebRtc). Actuellement, seulWebRtcest pris en charge.Utilisez le
protocolparamètre pour spécifier le protocole de transport (prend actuellement en chargeUdp).Spécifiez
minPortles valeurs etmaxPortcomprises entre 1025 et 65535 (inclus) ou utilisez (0,0) pour réinitialiser/supprimer les restrictions.
Utilisez
GetEffectiveAllowedPortRangesur leCoreWebView2EnvironmentOptions(ouICoreWebView2ExperimentalEnvironmentOptions) instance pour récupérer la configuration de la plage de ports active pour une étendue et un protocole spécifiques.Retourne la plage explicitement définie pour l’étendue donnée, ou hérite de l’étendue si elle n’est
Defaultpas définie.Retourne (0,0) si aucune restriction n’est configurée pour l’étendue spécifiée.
CoreWebView2EnvironmentOptionsClasseÉnumération CoreWebView2AllowedPortRangeScope
CoreWebView2AllowedPortRangeScope.DefaultCoreWebView2AllowedPortRangeScope.WebRtc
CoreWebView2TransportProtocolKind Enum
CoreWebView2TransportProtocolKind.Udp
Promotions à la phase 2 (stable en préversion)
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 glisser-déplacer (API DragStarting)
L’API DragStarting remplace le comportement glisser-déplacer par défaut lors de l’exécution en mode d’hébergement visuel. L’événement DragStarting avertit votre application lorsque l’utilisateur démarre une opération de glissement dans le WebView2 et fournit l’état nécessaire pour remplacer l’opération de glissement WebView2 par défaut par votre propre logique.
- Utilisez
DragStartingsur pourICoreWebView2CompositionController5ajouter un gestionnaire d’événements appelé lorsque l’opération de glissement démarre. - Utilisez
ICoreWebView2DragStartingEventArgspour démarrer votre propre opération de glissement.- Utilisez la
GetDeferralméthode pour exécuter une logique de glissement asynchrone et rappeler dans WebView ultérieurement. - Utilisez la
Handledpropriété pour indiquer au WebView2 s’il faut utiliser sa propre logique de glissement.
- Utilisez la
Bogue
Ce Kit de développement logiciel (SDK) préversion inclut les correctifs de bogues suivants.
Runtime uniquement
- Correction de l’accès au réseau local déclenchant une fenêtre contextuelle d’alerte d’autorisation.
- Correction d’une régression de l’API
setColorScheme. - Correction de l’initialisation différée pour
ICoreWebView2NewWindowRequestedEventArgspour le commutateurenable-new-window-requested-deferred-initializationde ligne de commande .
1.0.3595.46
Date de publication : 3 novembre 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3595.46
Pour une compatibilité complète de l’API, cette version release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 142.0.3595.46 ou ultérieure.
Promotions vers la phase 3 (stable dans la version)
Aucune API supplémentaire n’a été promue de Phase 2 : Stable en préversion à Phase 3 : Stable dans la version, dans ce Kit de développement logiciel (SDK) release.
Bogue
Ce Kit de développement logiciel (SDK) de version inclut les correctifs de bogues suivants.
Runtime uniquement
- Désactivation de la création d’un processus « Renderer spéculatif ».
1.0.3650-préversion
Date de publication : 7 novembre 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3650-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 143.0.3650.0 ou ultérieure.
Promotions à la phase 1 (expérimentale en préversion)
Aucune API expérimentale n’a été ajoutée dans ce Kit de développement logiciel (SDK) préversion.
Promotions à la phase 2 (stable en préversion)
Aucune API n’a été promue de Phase 1 : Expérimentale en préversion à Phase 2 : Stable dans la préversion, dans ce KIT DE développement logiciel (SDK) préversion.
Bogue
Ce Kit de développement logiciel (SDK) préversion inclut les correctifs de bogues suivants.
Runtime uniquement
- Désactivation de la création d’un processus « Renderer spéculatif ».
- Correction d’un problème de synchronisation de boîte de dialogue Rechercher lors de l’exécution d’une recherche par programme.
1.0.3537.50
Date de publication : 6 octobre 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3537.50
Pour une compatibilité complète de l’API, cette version release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 141.0.3537.50 ou ultérieure.
Promotions vers la phase 3 (stable dans la version)
Aucune API supplémentaire n’a été promue de Phase 2 : Stable en préversion à Phase 3 : Stable dans la version, dans ce Kit de développement logiciel (SDK) release.
Bogue
Ce Kit de développement logiciel (SDK) de version inclut les correctifs de bogues suivants.
Runtime uniquement
- Correction de l’accès au réseau local déclenchant une fenêtre contextuelle d’alerte d’autorisation.
KIT de développement logiciel (SDK) uniquement
- Correction d’une erreur BinSkim pour
WebView2Loader.dll.
1.0.3590-préversion
Date de publication : 7 octobre 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3590-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 142.0.3590.0 ou ultérieure.
Promotions à la phase 1 (expérimentale en préversion)
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.
Prise en charge des étiquettes de confidentialité
Une nouvelle API d’informations de confidentialité dans WebView2 permet aux applications d’accéder aux informations d’étiquette de confidentialité communiquées par les pages web via le Gestionnaire de restriction d’interaction de page. Cette fonctionnalité permet aux applications hôtes de détecter et de répondre au contenu sensible.
Fonctionnalités clés :
Configurer la disponibilité du Gestionnaire de restriction d’interaction de page : configurez une liste de filtres d’URL pour le Gestionnaire de restriction d’interaction de page. Une fois la liste configurée, le Gestionnaire de restriction d’interaction de page devient disponible sur les pages de la liste verte. Ces pages peuvent envoyer des étiquettes de confidentialité à la plateforme via l’API.
Exposition des informations -
CoreWebView2de confidentialité expose désormais uneSensitivityInfopropriété et unSensitivityInfoChangedévénement, ce qui permet aux applications d’écouter les mises à jour des informations d’étiquette de confidentialité.
La prise en charge des étiquettes de confidentialité est initialement disponible sur Win32 uniquement. La prise en charge de .NET et de WinRT est prévue pour une version ultérieure.
Promotions à la phase 2 (stable en préversion)
Aucune API n’a été promue de Phase 1 : Expérimentale en préversion à Phase 2 : Stable dans la préversion, dans ce KIT DE développement logiciel (SDK) préversion.
Bogue
Ce Kit de développement logiciel (SDK) préversion inclut les correctifs de bogues suivants.
Runtime uniquement
- Correction d’un pointeur non actif dans le contexte d’autorisation d’accès au système de fichiers.
- Correction de la suspension de l’interface utilisateur pendant le glisser-déplacer dans WinUI3.
- Correction de l’accès au réseau local déclenchant une fenêtre contextuelle d’alerte d’autorisation.
- Résolution d’un problème où une région supplémentaire apparaissait dans l’arborescence d’accessibilité.
- Correction d’un problème où les téléchargements dans l’image de navigateur par défaut ne fonctionnaient pas.
KIT de développement logiciel (SDK) uniquement
- Correction d’une erreur BinSkim pour
WebView2Loader.dll.
1.0.3485.44
Date de publication : 8 septembre 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3485.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 140.0.3485.44 ou ultérieure.
Modifications générales
Ce Kit de développement logiciel (SDK) release se concentre sur l’amélioration du fonctionnement de WebView2, grâce à des améliorations en arrière-plan.
- L’infrastructure de test a été renforcée.
- La validation des API a été améliorée pour s’assurer que les API s’exécutent de manière fiable dans différents scénarios.
Ces améliorations fondamentales fournissent des fonctionnalités stables et minutieusement testées pour la création d’applications WebView2.
Promotions vers la phase 3 (stable dans la version)
Aucune API supplémentaire n’a été promue de Phase 2 : Stable en préversion à Phase 3 : Stable dans la version, dans ce Kit de développement logiciel (SDK) release.
Bogue
Il n’y a aucun correctif de bogue dans ce Kit de développement logiciel (SDK) release.
1.0.3530-préversion
Date de publication : 8 septembre 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3530-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 141.0.3530.0 ou ultérieure.
Modifications générales
Ce Kit de développement logiciel (SDK) de préversion se concentre sur l’amélioration du fonctionnement de WebView2, grâce à des améliorations en arrière-plan.
- L’infrastructure de test a été renforcée.
- La validation des API a été améliorée pour s’assurer que les API s’exécutent de manière fiable dans différents scénarios.
Ces améliorations fondamentales fournissent des fonctionnalités stables et minutieusement testées pour la création d’applications WebView2.
Promotions à la phase 1 (expérimentale en préversion)
Aucune API expérimentale n’a été ajoutée dans ce Kit de développement logiciel (SDK) préversion.
Promotions à la phase 2 (stable en préversion)
Aucune API n’a été promue de Phase 1 : Expérimentale en préversion à Phase 2 : Stable dans la préversion, dans ce KIT DE développement logiciel (SDK) préversion.
Bogue
Ce Kit de développement logiciel (SDK) préversion inclut les correctifs de bogues suivants.
KIT de développement logiciel (SDK) uniquement
- Correction d’une fuite de mémoire dans le contrôleur de composition WPF.
1.0.3405.78
Date de publication : 11 août 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3405.78
Pour une compatibilité complète de l’API, cette version release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 139.0.3405.78 ou ultérieure.
Promotions vers la phase 3 (stable dans la version)
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.
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 .
CoreWebView2Classe:CoreWebView2EnvironmentClasse:-
- 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 incident dans Devtools sur Windows Server et Windows 10.
1.0.3477-préversion
Date de publication : 11 août 2025
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3477-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 140.0.3477.0 ou ultérieure.
Promotions à la phase 1 (expérimentale en préversion)
Aucune API expérimentale n’a été ajoutée dans ce Kit de développement logiciel (SDK) préversion.
Promotions à la phase 2 (stable en préversion)
Aucune API n’a été promue de Phase 1 : Expérimentale en préversion à Phase 2 : Stable dans la préversion, dans ce KIT DE développement logiciel (SDK) préversion.
Bogue
Runtime uniquement
- Correction du
put_UserAgentproblème de ne pas fonctionner pour les travailleurs du service. - Correction d’un incident dans Devtools sur Windows Server et Windows 10.
- Suppression du suivi du processus de navigateur après l’appel de
remove_BrowserProcessExited. - Correction d’un problème de fuite de mémoire dans les
hostObjectappels de fonction asynchrone. - Correction de l’interaction tactile qui ne fonctionne pas dans l’hébergement visuel après un long appui.
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 vers la phase 3 (stable dans la version)
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.
-
CoreWebView2ControllerOptionsClasse:
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.
Promotions à la phase 1 (expérimentale en préversion)
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 workers web pour décharger les tâches du thread principal, 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
PostMessageetWebMessageReceived. - Gestion des workers : Interroger et récupérer des instances et des inscriptions de worker.
-
CoreWebView2Classe:
-
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
-
CoreWebView2FrameClasse:
-
CoreWebView2ProfileClasse:
-
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: dragetIsNonClientRegionSupportEnabled.
Cette API est idéale pour les applications qui nécessitent une expérience d’interface utilisateur moderne et immersive.
Promotions à la phase 2 (stable en préversion)
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 .
CoreWebView2Classe:CoreWebView2EnvironmentClasse:-
- 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_UserAgentproblème de ne pas fonctionner pour les travailleurs du service. - Correction d’un incident dans DevTools sur Windows Server et Windows 10.
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++)