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.
Les nouvelles fonctionnalités et corrections de bogues suivantes se trouvent dans le SDK de version WebView2 et le SDK de préversion.
Kit de développement logiciel (SDK) de version préliminaire 1.0.4181-version préliminaire, pour Runtime 152 (3 août 2026)
Date de publication : 3 août 2026
Package NuGet pour WebView2 SDK 1.0.4181-prerelease
Pour une compatibilité d’API complète, cette version préliminaire du SDK WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 152.0.4181.0 ou ultérieure.
API expérimentales (phase 1 : expérimental en préversion)
Les API suivantes sont en phase 1 : expérimentales en version préliminaire et ont été ajoutées dans ce kit de développement logiciel (SDK) en version préliminaire.
API Moniteur de diagnostic
L’API DiagnosticMonitor fournit une surface de journalisation d’observation uniquement qui permet à une application hôte de collecter des signaux de diagnostic détaillés à partir de WebView2. Un moniteur observe les signaux de tous les WebViews, profils et environnement par le biais d’un seul DiagnosticReceived événement.
L’événement est destiné à l’analyse hors connexion ou au transfert de télémétrie ; elle ne peut pas être interceptée, modifiée ou différée.
Une application hôte crée un moniteur en appelant CoreWebView2Environment.CreateDiagnosticMonitor. Un moniteur nouvellement créé est inerte et ne fournit aucun événement tant que l’application n’a pas opté pour une catégorie en appelant SetDiagnosticFilter avec une catégorie de diagnostic (par exemple NetworkRequest, ) et une chaîne de filtre JSON.
La transmission "{}" à SetDiagnosticFilter reçoit tous les événements de cette catégorie. Un objet JSON non vide applique une correspondance au niveau du champ (par exemple, pour le filtrage des requêtes réseau) à des valeurs OR httpMethod spécifiqueserrorCode.
Appeler SetDiagnosticFilter à nouveau pour la même catégorie remplace le filtre précédent.
Chaque DiagnosticReceived événement expose le , Scope, Timestampet une DetailsAsJson charge utile dont le Categoryschéma est défini par catégorie avec un ensemble de champs garantis. L’API est JSON-in/JSON-out par conception, de sorte que de nouvelles catégories et de nouveaux champs peuvent être livrés sans rompre le contrat de l’API ; Les consommateurs doivent ignorer les clés inconnues.
La libération ou la fermeture du moniteur arrête tous les événements et efface tous les filtres.
CoreWebView2DiagnosticCategory Enum
NetworkRequest
CoreWebView2DiagnosticScope Enum
WebviewProfileEnvironment
CoreWebView2EnvironmentClasse :
Promotions à la phase 2 (stable en préversion)
Aucune API n’a été promue de la phase 1 : expérimentale en version préliminaire à la phase 2 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) en version préliminaire.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) de version préliminaire contient les correctifs de bogues suivants.
Runtime uniquement
- Correction des glyphes invisibles du bouton de légende sur les arrière-plans de superposition sombres des contrôles de fenêtre.
- Accès restreint à un canal hôte singleton dans les clients WebView2 hérités.
- Suppression de l’ajout implicite
window.gcsur les vues web. - Correction de l’annonce « Télécharger le raccourci » par les lecteurs d’écran.
- Correction du problème de scintillement Min/Max/Close dans la superposition de contrôle Windows.
- Correction du respect d’un facteur d’échelle personnalisé pour l’impression PDF.
- Correction de la logique d’ancrage de la fenêtre contextuelle de téléchargement à fenêtre minimale.
- Correction de l’impossibilité de faire glisser une fenêtre via la bordure supérieure d’une barre de titre personnalisée.
Kit de développement logiciel (SDK) uniquement
- Correction d’un blocage de WPF lors de la modification de la topologie d’affichage dans les applications contrôlées par la composition.
Publication du SDK 1.0.4129.50 pour Runtime 151 (3 août 2026)
Date de publication : 3 août 2026
Package NuGet pour WebView2 SDK 1.0.4129.50
Pour une compatibilité totale avec l’API, cette version du SDK WebView2 nécessite la version 151.0.4129.50 du runtime WebView2 ou une version ultérieure.
Promotions à la phase 3 (stable dans la publication)
Aucune API supplémentaire n’a été promue de la phase 2 : stable en version préliminaire à la phase 3 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) de version.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) inclut les correctifs de bogues suivants.
Runtime uniquement
- Accès restreint à un canal hôte singleton dans les clients WebView2 hérités.
Kit de développement logiciel (SDK) de version préliminaire 1.0.4126-version préliminaire, pour Runtime 151 (7 juillet 2026)
Date de publication : 7 juillet 2026
Package NuGet pour WebView2 SDK 1.0.4126-prerelease
Pour une compatibilité d’API totale, cette version préliminaire du SDK WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 151.0.4126.0 ou ultérieure.
Modifications générales
Le runtime WebView2 passe à une cadence de publication de 2 semaines
À partir de la version 152 (24 août 2026), le runtime WebView2 passe à une cadence de publication de 2 semaines. Ceci est aligné sur Microsoft Edge. La version 151 du runtime WebView2 est la version finale dont la cadence de publication est de 4 semaines.
Exécutez votre application hôte WebView2 avec une intégrité utilisateur standard plutôt qu’élevée
Exécutez votre application hôte WebView2 avec une intégrité utilisateur standard plutôt qu’élevée. Voir Niveau de privilège recommandé pour les applications hôtes WebView2 dans Développer des applications WebView2 sécurisées.
API expérimentales (phase 1 : expérimental en préversion)
Les API suivantes sont en phase 1 : expérimentales en version préliminaire et ont été ajoutées dans ce kit de développement logiciel (SDK) en version préliminaire.
Rapport d’incident dans l’événement ProcessFailed
L’API CrashReport fournit des données de diagnostic d’incident lorsqu’un processus WebView2 échoue avec un incident. Lorsqu’un ProcessFailed événement est déclenché, l’application hôte peut accéder à la CrashReport propriété sur pour récupérer les détails de la signature d’incident ProcessFailedEventArgs , notamment :
- Code d’exception.
- Nom et version du module défaillant.
- Décalage de défaut.
- L’ID de rapport d’incident.
- ID de compartiment.
- L’heure à laquelle l’accident a été signalé.
ProcessFailedEventArgs.CrashReport est null lorsque la défaillance n’a pas produit de rapport d’incident, comme dans les scénarios suivants :
- Une sortie normale.
- Un arrêt externe du processus.
- Un échec de lancement.
- Un pendaison.
ProcessFailedEventArgs.CrashReport Peut également être null pour certaines défaillances de type crash où aucun rapport n’a été produit. Les applications hôtes doivent toujours vérifier la case activée avant null d’accéder aux propriétés.
Classe CoreWebView2CrashReport
- Propriété CoreWebView2CrashReport.BucketId
- Propriété CoreWebView2CrashReport.CrashReportId
- Propriété CoreWebView2CrashReport.ExceptionCode
- Propriété CoreWebView2CrashReport.FaultingModuleName
- Propriété CoreWebView2CrashReport.FaultingModuleVersion
- Propriété CoreWebView2CrashReport.FaultOffset
- CoreWebView2CrashReport.ReportTime Property
CoreWebView2ProcessFailedEventArgsClasse :
Configurer les paramètres de vérification de la réputation par origine (SmartScreen)
Cette ReputationChecking fonctionnalité permet à une application WebView2 d’ignorer les vérifications de réputation SmartScreen pour les navigations et les téléchargements à partir d’origines approuvées spécifiques.
ReputationChecking est membre de l’énumération CoreWebView2OriginFeature .
Lorsque cette fonctionnalité est définie sur une origine, les vérifications de CoreWebView2OriginFeatureState.Disabled réputation du hameçonnage et des programmes malveillants sont contournées pour cette origine. Si cette fonctionnalité n’est pas configurée pour une origine, le CoreWebView2Settings.IsReputationCheckingRequired paramètre, qui est global, s’applique ; la préférence au niveau du processus du navigateur est appliquée à tous les processus qui l’utilisent.
Si CoreWebView2Settings.IsReputationCheckingRequired est défini sur false, le paramètre CoreWebView2OriginFeatureState.Enabled pour une origine ne réactive pas les vérifications de réputation pour cette origine ; CoreWebView2Settings.IsReputationCheckingRequired est prioritaire.
CoreWebView2OriginFeatureÉnumération :CoreWebView2ProfileClasse :
Anciennes API de prise en charge :
CoreWebView2OriginFeatureState Enum
EnabledDisabled
CoreWebView2SettingsClasse :
Promotions à la phase 2 (stable en préversion)
Aucune API n’a été promue de la phase 1 : expérimentale en version préliminaire à la phase 2 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) en version préliminaire.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) de version préliminaire contient les correctifs de bogues suivants.
Runtime uniquement
- Correction de la réentrée pour la suppression des images.
- Correction de l’accès de l’enveloppeur d’objet pour un fichier d’autorisation utilisateur (UAF).
- Estampillé l’origine faisant autorité sur le canal hôte, pour éviter une
WebMessageReceivedEventArgs.Sourceusurpation d’identité. - Accès restreint à un canal hôte singleton, dans un WebView2 déconseillé.
- Suppression du
originparamètre des méthodes qui accèdent à un objet natif. - Application renforcée de l’hôte
kDenyvirtuel WebView2 contre l’usurpation d’identité du moteur de rendu et les échappements de jonction NTFS (New Technology File System). - Correction de l’arborescence d’UI Automation (UIA) de fenêtre à visuel.
- Correction d’une régression dans l’API
AddScriptToExecuteOnDocumentCreated. - Implémentation
OnRendererResponsivepour le suivi des résultats de blocage.
Publication du SDK 1.0.4078.44, pour Runtime 150 (7 juillet 2026)
Date de publication : 7 juillet 2026
Package NuGet pour WebView2 SDK 1.0.4078.44
Pour une compatibilité complète de l’API, cette version du SDK WebView2 nécessite la version 150.0.4078.44 du runtime WebView2 ou une version ultérieure.
Modifications générales
Le runtime WebView2 passe à une cadence de publication de 2 semaines
Consultez WebView2 Runtime is changing to a 2 semaines release cadence, dans la section Prerelease ci-dessus.
Promotions à la phase 3 (stable dans la publication)
Aucune API supplémentaire n’a été promue de la phase 2 : stable en version préliminaire à la phase 3 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) de version.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) inclut les correctifs de bogues suivants.
Runtime uniquement
- Correction de la réentrée pour la suppression des images.
- Correction de l’accès de l’enveloppeur d’objet pour un fichier d’autorisation utilisateur (UAF).
- Estampillé l’origine faisant autorité sur le canal hôte, pour éviter une
WebMessageReceivedEventArgs.Sourceusurpation d’identité. - Accès restreint à un canal hôte singleton, dans un WebView2 déconseillé.
- Suppression du
originparamètre des méthodes qui accèdent à un objet natif. - Application renforcée de l’hôte
kDenyvirtuel WebView2 contre l’usurpation d’identité du moteur de rendu et les échappements de jonction NTFS (New Technology File System). - Correction de l’arborescence d’UI Automation (UIA) de fenêtre à visuel.
- Correction d’une régression dans l’API
AddScriptToExecuteOnDocumentCreated.
Kit de développement logiciel (SDK) de version préliminaire 1.0.4071-version préliminaire, pour Runtime 150 (11 juin 2026)
Date de publication : 11 juin 2026
Package NuGet pour WebView2 SDK 1.0.4071-prerelease
Pour une compatibilité d’API complète, cette version préliminaire du SDK WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 150.0.4071.0 ou ultérieure.
Changements cassants
Activer la prise en charge de l’écriture manuscrite de l’interpréteur de commandes Windows pour WebView2 en mode WindowToVisual
WebView2 introduit la prise en charge de l’écriture manuscrite du shell Windows (écriture manuscrite au stylo en texte) pour les champs d’édition à l’intérieur des instances WebView2 hébergées en mode Window to Visual (WindowToVisual) sur Windows.
Cette modification affecte uniquement WindowToVisual le mode d’hébergement.
WindowToWindow le mode d’hébergement prend déjà en charge l’écriture manuscrite Windows Shell, et VisualToVisual le mode d’hébergement n’est pas pris en charge par cette modification.
Avant cette modification : WebView2 en WindowToVisual mode n’enregistre pas de ITfHandwritingSink sur le thread TSF (Text Services Framework). L’écriture manuscrite de l’interpréteur de commandes Windows peut toujours fonctionner, mais la détermination de la cible d’écriture manuscrite utilise le chemin d’accès basé sur OS UI Automation (UIA).
Après cette modification : si l’indicateur de msAbydosForWindowlessWV2 fonctionnalité est désactivé, le comportement reste le même qu’avant cette modification, y compris le chemin de détermination de la cible d’écriture manuscrite basé sur UIA.
Si l’indicateur msAbydosForWindowlessWV2 de fonctionnalité est activé, WebView2 en WindowToVisual mode enregistre un par instance ITfHandwritingSink sur le thread TSF. Cela active l’écriture manuscrite Windows shell pour les champs d’édition dans WebView2 et modifie la façon dont les événements d’écriture manuscrite TSF sont routés sur le thread TSF partagé.
Si votre application enregistre déjà son propre ITfHandwritingSink thread TSF, l’écriture manuscrite du stylet continuera de fonctionner pour les champs d’édition natifs de votre application, et l’écriture manuscrite du stylet fonctionnera également dans les champs d’édition WebView2.
Si votre application n’enregistre pas son propre ITfHandwritingSink, l’écriture manuscrite peut cesser de fonctionner pour les champs d’édition natifs de votre application une fois cette modification activée par défaut. Ce problème se produit, car WebView2 renvoie E_NOTIMPL pour les HWND qu’il ne possède pas, en s’attendant à ce que TSF soit chaîné à un autre récepteur enregistré. Si aucun récepteur hôte n’est inscrit, TSF ne revient pas à la résolution cible d’écriture manuscrite par défaut basée sur l’interface utilisateur (UIA).
Pour conserver la prise en charge de l’écriture manuscrite du stylet pour les champs d’édition natifs de votre application, inscrivez les vôtres ITfHandwritingSink sur le thread TSF. L’écriture manuscrite du stylet dans les champs d’édition de WebView2 est activée automatiquement par cette modification.
Vous pouvez valider de manière proactive le comportement de votre application WebView2 en activant l’indicateur de fonctionnalité suivant avant de lancer votre application :
set WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--enable-features=msAbydosForWindowlessWV2
Dans les versions 149 et 150, l’indicateur de msAbydosForWindowlessWV2 fonctionnalité est désactivé par défaut, ce qui laisse aux applications le temps de tester de manière proactive. À compter de la version 151, la fonctionnalité devrait être activée par défaut.
En testant votre application WebView2 avec cet indicateur de fonctionnalité activé, vous pouvez identifier si les flux de travail d’écriture manuscrite de champ d’édition natifs dans votre application dépendent de l’inscription d’un hôte ITfHandwritingSink.
Voir aussi :
- [Changement de dernière minute] Activation de la prise en charge de Windows ShellHandwriting pour WebView2 en mode WindowToVisual (problème #134)
- Hébergement fenêtré ou visuel de WebView2
-
Indicateurs de navigateur WebView2 : indicateur de
msAbydosForWindowlessWV2fonctionnalité.
Modifications générales
Dépréciation du package NuGet DevToolsProtocolExtension
Package NuGet pour DevToolsProtocolExtension 1.0.2901
Le Microsoft.Web.WebView2.DevToolsProtocolExtension package NuGet est déconseillé et aucune autre version de ce package ne sera publiée. Cette dépréciation n’est pas liée à un SDK WebView2 Release ou à un SDK de préversion.
Le package DevToolsProtocolExtension fournit une enveloppe .NET fortement typée sur le protocole Chrome DevTools (CDP) pour une utilisation dans les applications WebView2. Les versions publiées existantes (1.0.824, 1.0.2271, et 1.0.2901) restent disponibles dans la galerie NuGet et ne sont pas supprimées.
Voir aussi :
Alternative recommandée :
Tous les appels CDP peuvent être effectués directement via les API CDP WebView2, sans utiliser le package d’extension. Consultez Utiliser le protocole Chrome DevTools (CDP) dans les applications WebView2 et les éléments suivants :
API expérimentales (phase 1 : expérimental en préversion)
Aucune API expérimentale n’a été ajoutée dans ce Kit de développement logiciel (SDK) de la version préliminaire.
Promotions à la phase 2 (stable en préversion)
Aucune API n’a été promue de la phase 1 : expérimentale en version préliminaire à la phase 2 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) en version préliminaire.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) de version préliminaire contient les correctifs de bogues suivants.
Runtime et SDK
- Ajout d’histogrammes de nombre total pour l’environnement WebView2 et les tentatives de création de contrôleurs.
Runtime uniquement
- Mappé
TERMINATION_STATUS_LAUNCH_FAILED_OS_POLICYàkLaunchFailed. - Mise à jour de la classification
OOMde la raison d’échec à , pour un processus qui a été arrêté pour récupérer de la mémoire. - Ajout d’un instantané de mémoire système au moment de la détection de mémoire insuffisante (OOM) pour analyse.
- Correction de la fermeture silencieuse d’une fenêtre contextuelle, lorsque l’hôte s’attend à ce que la fenêtre contextuelle reste ouverte.
- Ajout de la vérification de l’origine approuvée lors de la case activée lors de l’accès à l’objet hôte.
- Réduction des recherches de cartes redondantes dans le gestionnaire de demandes d’URL WebView2, pour de meilleures performances.
- Élimination des allocations de chaînes inutiles dans la couche de cookies WebView2, pour de meilleures performances.
Kit de développement logiciel (SDK) uniquement
- Correction de problèmes de sécurité de conteneur dans le code de trame et d’écouteur WebView2.
- L’abonnement aux événements WinRT maintient désormais le wrapper de projection en vie jusqu’à ce que le gestionnaire soit désabonné.
Libérer le SDK 1.0.4022.49, pour le runtime 149 (11 juin 2026)
Date de publication : 11 juin 2026
Package NuGet pour WebView2 SDK 1.0.4022.49
Pour une compatibilité complète de l’API, cette version du SDK WebView2 nécessite la version 149.0.4022.49 du runtime WebView2 ou une version ultérieure.
Promotions à la phase 3 (stable dans la publication)
Les API suivantes ont été promues de la phase 2 : stable en version préliminaire à la phase 3 : stable en version et sont désormais incluses dans ce kit de développement logiciel (SDK) de publication.
Activer le traitement en arrière-plan et la prise en charge hors connexion (API de travail WebView2)
Les API de travail WebView2 permettent aux applications hôtes d’interagir avec les travailleurs web pour décharger des tâches du thread principal, améliorer la réactivité et prendre en charge les opérations en arrière-plan. Ces travailleurs web incluent des travailleurs dédiés, des travailleurs partagés et des travailleurs de service.
Ces API fournissent :
- Événements du cycle de vie : Surveiller la création et la destruction de travailleurs.
-
Interfaces de messagerie : Communiquer avec les travailleurs à l’aide de
PostMessageetWebMessageReceived; plus précisément :CoreWebView2ServiceWorker.PostWebMessageAsJsonCoreWebView2ServiceWorker.PostWebMessageAsStringCoreWebView2DedicatedWorker.PostWebMessageAsJsonCoreWebView2DedicatedWorker.PostWebMessageAsStringCoreWebView2ServiceWorker.WebMessageReceivedCoreWebView2DedicatedWorker.WebMessageReceivedchrome.webview.postMessage- Pas :
chrome.webview.postMessageWithAdditionalObjects
- Gestion des employés : Interroger et récupérer les inscriptions et instances de travail.
-
CoreWebView2Classe :
-
Classe CoreWebView2DedicatedWorker
- CoreWebView2DedicatedWorker.DedicatedWorkerCreated Event
- CoreWebView2DedicatedWorker.Destroying Event
- CoreWebView2DedicatedWorker.PostWebMessageAsJson méthode
- CoreWebView2DedicatedWorker.PostWebMessageAsString Method
- Propriété CoreWebView2DedicatedWorker.ScriptUri
- Événement CoreWebView2DedicatedWorker.WebMessageReceived
-
CoreWebView2FrameClasse :
-
CoreWebView2ProfileClasse :
-
Classe CoreWebView2ServiceWorkerRegistration
- Propriété CoreWebView2ServiceWorkerRegistration.ActiveServiceWorker
- Propriété CoreWebView2ServiceWorkerRegistration.Origin
- Propriété CoreWebView2ServiceWorkerRegistration.ScopeUri
- CoreWebView2ServiceWorkerRegistration.ServiceWorkerActivated Event
- Propriété CoreWebView2ServiceWorkerRegistration.TopLevelOrigin
- Événement CoreWebView2ServiceWorkerRegistration.Unregistration Event
Correctifs de bogues
Ce Kit de développement logiciel (SDK) inclut les correctifs de bogues suivants.
Runtime uniquement
- Mappé
TERMINATION_STATUS_LAUNCH_FAILED_OS_POLICYàkLaunchFailed. - Mise à jour de la classification
OOMde la raison d’échec à , pour un processus qui a été arrêté pour récupérer de la mémoire. - Ajout de la vérification de l’origine approuvée lors de la case activée lors de l’accès à l’objet hôte.
- Correction de la non-sélection des listes déroulantes de la boîte de dialogue Imprimer dans
WebView2CompositionControl. (Numéro #5195)
Kit de développement logiciel (SDK) uniquement
- Correction de problèmes de sécurité de conteneur dans le code de trame et d’écouteur WebView2.
Kit de développement logiciel (SDK) de version préliminaire 1.0.4015-version préliminaire, pour le runtime 149 (11 mai 2026)
Date de publication : 11 mai 2026
Package NuGet pour WebView2 SDK 1.0.4015-prerelease
Pour une compatibilité d’API complète, cette version préliminaire du SDK WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 149.0.4015.0 ou ultérieure.
Changements cassants
EnhancedSecurityModeLevel remplacé par EnhancedSecurityModeState
La CoreWebView2Profile.EnhancedSecurityModeLevel propriété et l’énumération CoreWebView2EnhancedSecurityModeLevel sont déconseillées et seront supprimées dans une version ultérieure. Remplacez toute utilisation de ces API dans votre application WebView2, comme suit.
L’ancienne propriété, CoreWebView2Profile.EnhancedSecurityModeLevel, contrôlait si le mode de sécurité renforcée (ESM) était activé ou désactivé pour toutes les instances WebView2 associées à un profil. Cette propriété a été renommée , EnhancedSecurityModeStatepour communiquer plus clairement l’état du mode de sécurité renforcée.
Avant cette modification : La CoreWebView2Profile.EnhancedSecurityModeLevel propriété utilisait l’énumération avec des CoreWebView2EnhancedSecurityModeLevel valeurs Off et Strict.
Après cette modification : La CoreWebView2Profile.EnhancedSecurityModeState propriété utilise l’énumération avec des CoreWebView2EnhancedSecurityModeState valeurs Disabled et Enabled:
CoreWebView2EnhancedSecurityModeState.Disabled— Le mode sécurité renforcée est désactivé.- Remplace
CoreWebView2EnhancedSecurityModeLevel.Off.
- Remplace
CoreWebView2EnhancedSecurityModeState.Enabled— Le mode sécurité renforcée est activé.- Désactive la compilation JavaScript juste-à-temps (JIT).
- Active des protections supplémentaires du système d’exploitation.
- Remplace
CoreWebView2EnhancedSecurityModeLevel.Strict.
Voir aussi :
- État du mode de sécurité renforcée, ci-dessous.
-
[Changement de dernière minute]
EnhancedSecurityModeLevelremplacé parEnhancedSecurityModeState(Problème #132)
API expérimentales (phase 1 : expérimental en préversion)
Les API suivantes sont en phase 1 : expérimentales en version préliminaire et ont été ajoutées dans ce kit de développement logiciel (SDK) en version préliminaire.
État du mode de sécurité renforcée
La EnhancedSecurityModeState propriété activée CoreWebView2Profile détermine si le mode de sécurité renforcée (ESM) est activé ou désactivé pour toutes les instances WebView2 associées à un profil.
Lorsqu’il est activé, le mode de sécurité renforcée désactive la compilation JavaScript juste-à-temps (JIT) et active des protections supplémentaires du système d’exploitation, réduisant la surface d’attaque, au détriment de certaines performances JavaScript.
La valeur par défaut est Disabled. Les changements s’appliquent immédiatement aux nouvelles navigations ; Les pages existantes doivent être rechargées.
Ce paramètre n’est pas conservé et se réinitialise lorsque le profil est détruit et recréé.
CoreWebView2EnhancedSecurityModeState Enum
DisabledEnabled
CoreWebView2ProfileClasse
Promotions à la phase 2 (stable en préversion)
Les API suivantes sont passées de la phase 1 : expérimentale en version préliminaire à la phase 2 : stable en version préliminaire, et sont incluses dans ce kit de développement logiciel (SDK) en version préliminaire.
Activer le traitement en arrière-plan et la prise en charge hors connexion (API de travail WebView2)
Les API de travail WebView2 permettent aux applications hôtes d’interagir avec les travailleurs web pour décharger des tâches du thread principal, améliorer la réactivité et prendre en charge les opérations en arrière-plan. Ces travailleurs web incluent des travailleurs dédiés, des travailleurs partagés et des travailleurs de service.
Ces API fournissent :
- Événements du cycle de vie : Surveiller la création et la destruction de travailleurs.
-
Interfaces de messagerie : Communiquer avec les travailleurs à l’aide de
PostMessageetWebMessageReceived; plus précisément :CoreWebView2ServiceWorker.PostWebMessageAsJsonCoreWebView2ServiceWorker.PostWebMessageAsStringCoreWebView2DedicatedWorker.PostWebMessageAsJsonCoreWebView2DedicatedWorker.PostWebMessageAsStringCoreWebView2ServiceWorker.WebMessageReceivedCoreWebView2DedicatedWorker.WebMessageReceivedchrome.webview.postMessage- Pas :
chrome.webview.postMessageWithAdditionalObjects
- Gestion des employés : Interroger et récupérer les inscriptions et instances de travail.
-
CoreWebView2Classe :
-
Classe CoreWebView2DedicatedWorker
- CoreWebView2DedicatedWorker.DedicatedWorkerCreated Event
- CoreWebView2DedicatedWorker.Destroying Event
- CoreWebView2DedicatedWorker.PostWebMessageAsJson méthode
- CoreWebView2DedicatedWorker.PostWebMessageAsString Method
- Propriété CoreWebView2DedicatedWorker.ScriptUri
- Événement CoreWebView2DedicatedWorker.WebMessageReceived
-
CoreWebView2FrameClasse :
-
CoreWebView2ProfileClasse :
-
Classe CoreWebView2ServiceWorkerRegistration
- Propriété CoreWebView2ServiceWorkerRegistration.ActiveServiceWorker
- Propriété CoreWebView2ServiceWorkerRegistration.Origin
- Propriété CoreWebView2ServiceWorkerRegistration.ScopeUri
- CoreWebView2ServiceWorkerRegistration.ServiceWorkerActivated Event
- Propriété CoreWebView2ServiceWorkerRegistration.TopLevelOrigin
- Événement CoreWebView2ServiceWorkerRegistration.Unregistration Event
Correctifs de bogues
Ce Kit de développement logiciel (SDK) de version préliminaire contient les correctifs de bogues suivants.
Runtime uniquement
- Correction du caractère double dans UWP.
- Correction de l’API de paramètre de couleur d’arrière-plan
Caption controls. Après cette modification, pour fermer votre application, l’application doit également intercepter l’appelCloseet gérer l’appel elle-même. - Correction du transfert des événements réseau pour les iframes, où l’iframe avait sa propre session CDP isolée.
- Amélioration de la gestion des erreurs lors de l’appel d’un Worker du service après un message (par exemple ou
CoreWebView2ServiceWorker.PostWebMessageAsJsonchrome.webview.postMessage). - Réduction des allocations de chaînes dans .
GetDefaultHostAppExeName - Correction d’un problème de mise à jour où le runtime WebView2 actuellement utilisé est supprimé après l’installation d’une nouvelle version, provoquant un blocage lors de la création d’une nouvelle manette dans une application déjà en cours d’exécution.
Publier le SDK 1.0.3967.48, pour le runtime 148 (11 mai 2026)
Date de publication : 11 mai 2026
Package NuGet pour WebView2 SDK 1.0.3967.48
Pour une compatibilité totale avec l’API, cette version du SDK WebView2 nécessite la version 148.0.3967.48 du runtime WebView2 ou une version ultérieure.
Promotions à la phase 3 (stable dans la publication)
Aucune API supplémentaire n’a été promue de la phase 2 : stable en version préliminaire à la phase 3 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) de version.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) inclut les correctifs de bogues suivants.
Runtime uniquement
- Correction d’un problème de mise à jour où le runtime WebView2 actuellement utilisé est supprimé après l’installation d’une nouvelle version, provoquant un blocage lors de la création d’une nouvelle manette dans une application déjà en cours d’exécution.
Kit de développement logiciel (SDK) de version préliminaire 1.0.3965-version préliminaire, pour le runtime 148 (13 avril 2026)
Date de publication : 13 avril 2026
Package NuGet pour WebView2 SDK 1.0.3965-prerelease
Pour une compatibilité d’API complète, cette version préliminaire du SDK WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 148.0.3965.0 ou ultérieure.
Changements cassants
Raisons granulaires de l’échec du processus pour l’événement ProcessFailed
L’événement ProcessFailed se déclenche lorsqu’un processus associé à WebView2 (tel qu’un processus de rendu ou GPU) se ferme de manière inattendue, ce qui permet aux applications de répondre avec une logique de récupération ou des diagnostics.
Avant cette modification : la CoreWebView2ProcessFailedEventArgs.Reason propriété a été renvoyée Unexpected pour trois scénarios de sortie distincts (sortie normale, sortie anormale et échec de l’intégrité du code), ce qui rend impossible pour les applications de les distinguer.
Après ce changement : Lorsque l’indicateur msWebView2GranularProcessFailedReason de fonctionnalité est activé, la CoreWebView2ProcessFailedEventArgs.Reason propriété renvoie les nouvelles valeurs d’énumération granulaires CoreWebView2ProcessFailedReason suivantes, au lieu de Unexpected:
NormalExit— Le processus s’est arrêté normalement (code de sortie 0).AbnormalExit— Le processus s’est arrêté anormalement (code de sortie non nul), mais n’a pas planté ou été tué.IntegrityFailure— Le système d’exploitation a mis fin au processus en raison d’un échec d’intégrité du code, par exemple lorsqu’une DLL échoue à la vérification de l’intégrité du code Windows.
L’indicateur msWebView2GranularProcessFailedReason de fonctionnalité est désactivé par défaut dans les versions 148 et 149, ce qui donne aux applications deux versions à tester de manière proactive. À partir de la version 150, la fonctionnalité sera activée par défaut et les applications recevront les valeurs granulaires. Pour valider le comportement de votre application WebView2, activez l’indicateur de fonctionnalité comme suit :
set WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--enable-features=msWebView2GranularProcessFailedReason
Il s’agit d’un correctif pour le runtime et le kit de développement logiciel (SDK). Ces membres d’énumération sont une modification d’une API stable existante et sont disponibles dans le cadre de cette version préliminaire du Kit de développement logiciel (SDK).
Voir aussi :
CoreWebView2ProcessFailedEventArgsClasseCoreWebView2ProcessFailedReason Enum
AbnormalExitIntegrityFailureNormalExit
API expérimentales (phase 1 : expérimental en préversion)
Les API suivantes sont en phase 1 : expérimentales en version préliminaire et ont été ajoutées dans ce kit de développement logiciel (SDK) en version préliminaire.
API de configuration d’origine pour WebView2
L’API de configuration d’origine permet aux applications WebView2 d’appliquer différentes politiques de fonctionnalité et de sécurité en fonction de l’origine du contenu hébergé. Par défaut, WebView2 applique une politique uniforme sur toutes les origines. Cette API permet aux applications d’activer ou de désactiver de manière sélective des fonctionnalités spécifiques (comme le mode de sécurité renforcée) pour des origines ou des modèles d’origine individuels.
Utilisez la méthode utilisée CoreWebView2Profile pour configurer les SetOriginFeatures paramètres de fonctionnalité pour une ou plusieurs origines. Les origines peuvent être spécifiées sous forme de chaînes exactes (telles que https://contoso.com) ou de modèles génériques (tels que https://[*.]contoso.com) pour correspondre à des sous-domaines, des protocoles ou des ports.
Lorsque plusieurs configurations s’appliquent à la même origine, le modèle le plus spécifique est prioritaire, évalué par nom d’hôte, puis schéma, puis port.
Permet GetEffectiveFeaturesForOrigin de récupérer de façon asynchrone les paramètres de la fonction calculée pour une origine donnée.
-
CoreWebView2OriginFeature Enum
EnhancedSecurityMode
-
CoreWebView2OriginFeatureState Enum
DisabledEnabled
CoreWebView2Profile Class
Phase 2 (stable dans la version préliminaire)
Les membres d’énumération suivants sont une modification d’une API stable existante et sont disponibles dans le cadre de cette version préliminaire du Kit de développement logiciel (SDK).
Raisons granulaires de l’échec du processus pour l’événement ProcessFailed
Nous avons complété le CoreWebView2ProcessFailedReason.Unexpected membre d’énumération en ajoutant des valeurs plus granulaires, pour l’énumération CoreWebView2ProcessFailedReason renvoyée par la CoreWebView2ProcessFailedEventArgs.Reason propriété.
C’est un changement de rupture ; voir Raisons granulaires de l’échec du processus pour l’événementProcessFailed, ci-dessus.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) de version préliminaire contient les correctifs de bogues suivants.
Runtime et SDK
- Nous avons complété le
CoreWebView2ProcessFailedReason.Unexpectedmembre d’énumération en ajoutant des valeurs plus granulaires, pour l’énumérationCoreWebView2ProcessFailedReasonrenvoyée par laCoreWebView2ProcessFailedEventArgs.Reasonpropriété. C’est un changement de rupture. Voir Raisons granulaires de l’échec du processus pour l’événementProcessFailed, ci-dessus.
Runtime uniquement
Correction des problèmes de sélection de la liste déroulante de la boîte de dialogue Imprimer dans
WebView2CompositionControl. (Numéro #5195)Désactivation du composant Actions de domaine pour WebView2.
Notification désactivée
WebUSBDetectorpour WebView2.Corrigé obsolète
ICoreWebView2Profile3::get_PreferredTrackingPreventionLevel.Correction de l’incapacité des clients WDP à se connecter à un serveur de débogage distant.
Correction d’un problème pour l’exemple d’application WPF, où la fermeture de la fenêtre laissait un processus WPF en attente.
Kit de développement logiciel (SDK) uniquement
- Activation de la journalisation des histogrammes pour les plantages du processus de navigateur dans WebView2.
Libérer le SDK 1.0.3912.50 pour le runtime 147 (13 avril 2026)
Date de publication : 13 avril 2026
Package NuGet pour WebView2 SDK 1.0.3912.50
Pour une compatibilité complète de l’API, cette version du SDK WebView2 nécessite la version 147.0.3912.50 du runtime WebView2 ou une version ultérieure.
Promotions à la phase 3 (stable dans la publication)
Aucune API supplémentaire n’a été promue de la phase 2 : stable en version préliminaire à la phase 3 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) de version.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) inclut les correctifs de bogues suivants.
Runtime uniquement
Désactivation du composant Actions de domaine pour WebView2.
Correction de l’incapacité des clients WDP à se connecter à un serveur de débogage distant.
Kit de développement logiciel (SDK) de version préliminaire 1.0.3908-version préliminaire, pour le runtime 147 (16 mars 2026)
Date de publication : 16 mars 2026
Package NuGet pour WebView2 SDK 1.0.3908-prerelease
Pour une compatibilité totale avec l’API, cette version préliminaire du SDK WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 147.0.3908.0 ou ultérieure.
API expérimentales (phase 1 : expérimental en préversion)
Aucune API expérimentale n’a été ajoutée dans ce Kit de développement logiciel (SDK) de la version préliminaire.
Promotions à la phase 2 (stable en préversion)
Les API suivantes ont ignoré la phase 1 : Expérimental dans la version préliminaire et ont été directement ajoutées à la phase 2 : Stable dans la version préliminaire et sont incluses dans ce kit de développement logiciel (SDK) en version préliminaire.
Gérer les autorisations de stockage persistantes pour le contenu web
L’autorisation PersistentStorage permet à une application WebView2 de traiter les demandes de contenu web vers des données persistantes créées par les API de stockage, les travailleurs du service et les technologies associées. L’autorisation PersistentStorage est un membre enum dans l’énumération CoreWebView2PermissionKind .
Lorsque cette autorisation est accordée, le navigateur n’expulse pas les données stockées dans les scénarios de faible espace disque. Cela garantit un comportement hors connexion et de mise en cache fiable pour le site.
-
CoreWebView2PermissionKind Enum
PersistentStorage
Correctifs de bogues
Ce Kit de développement logiciel (SDK) de version préliminaire contient les correctifs de bogues suivants.
Runtime uniquement
- Correction d’un bogue à cause duquel la déconnexion d’un écran ne modifiait pas correctement la résolution de l’écran.
- Correction de la résolution par moniteur dans
window.getScreenDetails(). (Problème #4826) - Désactivation du composant d’actions de domaine pour WebView2.
- Correction de l’échec de l’API Imprimer au format PDF lors de l’impression de fichiers PDF. (Numéro #5499)
- Correction d’un problème qui faisait que le Narrateur annonçait le structurel
HWND, qui n’a pas d’interface utilisateur. - Correction de la transparence de WebView2.
- Correction de l’API pour définir la couleur d’arrière-plan du contrôle Légende .
Libérer le SDK 1.0.3856.49, pour le runtime 146 (16 mars 2026)
Date de publication : 16 mars 2026
Package NuGet pour WebView2 SDK 1.0.3856.49
Pour une compatibilité complète de l’API, cette version du SDK WebView2 nécessite la version 146.0.3856.49 ou ultérieure de WebView2 Runtime.
Promotions à la phase 3 (stable dans la publication)
Aucune API supplémentaire n’a été promue de la phase 2 : stable en version préliminaire à la phase 3 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) de version.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) inclut les correctifs de bogues suivants.
Runtime uniquement
- Correction de l’échec de l’API Imprimer au format PDF lors de l’impression de fichiers PDF. (Numéro #5499)
Kit de développement logiciel (SDK) de version préliminaire 1.0.3848-version préliminaire, pour le runtime 146 (16 février 2026)
Date de publication : 16 février 2026
Package NuGet pour WebView2 SDK 1.0.3848-prerelease
Pour une compatibilité d’API complète, cette version préliminaire du SDK WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 146.0.3848.0 ou ultérieure.
Changements cassants
Activer les API JavaScript spécifiques à WebView2 pour les travailleurs du service
Le nouveau AreWebViewScriptApisEnabledForServiceWorkers paramètre fournit un moyen explicite et fiable de contrôler la disponibilité des API JavaScript spécifiques à WebView2 (chrome.webview) dans les scripts de worker du service.
Ce paramètre est désactivé par défaut pour les applications WebView2. Les applications qui n’activent pas explicitement ce paramètre n’auront pas accès aux API JavaScript spécifiques à WebView2 dans les scripts de worker du service. Par conséquent, la communication basée sur chrome.webview.postMessage le worker du service avec l’application hôte WebView2 ne fonctionnera que si le paramètre est activé.
À l’avenir, WebView2 s’appuiera sur le AreWebViewScriptApisEnabledForServiceWorkers paramètre comme mécanisme faisant autorité pour activer les API JavaScript spécifiques à WebView2 dans les scripts de worker de service. Cela garantit un comportement prévisible, sécurisé et déterministe.
Vous pouvez valider de manière proactive le comportement de votre application WebView2 en activant l’exposition de l’API JavaScript du worker du service dans votre application WebView2. Pour ce faire, configurez votre application pour activer le paramètre suivant :
AreWebViewScriptApisEnabledForServiceWorkers = true
En testant votre application WebView2 avec ce paramètre activé, vous pouvez identifier tous les flux de travail qui dépendent des API de worker du service spécifiques à WebView2, telles que chrome.webview.postMessage la communication entre les travailleurs du service et l’application hôte.
Actuellement, les objets et chrome.webview sont disponibles pour les chrome scripts de worker du service lors de l’utilisation de l’événementServiceWorkerRegistered. Toutefois, à partir de la prochaine version, le AreWebViewScriptApisEnabledForServiceWorkers paramètre sera le seul mécanisme qui détermine si ces objets sont exposés aux scripts de worker du service. Veuillez tester ce paramètre avant la prochaine publication et signaler tout problème que vous rencontrez. Pour plus de détails, consultez [Changement cassant] Activation des API JavaScript spécifiques à WebView2 pour les travailleurs du service.
Voir aussi Contrôler si les API de script WebView sont activées pour les travailleurs du service, ci-dessous.
CoreWebView2ProfileClasseCoreWebView2ServiceWorkerManagerClasse :WebView dans la référence JavaScript.
chrome.webview.postMessagedans la référence JavaScript.
Accès au réseau local (LNA) dans WebView2
Le moteur de navigateur Chromium a introduit l’accès au réseau local (LNA). LNA est une fonctionnalité de sécurité qui empêche les pages web d’effectuer des demandes vers des ressources de réseau privé ou local, sauf si la page web dispose d’une autorisation explicite pour accéder aux ressources du réseau privé ou local. Des exemples de ces ressources sont localhost, 192.168.*, ou 10.*.
LNA est actuellement désactivé par défaut pour les applications WebView2, mais vous pouvez activer la prise en charge de LNA via l’indicateur msWebViewAllowLocalNetworkAccessChecks . Pour les applications WebView2, aucune action n’est requise pour le moment. Pour plus d’informations sur l’indicateur, consultez Indicateurs de navigateur WebView2 disponibles dans Indicateurs de navigateur WebView2.
Une fois l’amont, la base de code de Chromium stabilisée, nous prévoyons d’ajouter des valeurs d’énumération supplémentaires dans l’énumérationCoreWebView2PermissionKind, pour prendre en charge LNA via la SetPermissionState méthode. Ces nouvelles valeurs d’énumération seront utilisées par l’événement UWP WebView.PermissionRequested pour donner à votre application WebView2 un contrôle explicite sur la fonctionnalité d’accès au réseau local (LNA).
CoreWebView2ProfileClasse :
Vous pouvez tester de manière proactive la fonctionnalité d’accès au réseau local (LNA) dans votre application WebView2. Pour tester votre application avec la fonctionnalité LNA, lancez votre application WebView2 avec l’indicateur suivant :
--enable-features=LocalNetworkAccessChecks,msWebViewAllowLocalNetworkAccessChecks
En testant votre application lorsqu’elle est lancée avec cet indicateur, vous pouvez ensuite identifier les workflows susceptibles d’être affectés par la fonctionnalité LNA.
Une fois la fonctionnalité LNA stabilisée, nous partagerons une chronologie mise à jour pour l’activation de la fonctionnalité LNA. Pour plus de détails, consultez [Changement cassant] Accès au réseau local (LNA) dans WebView2 - Plan de déploiement.
API expérimentales (phase 1 : expérimental en préversion)
Les API suivantes sont en phase 1 : expérimentales en version préliminaire et ont été ajoutées dans ce kit de développement logiciel (SDK) en version préliminaire.
Contrôler si les API de script WebView sont activées pour les workers du service
Utilisez la AreWebViewScriptApisEnabledForServiceWorkers propriété on CoreWebView2Profile pour contrôler si les API de script WebView sont activées pour les travailleurs du service.
Voir aussi Activer les API JavaScript spécifiques à WebView2 pour les travailleurs du service, ci-dessus.
-
CoreWebView2ProfileClasse
Promotions à la phase 2 (stable en préversion)
Aucune API n’a été promue de la phase 1 : expérimentale en version préliminaire à la phase 2 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) en version préliminaire.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) de version préliminaire contient les correctifs de bogues suivants.
Runtime uniquement
Correction de la disparition de la barre d’outils PDF lorsque toutes les options d’une région sont supprimées. (Numéro #4738)
Correction d’un clignotement blanc qui se produisait lorsque Windows Search devenait visible après avoir été masqué.
Correction de l’ombre de la barre de titre afin qu’elle ne soit pas affichée dans un contrôle WebView2 transparent. (Numéro #5492)
Correction de la transparence de WebView2.
Correction d’un problème d’invite d’accès au réseau local (LNA) en désactivant les vérifications LNA dans WebView2.
Publier le SDK 1.0.3800.47 pour Runtime 145 (16 février 2026)
Date de publication : 16 février 2026
Package NuGet pour WebView2 SDK 1.0.3800.47
Pour une compatibilité totale avec l’API, cette version du SDK WebView2 nécessite la version 145.0.3800.47 du runtime WebView2 ou une version ultérieure.
Promotions à la phase 3 (stable dans la publication)
Aucune API supplémentaire n’a été promue de la phase 2 : stable en version préliminaire à la phase 3 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) de version.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) inclut les correctifs de bogues suivants.
Runtime uniquement
Correction de l’ombre de la barre de titre afin qu’elle ne soit pas affichée dans un contrôle WebView2 transparent. (Numéro #5492)
Correction d’un problème d’invite d’accès au réseau local (LNA) en désactivant les vérifications LNA dans WebView2.
Correction de la transparence de WebView2.
Kit de développement logiciel (SDK) de version préliminaire 1.0.3796-version préliminaire, pour Runtime 145 (19 janvier 2026)
Date de publication : 19 janvier 2026
Package NuGet pour WebView2 SDK 1.0.3796-prerelease
Pour une compatibilité d’API complète, cette version préliminaire du SDK WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 145.0.3796.0 ou ultérieure.
API expérimentales (phase 1 : expérimental en préversion)
Les API suivantes sont en phase 1 : expérimentales en version préliminaire et ont été ajoutées dans ce kit de développement logiciel (SDK) en version préliminaire.
Niveau de mode de sécurité renforcée
L’API de niveau de mode de sécurité renforcée permet de configurer le mode de sécurité renforcée (ESM) pour les instances WebView2. ESM réduit le risque de vulnérabilités liées à la mémoire en désactivant la compilation JavaScript juste-à-temps (JIT) et en activant des protections supplémentaires du système d’exploitation.
Pour contrôler le niveau ESM pour toutes les instances WebView2 qui partagent le même profil, utilisez la EnhancedSecurityModeLevel propriété sur CoreWebView2Profile (ou ICoreWebView2ExperimentalProfile9) :
Utilisez la valeur pour désactiver complètement le
Offmode de sécurité renforcée (comportement par défaut).Utilisez la valeur pour activer une
Strictsécurité renforcée pour tous les sites. Cela désactive la compilation JIT et applique des protections supplémentaires au niveau du système d’exploitation, ce qui améliore la sécurité mais réduit potentiellement les performances de JavaScript.
CoreWebView2EnhancedSecurityModeLevel Enum
CoreWebView2EnhancedSecurityModeLevel.OffCoreWebView2EnhancedSecurityModeLevel.Strict
CoreWebView2ProfileClasse :
Promotions à la phase 2 (stable en préversion)
Aucune API n’a été promue de la phase 1 : expérimentale en version préliminaire à la phase 2 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) en version préliminaire.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) de version préliminaire contient les correctifs de bogues suivants.
Runtime uniquement
- Correction de
chrome.webviewl’indisponibilité. - Désactivation de la mise à jour de l’heure réseau en arrière-plan.
Kit de développement logiciel (SDK) uniquement
- Ajout de l’article Meilleures pratiques en matière de performances pour les applications WebView2, sur la façon d’améliorer la vitesse de démarrage, l’utilisation de la mémoire et la réactivité d’une application WebView2.
Libérer le SDK 1.0.3719.77, pour le runtime 144 (27 janvier 2026)
Date de publication : 27 janvier 2026
Package NuGet pour WebView2 SDK 1.0.3719.77
Pour une compatibilité totale de l’API, cette version du SDK WebView2 nécessite la version 144.0.3719.77 du runtime WebView2 ou une version ultérieure.
Promotions à la phase 3 (stable dans la publication)
Les API suivantes ont été promues de la phase 2 : stable en version préliminaire à la phase 3 : stable en version et sont désormais incluses dans ce kit de développement logiciel (SDK) de publication.
Personnaliser le comportement glisser-déplacer (API DragBeginning)
L’API DragStarting remplace le comportement de 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 WebView2 et fournit l’état nécessaire pour remplacer l’opération de glissement WebView2 par défaut avec votre propre logique.
- Utilisez
DragStartingsur pourICoreWebView2CompositionController5ajouter un gestionnaire d’événements appelé au démarrage de l’opération de glisser-déplacer. - Utilisez-la
ICoreWebView2DragStartingEventArgspour démarrer votre propre opération de glisser-déplacer.- Utilisez la méthode pour exécuter une
GetDeferrallogique de glissement asynchrone et rappeler dans le WebView ultérieurement. - Utilisez la
Handledpropriété pour que WebView2 sache s’il faut utiliser sa propre logique de glissement.
- Utilisez la méthode pour exécuter une
Correctifs de bogues
Ce Kit de développement logiciel (SDK) inclut les correctifs de bogues suivants.
Runtime uniquement
- Correction de
chrome.webviewl’indisponibilité.
Kit de développement logiciel (SDK) uniquement
- Ajout de l’article Meilleures pratiques en matière de performances pour les applications WebView2, sur la façon d’améliorer la vitesse de démarrage, l’utilisation de la mémoire et la réactivité d’une application WebView2.
Kit de développement logiciel (SDK) de version préliminaire 1.0.3712-version préliminaire, pour le runtime 144 (8 décembre 2025)
Date de publication : 8 décembre 2025
Package NuGet pour WebView2 SDK 1.0.3712-prerelease
Pour une compatibilité complète avec l’API, cette version préliminaire du SDK WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 144.0.3712.0 ou ultérieure.
API expérimentales (phase 1 : expérimental en préversion)
Les API suivantes sont en phase 1 : expérimentales en version préliminaire et ont été ajoutées dans ce kit de développement logiciel (SDK) en version préliminaire.
Personnaliser le comportement de plage de ports
Les API de 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 de transport et étendues. Cela fournit un contrôle de sécurité amélioré.
S’utilise
SetAllowedPortRangesur l’instance (ouICoreWebView2ExperimentalEnvironmentOptions) pour configurer les restrictions de port lors de la création de l’environnementCoreWebView2EnvironmentOptions.Utilisez le
scopeparamètre pour spécifier si la configuration s’applique à tous les composants (Default) ou uniquement aux connexions peer-to-peer WebRTC (WebRtc). Actuellement, seuleWebRtcest prise en charge.Utilisez le
protocolparamètre pour spécifier le protocole de transport (prend actuellement en chargeUdp).Spécifiez
minPortetmaxPortdes valeurs comprises entre 1025 et 65535 (inclus), ou utilisez (0,0) pour réinitialiser/supprimer des restrictions.
Utilisez-la
GetEffectiveAllowedPortRangesur l’instanceCoreWebView2EnvironmentOptions(ouICoreWebView2ExperimentalEnvironmentOptions) pour récupérer la configuration de la plage de ports actifs pour une étendue et un protocole spécifiques.Retourne la plage définie explicitement pour l’étendue donnée, ou hérite de l’étendue
Defaultsi elle n’est pas définie.Renvoie (0,0) si aucune restriction n’est configurée pour l’étendue spécifiée.
CoreWebView2EnvironmentOptionsClasseCoreWebView2AllowedPortRangeScope Enum
CoreWebView2AllowedPortRangeScope.DefaultCoreWebView2AllowedPortRangeScope.WebRtc
CoreWebView2TransportProtocolKind Enum
CoreWebView2TransportProtocolKind.Udp
Promotions à la phase 2 (stable en préversion)
Les API suivantes sont passées de la phase 1 : expérimentale en version préliminaire à la phase 2 : stable en version préliminaire, et sont incluses dans ce kit de développement logiciel (SDK) en version préliminaire.
Personnaliser le comportement glisser-déplacer (API DragBeginning)
L’API DragStarting remplace le comportement de 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 WebView2 et fournit l’état nécessaire pour remplacer l’opération de glissement WebView2 par défaut avec votre propre logique.
- Utilisez
DragStartingsur pourICoreWebView2CompositionController5ajouter un gestionnaire d’événements appelé au démarrage de l’opération de glisser-déplacer. - Utilisez-la
ICoreWebView2DragStartingEventArgspour démarrer votre propre opération de glisser-déplacer.- Utilisez la méthode pour exécuter une
GetDeferrallogique de glissement asynchrone et rappeler dans le WebView ultérieurement. - Utilisez la
Handledpropriété pour que WebView2 sache s’il faut utiliser sa propre logique de glissement.
- Utilisez la méthode pour exécuter une
Correctifs de bogues
Ce Kit de développement logiciel (SDK) de version préliminaire contient 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
ICoreWebView2NewWindowRequestedEventArgsle commutateurenable-new-window-requested-deferred-initializationde ligne de commande .
Libérer le SDK 1.0.3650.58, pour le runtime 143 (8 décembre 2025)
Date de publication : 8 décembre 2025
Package NuGet pour WebView2 SDK 1.0.3650.58
Pour une compatibilité totale de l’API, cette version du SDK WebView2 nécessite la version 143.0.3650.58 de WebView2 Runtime ou une version ultérieure.
Promotions à la phase 3 (stable dans la publication)
Aucune API supplémentaire n’a été promue de la phase 2 : stable en version préliminaire à la phase 3 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) de version.
Correctifs de bogues
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) version préliminaire 1.0.3650-version préliminaire, pour l’exécution 143 (7 novembre 2025)
Date de publication : 7 novembre 2025
Package NuGet pour WebView2 SDK 1.0.3650-prerelease
Pour une compatibilité d’API complète, cette version préliminaire du SDK WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 143.0.3650.0 ou ultérieure.
API expérimentales (phase 1 : expérimental en préversion)
Aucune API expérimentale n’a été ajoutée dans ce Kit de développement logiciel (SDK) de la version préliminaire.
Promotions à la phase 2 (stable en préversion)
Aucune API n’a été promue de la phase 1 : expérimentale en version préliminaire à la phase 2 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) en version préliminaire.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) de version préliminaire contient les correctifs de bogues suivants.
Runtime uniquement
- Désactivation de la création d’un processus de « convertisseur spéculatif ».
- Correction d’un problème de synchronisation de la boîte de dialogue Rechercher lors d’une recherche par programmation.
Publication du SDK 1.0.3595.46, pour le runtime 142 (3 novembre 2025)
Date de publication : 3 novembre 2025
Package NuGet pour le SDK WebView2 1.0.3595.46
Pour une compatibilité complète de l’API, cette version du SDK WebView2 nécessite la version 142.0.3595.46 de WebView2 Runtime ou une version ultérieure.
Promotions à la phase 3 (stable dans la publication)
Aucune API supplémentaire n’a été promue de la phase 2 : stable en version préliminaire à la phase 3 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) de version.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) inclut les correctifs de bogues suivants.
Runtime uniquement
- Désactivation de la création d’un processus de « convertisseur spéculatif ».
Kit de développement logiciel (SDK) de version préliminaire 1.0.3590-version préliminaire, pour Runtime 142 (7 octobre 2025)
Date de publication : 7 octobre 2025
Package NuGet pour WebView2 SDK 1.0.3590-prerelease
Pour une compatibilité complète avec l’API, cette version préliminaire du SDK WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 142.0.3590.0 ou ultérieure.
API expérimentales (phase 1 : expérimental en préversion)
Les API suivantes sont en phase 1 : expérimentales en version préliminaire et ont été ajoutées dans ce kit de développement logiciel (SDK) en version préliminaire.
Prise en charge des étiquettes de confidentialité
Une nouvelle API d’informations de confidentialité dans WebView2 permet aux applications d’accéder aux informations des étiquettes de confidentialité communiquées par les pages Web via le Gestionnaire de restrictions 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 restrictions d’interaction de page - Configurez une liste de filtres d’URL pour le gestionnaire de restrictions d’interaction de page. Une fois la liste configurée, le gestionnaire de restrictions 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 -
CoreWebView2des informations de confidentialité Expose désormais uneSensitivityInfopropriété et unSensitivityInfoChangedévénement, ce qui permet aux applications d’écouter les mises à jour des informations sur les étiquettes de confidentialité.
La prise en charge des étiquettes de confidentialité est initialement disponible uniquement sur Win32. La prise en charge de .NET et de WinRT est prévue pour une prochaine version.
Promotions à la phase 2 (stable en préversion)
Aucune API n’a été promue de la phase 1 : expérimentale en version préliminaire à la phase 2 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) en version préliminaire.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) de version préliminaire contient les correctifs de bogues suivants.
Runtime uniquement
- Correction d’un pointeur suspendu dans le contexte des autorisations d’accès au système de fichiers.
- Correction du blocage de l’interface utilisateur lors du glisser-déposer 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 le cadre de navigateur par défaut ne fonctionnaient pas.
Kit de développement logiciel (SDK) uniquement
- Correction d’une erreur BinSkim pour
WebView2Loader.dll.
Libérer le SDK 1.0.3537.50, pour le runtime 141 (6 octobre 2025)
Date de publication : 6 octobre 2025
Package NuGet pour WebView2 SDK 1.0.3537.50
Pour une compatibilité complète de l’API, cette version du SDK WebView2 nécessite la version 141.0.3537.50 du runtime WebView2 ou une version ultérieure.
Promotions à la phase 3 (stable dans la publication)
Aucune API supplémentaire n’a été promue de la phase 2 : stable en version préliminaire à la phase 3 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) de version.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) 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.
Kit de développement logiciel (SDK) version préliminaire 1.0.3530-version préliminaire, pour Runtime 141 (8 septembre 2025)
Date de publication : 8 septembre 2025
Package NuGet pour WebView2 SDK 1.0.3530-prerelease
Pour une compatibilité d’API complète, cette version préliminaire du SDK WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 141.0.3530.0 ou ultérieure.
Modifications générales
Ce 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 garantir que les API fonctionnent de manière fiable dans différents scénarios.
Ces améliorations fondamentales fournissent des fonctionnalités stables et soigneusement testées pour la création d’applications WebView2.
API expérimentales (phase 1 : expérimental en préversion)
Aucune API expérimentale n’a été ajoutée dans ce Kit de développement logiciel (SDK) de la version préliminaire.
Promotions à la phase 2 (stable en préversion)
Aucune API n’a été promue de la phase 1 : expérimentale en version préliminaire à la phase 2 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) en version préliminaire.
Correctifs de bogues
Ce Kit de développement logiciel (SDK) de version préliminaire contient 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.
Publication du SDK 1.0.3485.44, pour Runtime 140 (8 septembre 2025)
Date de publication : 8 septembre 2025
Package NuGet pour WebView2 SDK 1.0.3485.44
Pour une compatibilité totale de l’API, cette version du SDK WebView2 nécessite la version 140.0.3485.44 du runtime WebView2 ou une version ultérieure.
Modifications générales
Ce SDK de 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 garantir que les API fonctionnent de manière fiable dans différents scénarios.
Ces améliorations fondamentales fournissent des fonctionnalités stables et soigneusement testées pour la création d’applications WebView2.
Promotions à la phase 3 (stable dans la publication)
Aucune API supplémentaire n’a été promue de la phase 2 : stable en version préliminaire à la phase 3 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) de version.
Correctifs de bogues
Il n’existe aucun correctif de bogue dans ce SDK de version.
Kit de développement logiciel (SDK) de version préliminaire 1.0.3477-version préliminaire, pour Runtime 140 (11 août 2025)
Date de publication : 11 août 2025
Package NuGet pour WebView2 SDK 1.0.3477-prerelease
Pour une compatibilité complète de l’API, cette version préliminaire du SDK WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 140.0.3477.0 ou ultérieure.
API expérimentales (phase 1 : expérimental en préversion)
Aucune API expérimentale n’a été ajoutée dans ce Kit de développement logiciel (SDK) de la version préliminaire.
Promotions à la phase 2 (stable en préversion)
Aucune API n’a été promue de la phase 1 : expérimentale en version préliminaire à la phase 2 : stable en version préliminaire, dans ce kit de développement logiciel (SDK) en version préliminaire.
Correctifs de bogues
Runtime uniquement
- Corrigé
put_UserAgentne fonctionnant pas pour les workers du service. - Correction d’un incident dans DevTools sur Windows Server et Windows 10.
- Suppression du suivi du processus du 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 appui prolongé.
Voir également
- Notes de publication archivées pour le SDK WebView2
- À propos des notes de publication pour le SDK WebView2
- Vue d’ensemble des API WebView2 : décrit de nombreuses API, par domaine de fonctionnalité, qui se trouvent dans les packages du Kit de développement logiciel (SDK) de publication.
- Contact de l’équipe Microsoft Edge WebView2
- Notes de publication pour la plateforme web Microsoft Edge
Informations de référence sur l’API :