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 correctifs de bogues suivants se trouvent dans le Kit de développement logiciel (SDK) De version WebView2 et le Kit de développement logiciel (SDK) de préversion.
Prerelease SDK 1.0.4181-prerelease, for Runtime 152 (3 août 2026)
Date de publication : 3 août 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.4181-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 152.0.4181.0 ou ultérieure.
API expérimentales (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.
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 via un seul DiagnosticReceived événement.
L’événement est destiné à l’analyse hors connexion ou au transfert de données 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 choisi par catégorie en appelant SetDiagnosticFilter avec une catégorie de diagnostic (telle que NetworkRequest) et une chaîne de filtre JSON.
Le passage "{}" à 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 filtrer les demandes réseau) à des valeurs ou httpMethod spécifiqueserrorCode.
L’appel SetDiagnosticFilter à nouveau pour la même catégorie remplace le filtre précédent.
Chaque DiagnosticReceived événement expose la charge utile , Scope, Timestampet dont DetailsAsJson 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 champs peuvent être expédiés sans rompre le contrat d’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.
Énumération CoreWebView2DiagnosticCategory
NetworkRequest
Énumération CoreWebView2DiagnosticScope
WebviewProfileEnvironment
CoreWebView2EnvironmentClasse:
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 des glyphes invisibles du bouton légende sur les arrière-plans de superposition des contrôles de fenêtre sombres.
- Accès restreint à un canal hôte singleton dans les clients WebView2 hérités.
- Suppression de l’ajout implicite
window.gcsur webViews. - Correction de l’annonce du « raccourci de téléchargement » par les lecteurs d’écran.
- Correction du problème de scintillement Min/Max/Close dans la superposition du contrôle Windows.
- Correction du respect d’un facteur d’échelle personnalisé pour l’impression PDF.
- Correction de la logique d’ancrage pour la fenêtre contextuelle Téléchargement de la 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 plantage WPF lors de la modification de la topologie d’affichage dans les applications contrôlées par composition.
Version du SDK 1.0.4129.50, pour runtime 151 (3 août 2026)
Date de publication : 3 août 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.4129.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 151.0.4129.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
- Accès restreint à un canal hôte singleton dans les clients WebView2 hérités.
Prerelease SDK 1.0.4126-prerelease, for Runtime 151 (7 juillet 2026)
Date de publication : 7 juillet 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.4126-prerelease
Pour une compatibilité complète avec l’API, cette préversion du Kit de développement logiciel (SDK) WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 151.0.4126.0 ou ultérieure.
Modifications générales
WebView2 Runtime passe à une cadence de publication de 2 semaines
À compter 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. WebView2 Runtime version 151 est la version finale qui est sur une cadence de publication de 4 semaines.
Exécuter votre application hôte WebView2 à l’intégrité utilisateur standard plutôt qu’avec élévation de privilèges
Exécutez votre application hôte WebView2 avec une intégrité utilisateur standard plutôt qu’avec élévation de privilèges. Consultez 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é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.
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 plantage. Lorsqu’un ProcessFailed événement est déclenché, l’application hôte peut accéder à la CrashReport propriété sur le pour récupérer les ProcessFailedEventArgs détails de la signature d’incident, notamment :
- Code d’exception.
- Nom et version du module défaillant.
- Décalage d’erreur.
- ID du rapport d’incident.
- ID de compartiment.
- Heure à laquelle l’incident 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 kill externe du processus.
- Échec du lancement.
- Un pendu.
ProcessFailedEventArgs.CrashReport peut également concerner null certaines défaillances de type d’incident pour lesquelles aucun rapport n’a été produit. Les applications hôtes doivent toujours case activée pour null avant d’accéder aux propriétés.
CoreWebView2CrashReport, classe
- CoreWebView2CrashReport.BucketId, propriété
- CoreWebView2CrashReport.CrashReportId, propriété
- CoreWebView2CrashReport.ExceptionCode, propriété
- CoreWebView2CrashReport.FaultingModuleName, propriété
- CoreWebView2CrashReport.FaultingModuleVersion, propriété
- CoreWebView2CrashReport.FaultOffset, propriété
- CoreWebView2CrashReport.ReportTime, propriété
CoreWebView2ProcessFailedEventArgsClasse:
Configurer les paramètres de vérification de la réputation par origine (SmartScreen)
La 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 CoreWebView2OriginFeatureState.Disabled pour une origine, les vérifications de réputation des hameçonnages 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 de 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.
CoreWebView2OriginFeatureEnum:CoreWebView2ProfileClasse:
API de prise en charge plus anciennes :
CoreWebView2OriginFeatureState Enum
EnabledDisabled
CoreWebView2SettingsClasse:
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 de la réentrance pour la suppression de trame.
- Correction de l’accès du wrapper d’objet pour un fichier d’autorisation utilisateur (UAF).
- Marquez l’origine faisant autorité du navigateur sur le canal hôte pour empêcher une
WebMessageReceivedEventArgs.Sourceusurpation d’identité. - Restreint l’accès à 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 renderer et les échappements de jonction NTFS (New Technology File System). - Correction de l’arborescence de UI Automation de fenêtre à visuel (UIA).
- Correction d’une régression dans l’API
AddScriptToExecuteOnDocumentCreated. - Implémenté
OnRendererResponsivepour le suivi des résultats de blocage.
Version du SDK 1.0.4078.44, pour runtime 150 (7 juillet 2026)
Date de publication : 7 juillet 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.4078.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 150.0.4078.44 ou ultérieure.
Modifications générales
WebView2 Runtime passe à une cadence de publication de 2 semaines
Consultez WebView2 Runtime passe à une cadence de publication de 2 semaines, dans la section Préversion ci-dessus.
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 la réentrance pour la suppression de trame.
- Correction de l’accès du wrapper d’objet pour un fichier d’autorisation utilisateur (UAF).
- Marquez l’origine faisant autorité du navigateur sur le canal hôte pour empêcher une
WebMessageReceivedEventArgs.Sourceusurpation d’identité. - Restreint l’accès à 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 renderer et les échappements de jonction NTFS (New Technology File System). - Correction de l’arborescence de UI Automation de fenêtre à visuel (UIA).
- Correction d’une régression dans l’API
AddScriptToExecuteOnDocumentCreated.
Prerelease SDK 1.0.4071-prerelease, for Runtime 150 (11 juin 2026)
Date de publication : 11 juin 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.4071-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 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 de l’interpréteur de commandes Windows (écriture manuscrite en texte) pour modifier les champs à l’intérieur des instances WebView2 hébergées en mode Fenêtre à visuel (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 de l’interpréteur de commandes Windows, et VisualToVisual le mode d’hébergement n’est pas pris en charge par cette modification.
Avant ce changement : WebView2 en WindowToVisual mode n’inscrit 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 l’UI Automation du système d’exploitation (UIA).
Après cette modification : si l’indicateur msAbydosForWindowlessWV2 de 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ée sur UIA.
Si l’indicateur msAbydosForWindowlessWV2 de fonctionnalité est activé, WebView2 en WindowToVisual mode inscrit un par instance ITfHandwritingSink sur le thread TSF. Cela active l’écriture manuscrite de l’interpréteur de commandes Windows pour modifier les champs 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 s’inscrit déjà sur son thread ITfHandwritingSink TSF, l’écriture manuscrite du stylet continuera à 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’inscrit pas son propre ITfHandwritingSink, l’écriture manuscrite du stylet peut cesser de fonctionner pour les champs d’édition natifs de votre application une fois cette modification activée par défaut. Cela se produit parce que WebView2 retourne E_NOTIMPL pour les HWND qu’il ne possède pas, en s’attendant à ce que TSF soit chaîné à un autre récepteur inscrit. Si aucun récepteur hôte n’est inscrit, TSF ne revient pas à la résolution cible d’écriture manuscrite basée sur UIA par défaut.
Pour conserver la prise en charge de l’écriture manuscrite pour les champs d’édition natifs de votre application, inscrivez le vôtre ITfHandwritingSink sur le thread TSF. L’écriture manuscrite dans les champs d’édition 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 msAbydosForWindowlessWV2 de fonctionnalité est désactivé par défaut, ce qui donne aux applications le temps de tester de manière proactive. À compter de la version 151, la fonctionnalité est prévue pour être activée par défaut.
En testant votre application WebView2 avec cet indicateur de fonctionnalité activé, vous pouvez déterminer si des flux de travail d’écriture manuscrits de champ d’édition natifs dans votre application dépendent de l’inscription d’un hôte ITfHandwritingSink.
Voir aussi :
- [Changement cassant] Activation de la prise en charge de l’écriture manuscrite windows pour WebView2 en mode WindowToVisual (problème n° 134)
- Hébergement fenêtré par rapport à l’hébergement 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 KIT de développement logiciel (SDK) WebView2 Release ou à un KIT de développement logiciel (SDK) de préversion.
Le package DevToolsProtocolExtension fournit un wrapper .NET fortement typé sur le protocole CDP (Chrome DevTools Protocol) à utiliser dans les applications WebView2. Les versions publiées existantes (1.0.824, 1.0.2271et 1.0.2901) restent disponibles sur NuGet Gallery 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 CDP (Chrome DevTools Protocol) dans les applications WebView2 et les éléments suivants :
API expérimentales (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 et KIT de développement logiciel (SDK)
- Ajout d’histogrammes total pour l’environnement WebView2 et les tentatives de création de contrôleur.
Runtime uniquement
- Mappé
TERMINATION_STATUS_LAUNCH_FAILED_OS_POLICYàkLaunchFailed. - Mise à jour de la classification de la raison de l’échec en
OOM, pour un processus qui a été tué afin de 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) à des fins d’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 case activée d’origine approuvée lors de l’accès aux objets hôtes.
- Réduction des recherches de mappage redondantes dans le gestionnaire de demandes d’URL WebView2, pour améliorer les performances.
- Élimination des allocations de chaînes inutiles dans la couche de cookies WebView2, pour améliorer les performances.
KIT de développement logiciel (SDK) uniquement
- Correction des problèmes de sécurité des conteneurs dans le frame WebView2 et le code de l’écouteur.
- L’abonnement aux événements WinRT maintient désormais le wrapper de projection actif jusqu’à ce que le gestionnaire soit désinscrit.
Version du SDK 1.0.4022.49, pour runtime 149 (11 juin 2026)
Date de publication : 11 juin 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.4022.49
Pour une compatibilité complète de l’API, cette version Release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 149.0.4022.49 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.
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
PostMessagede etWebMessageReceived; en particulier :CoreWebView2ServiceWorker.PostWebMessageAsJsonCoreWebView2ServiceWorker.PostWebMessageAsStringCoreWebView2DedicatedWorker.PostWebMessageAsJsonCoreWebView2DedicatedWorker.PostWebMessageAsStringCoreWebView2ServiceWorker.WebMessageReceivedCoreWebView2DedicatedWorker.WebMessageReceivedchrome.webview.postMessage- Pas:
chrome.webview.postMessageWithAdditionalObjects
- 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
Bogue
Ce Kit de développement logiciel (SDK) de version inclut les correctifs de bogues suivants.
Runtime uniquement
- Mappé
TERMINATION_STATUS_LAUNCH_FAILED_OS_POLICYàkLaunchFailed. - Mise à jour de la classification de la raison de l’échec en
OOM, pour un processus qui a été tué afin de récupérer de la mémoire. - Ajout de case activée d’origine approuvée lors de l’accès aux objets hôtes.
- Correction de la sélection des listes déroulantes de la boîte de dialogue Imprimer dans
WebView2CompositionControl. (Problème n° 5195)
KIT de développement logiciel (SDK) uniquement
- Correction des problèmes de sécurité des conteneurs dans le frame WebView2 et le code de l’écouteur.
Prerelease SDK 1.0.4015-prerelease, for Runtime 149 (11 mai 2026)
Date de publication : 11 mai 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.4015-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 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 l’utilisation de ces API dans votre application WebView2, comme suit.
L’ancienne propriété, , CoreWebView2Profile.EnhancedSecurityModeLeveldétermine si le mode de sécurité renforcée (ESM) est activé ou désactivé pour toutes les instances WebView2 associées à un profil. Cette propriété a été renommée EnhancedSecurityModeStateen , pour communiquer plus clairement l’état du mode de sécurité renforcée.
Avant ce changement : La CoreWebView2Profile.EnhancedSecurityModeLevel propriété a utilisé l’énumération CoreWebView2EnhancedSecurityModeLevel avec les valeurs Off et Strict.
Après cette modification : La CoreWebView2Profile.EnhancedSecurityModeState propriété utilise l’énumération CoreWebView2EnhancedSecurityModeState avec les valeurs Disabled et Enabled:
CoreWebView2EnhancedSecurityModeState.Disabled— Le mode de sécurité renforcée est désactivé.- Remplace
CoreWebView2EnhancedSecurityModeLevel.Off.
- Remplace
CoreWebView2EnhancedSecurityModeState.Enabled: le mode de sécurité renforcée est activé.- Désactive la compilation juste-à-temps (JIT) JavaScript.
- Active des protections supplémentaires du système d’exploitation.
- Remplace
CoreWebView2EnhancedSecurityModeLevel.Strict.
Voir aussi :
- État du mode de sécurité amélioré, ci-dessous.
-
[Changement cassant]
EnhancedSecurityModeLevelremplacé parEnhancedSecurityModeState(Problème n° 132)
API expérimentales (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.
État du mode de sécurité amélioré
La EnhancedSecurityModeState propriété sur CoreWebView2Profile contrôle 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 juste-à-temps (JIT) JavaScript et active des protections supplémentaires du système d’exploitation, réduisant ainsi la surface d’attaque, au détriment de certaines performances JavaScript.
La valeur par défaut est Disabled. Les modifications s’appliquent immédiatement aux nouvelles navigations ; les pages existantes nécessitent un rechargement.
Ce paramètre ne persiste pas 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 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.
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
PostMessagede etWebMessageReceived; en particulier :CoreWebView2ServiceWorker.PostWebMessageAsJsonCoreWebView2ServiceWorker.PostWebMessageAsStringCoreWebView2DedicatedWorker.PostWebMessageAsJsonCoreWebView2DedicatedWorker.PostWebMessageAsStringCoreWebView2ServiceWorker.WebMessageReceivedCoreWebView2DedicatedWorker.WebMessageReceivedchrome.webview.postMessage- Pas:
chrome.webview.postMessageWithAdditionalObjects
- 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
Bogue
Ce Kit de développement logiciel (SDK) préversion inclut les correctifs de bogues suivants.
Runtime uniquement
- Correction du caractère double dans UWP.
- Correction de l’API de
Caption controlsparamètre de couleur d’arrière-plan. Après cette modification, pour fermer votre application, l’application doit également intercepter l’appelCloseet gérer l’appel lui-même. - Correction du transfert des événements réseau pour iframe, où l’iframe avait sa propre session CDP isolée.
- Amélioration de la gestion des erreurs lorsque Post Message (par
CoreWebView2ServiceWorker.PostWebMessageAsJsonexemple, ouchrome.webview.postMessage) est appelé sur un worker de service. - Allocations de chaînes réduites 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 plantage lors de la création d’un nouveau contrôleur dans une application déjà en cours d’exécution.
Version du SDK 1.0.3967.48, pour runtime 148 (11 mai 2026)
Date de publication : 11 mai 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3967.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 148.0.3967.48 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 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 plantage lors de la création d’un nouveau contrôleur dans une application déjà en cours d’exécution.
Prerelease SDK 1.0.3965-prerelease, for Runtime 148 (13 avril 2026)
Date de publication : 13 avril 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3965-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 148.0.3965.0 ou ultérieure.
Changements cassants
Raisons précises 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 renderer ou un processus GPU) se ferme de manière inattendue, ce qui permet aux applications de répondre avec une logique de récupération ou diagnostics.
Avant cette modification : la CoreWebView2ProcessFailedEventArgs.Reason propriété retournée Unexpected pour trois scénarios de sortie distincts (sortie normale, sortie anormale et échec d’intégrité du code), rendant impossible la distinction entre les applications.
Après cette modification : Lorsque l’indicateur msWebView2GranularProcessFailedReason de fonctionnalité est activé, la CoreWebView2ProcessFailedEventArgs.Reason propriété retourne 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 différent de zéro), mais il n’a pas été arrêté ou tué.IntegrityFailure— Le système d’exploitation a arrêté le processus en raison d’un échec de l’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. À compter 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 de bogue pour le runtime et le SDK. Ces membres enum sont une modification d’une API stable existante et sont disponibles dans le cadre de ce Kit de développement logiciel (SDK) préversion.
Voir aussi :
CoreWebView2ProcessFailedEventArgsClasseÉnumération CoreWebView2ProcessFailedReason
AbnormalExitIntegrityFailureNormalExit
API expérimentales (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.
API de configuration d’origine pour WebView2
L’API de configuration d’origine permet aux applications WebView2 d’appliquer différentes fonctionnalités et stratégies de sécurité en fonction de l’origine du contenu hébergé. Par défaut, WebView2 applique une stratégie 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 (telles que le mode de sécurité renforcée) pour des origines ou des modèles d’origine individuels.
Utilisez la SetOriginFeatures méthode on CoreWebView2Profile pour configurer les 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, schéma, puis port.
Permet GetEffectiveFeaturesForOrigin de récupérer de façon asynchrone les paramètres de fonctionnalité calculée pour une origine donnée.
-
CoreWebView2OriginFeature Enum
EnhancedSecurityMode
-
CoreWebView2OriginFeatureState Enum
DisabledEnabled
Phase 2 (Stable en préversion)
Les membres d’énumération suivants sont une modification d’une API stable existante et sont disponibles dans le cadre de ce Kit de développement logiciel (SDK) préversion.
Raisons précises de l’échec du processus pour l’événement ProcessFailed
Ajout du CoreWebView2ProcessFailedReason.Unexpected membre enum en ajoutant des valeurs plus granulaires pour l’énumération CoreWebView2ProcessFailedReason retournée par la CoreWebView2ProcessFailedEventArgs.Reason propriété .
Il s’agit d’un changement cassant ; Consultez Les raisons précises de l’échec du processus pour l’événementProcessFailed, ci-dessus.
Bogue
Ce Kit de développement logiciel (SDK) préversion inclut les correctifs de bogues suivants.
Runtime et KIT de développement logiciel (SDK)
- Ajout du
CoreWebView2ProcessFailedReason.Unexpectedmembre enum en ajoutant des valeurs plus granulaires pour l’énumérationCoreWebView2ProcessFailedReasonretournée par laCoreWebView2ProcessFailedEventArgs.Reasonpropriété . Il s’agit d’un changement cassant. Consultez Les raisons précises de l’échec du processus pour l’événementProcessFailed, ci-dessus.
Runtime uniquement
Correction des problèmes de sélection de la boîte de dialogue Imprimer dans
WebView2CompositionControl. (Problème n° 5195)Désactivé le composant Actions du domaine pour WebView2.
Notification désactivée
WebUSBDetectorpour WebView2.Correction de l’obsolescence
ICoreWebView2Profile3::get_PreferredTrackingPreventionLevelde .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 a laissé un processus WPF persistant.
KIT de développement logiciel (SDK) uniquement
- Activation de la journalisation de l’histogramme pour les blocages de processus de navigateur dans WebView2.
Version du SDK 1.0.3912.50, pour runtime 147 (13 avril 2026)
Date de publication : 13 avril 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3912.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 147.0.3912.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
Désactivé le composant Actions du domaine pour WebView2.
Correction de l’incapacité des clients WDP à se connecter à un serveur de débogage distant.
Prerelease SDK 1.0.3908-prerelease, for Runtime 147 (16 mars 2026)
Date de publication : 16 mars 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3908-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 147.0.3908.0 ou ultérieure.
API expérimentales (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)
Les API suivantes ont ignoré la phase 1 : Expérimentale dans la préversion et ont été ajoutées directement à La phase 2 : Stable dans la préversion, et sont incluses dans ce Kit de développement logiciel (SDK) de préversion.
Gérer les autorisations de stockage persistant pour le contenu web
L’autorisation PersistentStorage permet à une application WebView2 de gérer les requêtes à partir de contenu web afin de conserver les données créées par les API de stockage, les workers de 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’supprime pas les données stockées dans les scénarios de faible espace disque. Cela garantit un comportement fiable hors connexion et de mise en cache pour le site.
-
CoreWebView2PermissionKind Enum
PersistentStorage
Bogue
Ce Kit de développement logiciel (SDK) préversion inclut les correctifs de bogues suivants.
Runtime uniquement
- Correction d’un bogue dans lequel la déconnexion d’un écran ne modifiait pas correctement la résolution de l’écran.
- Résolution de ppp par moniteur dans
window.getScreenDetails(). (Problème n° 4826) - Désactivé le composant d’actions de domaine pour WebView2.
- Correction de l’échec de l’API Print-to-PDF lors de l’impression de fichiers PDF. (Problème n° 5499)
- Correction d’un problème empêchant le Narrateur d’annoncer la structure
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 Caption .
Version du SDK 1.0.3856.49, pour runtime 146 (16 mars 2026)
Date de publication : 16 mars 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3856.49
Pour une compatibilité complète de l’API, cette version Release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 146.0.3856.49 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’échec de l’API Print-to-PDF lors de l’impression de fichiers PDF. (Problème n° 5499)
Prerelease SDK 1.0.3848-prerelease, for Runtime 146 (16 février 2026)
Date de publication : 16 février 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3848-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 146.0.3848.0 ou ultérieure.
Changements cassants
Activer les API Javascript spécifiques à WebView2 pour les workers de 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 travail de 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’ont pas accès aux API JavaScript spécifiques à WebView2 dans les scripts de travail de service. Par conséquent, la communication basée sur chrome.webview.postMessage le worker de service avec l’application hôte WebView2 ne fonctionnera pas tant que le paramètre n’est pas activé.
À l’avenir, WebView2 s’appuie sur le AreWebViewScriptApisEnabledForServiceWorkers paramètre comme mécanisme faisant autorité pour activer les API JavaScript spécifiques à WebView2 dans les scripts de travail 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 de 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 workflows qui dépendent des API de travail de service spécifiques à WebView2, telles que chrome.webview.postMessage la communication entre les workers de service et l’application hôte.
Actuellement, les chrome objets et chrome.webview sont disponibles pour les scripts worker de service lors de l’utilisation de l’événement ServiceWorkerRegistered . Toutefois, à compter de la version suivante, le AreWebViewScriptApisEnabledForServiceWorkers paramètre sera le seul mécanisme qui détermine si ces objets sont exposés aux scripts de travail de service. Testez ce paramètre avant la prochaine version et signalez les problèmes que vous rencontrez. Pour plus d’informations, 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 workers de service ci-dessous.
CoreWebView2ProfileClasseCoreWebView2ServiceWorkerManagerClasse:Classe 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 requêtes à des ressources de réseau privé ou local, sauf si la page web dispose d’une autorisation explicite pour accéder aux ressources de réseau privé ou local. Exemples de ces ressources : 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 l’instant. Pour plus d’informations sur l’indicateur, consultez Indicateurs de navigateur WebView2 disponibles dans les indicateurs de navigateur WebView2.
Une fois la amont, Chromium base de code stabilisée, nous prévoyons d’ajouter des valeurs d’énumération supplémentaires dans l’énumération CoreWebView2PermissionKind 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 tous 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 d’informations, consultez [Changement cassant] Accès au réseau local (LNA) dans WebView2 - Plan de déploiement.
API expérimentales (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.
Contrôler si les API de script WebView sont activées pour les workers de service
Utilisez la AreWebViewScriptApisEnabledForServiceWorkers propriété on CoreWebView2Profile pour contrôler si les API de script WebView sont activées pour les workers de service.
Voir également Activer les API Javascript spécifiques à WebView2 pour les workers de service, ci-dessus.
-
CoreWebView2ProfileClasse
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 de la disparition de la barre d’outils PDF lorsque toutes les options d’une région sont supprimées. (Problème n° 4738)
Correction d’un flash blanc qui s’est produit lorsque La Recherche Windows est devenue visible après avoir été masquée.
Correction de l’ombre de la barre de titre afin qu’elle ne s’affiche pas dans un contrôle WebView2 transparent. (Problème n° 5492)
Correction de la transparence de WebView2.
Correction d’un problème d’accès au réseau local (LNA) en désactivant les vérifications LNA dans WebView2.
Version du SDK 1.0.3800.47, pour runtime 145 (16 février 2026)
Date de publication : 16 février 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3800.47
Pour une compatibilité complète de l’API, cette version release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 145.0.3800.47 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’ombre de la barre de titre afin qu’elle ne s’affiche pas dans un contrôle WebView2 transparent. (Problème n° 5492)
Correction d’un problème d’accès au réseau local (LNA) en désactivant les vérifications LNA dans WebView2.
Correction de la transparence de WebView2.
Prerelease SDK 1.0.3796-prerelease, for Runtime 145 (19 janvier 2026)
Date de publication : 19 janvier 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3796-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 145.0.3796.0 ou ultérieure.
API expérimentales (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.
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 juste-à-temps (JIT) JavaScript 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
Strictvaleur pour activer une sé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 peut réduire les performances JavaScript.
CoreWebView2EnhancedSecurityModeLevel Enum
CoreWebView2EnhancedSecurityModeLevel.OffCoreWebView2EnhancedSecurityModeLevel.Strict
CoreWebView2ProfileClasse:
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
- Indisponibilité fixe
chrome.webview. - Désactivation de la mise à jour en arrière-plan de l’heure réseau.
KIT de développement logiciel (SDK) uniquement
- Ajout de l’article Meilleures pratiques en matière de performances pour les applications WebView2, qui explique comment améliorer la vitesse de démarrage, l’utilisation de la mémoire et la réactivité d’une application WebView2.
Version du SDK 1.0.3719.77, pour runtime 144 (27 janvier 2026)
Date de publication : 27 janvier 2026
Package NuGet pour le Kit de développement logiciel (SDK) WebView2 1.0.3719.77
Pour une compatibilité complète de l’API, cette version release du Kit de développement logiciel (SDK) WebView2 nécessite WebView2 Runtime version 144.0.3719.77 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 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) de version inclut les correctifs de bogues suivants.
Runtime uniquement
- Indisponibilité fixe
chrome.webview.
KIT de développement logiciel (SDK) uniquement
- Ajout de l’article Meilleures pratiques en matière de performances pour les applications WebView2, qui explique comment améliorer la vitesse de démarrage, l’utilisation de la mémoire et la réactivité d’une application WebView2.
Prerelease SDK 1.0.3712-prerelease, for Runtime 144 (8 décembre 2025)
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 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 144.0.3712.0 ou ultérieure.
API expérimentales (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 .
Version du SDK 1.0.3650.58, pour runtime 143 (8 décembre 2025)
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.
Prerelease SDK 1.0.3650-prerelease, for Runtime 143 (7 novembre 2025)
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.
API expérimentales (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.
Version du SDK 1.0.3595.46, pour runtime 142 (3 novembre 2025)
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 ».
Prerelease SDK 1.0.3590-prerelease, for Runtime 142 (7 octobre 2025)
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 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 142.0.3590.0 ou ultérieure.
API expérimentales (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.
Version du SDK 1.0.3537.50, pour runtime 141 (6 octobre 2025)
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 avec 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.
Prerelease SDK 1.0.3530-prerelease, for Runtime 141 (8 septembre 2025)
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 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 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.
API expérimentales (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.
Version du SDK 1.0.3485.44, pour runtime 140 (8 septembre 2025)
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.
Prerelease SDK 1.0.3477-prerelease, for Runtime 140 (11 août 2025)
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.
API expérimentales (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.
Voir également
- Notes de publication archivées pour le Kit de développement logiciel (SDK) WebView2
- À propos des notes de publication du 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++)