Skip to content

Commit 33dc7a1

Browse files
WebView2 Release Notes for Nov. 2025 Release SDK (#3603)
* templates * archive-link fix * initial draft for release. * Writer/Editor pass * Removed the Prerelease part * dummy trigger build * dummy 2 * dummy 3 --------- Co-authored-by: vootlasaichandu <[email protected]>
1 parent c8877e1 commit 33dc7a1

File tree

5 files changed

+167
-135
lines changed

5 files changed

+167
-135
lines changed

microsoft-edge/web-platform/release-notes/136.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ See [What's New in DevTools (Microsoft Edge 136)](../../devtools/whats-new/2025/
6464
<!-- ====================================================================== -->
6565
## WebView2
6666

67-
See [1.0.3240.44](../../webview2/release-notes/index.md#10324044) (May 2025) in _Release Notes for the WebView2 SDK_.
67+
See [1.0.3240.44](../../webview2/release-notes/archive.md#10324044) (May 2025) in _Archived Release Notes for the WebView2 SDK_.
6868

6969

7070
<!-- ====================================================================== -->

microsoft-edge/webview2/concepts/overview-features-apis.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2613,7 +2613,7 @@ iframes allow you to embed other webpages into your own webpage. In WebView2, y
26132613
See also:
26142614
* [Host/web object sharing](#hostweb-object-sharing), above
26152615
* [Using frames in WebView2 apps](./frames.md)
2616-
* [Track navigation history for nested iframes (FrameCreatedEvent API)](../release-notes/index.md#track-navigation-history-for-nested-iframes-framecreatedevent-api) in _Release Notes for the WebView2 SDK_.
2616+
* [Track navigation history for nested iframes (FrameCreatedEvent API)](../release-notes/archive.md#track-navigation-history-for-nested-iframes-framecreatedevent-api) in _Archived Release Notes for the WebView2 SDK_.
26172617

26182618
##### [.NET/C#](#tab/dotnetcsharp)
26192619

microsoft-edge/webview2/release-notes/archive.md

Lines changed: 125 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,137 @@ ms.author: msedgedevrel
66
ms.topic: conceptual
77
ms.service: microsoft-edge
88
ms.subservice: devtools
9-
ms.date: 10/07/2025
9+
ms.date: 11/03/2025
1010
---
1111
# Archived Release Notes for the WebView2 SDK
1212

1313
These Release Notes provide information about added features and bug fixes that are included in the WebView2 Release SDK and the WebView2 Prerelease SDK, for older releases.
1414

1515

16+
<!-- May 2025 Release SDK -->
17+
<!-- ====================================================================== -->
18+
## 1.0.3240.44
19+
20+
Release Date: May 05, 2025
21+
22+
[NuGet package for WebView2 SDK 1.0.3240.44](https://www.nuget.org/packages/Microsoft.Web.WebView2/1.0.3240.44)
23+
24+
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 136.0.3240.44 or higher.
25+
26+
27+
<!-- ------------------------------ -->
28+
#### Promotions
29+
30+
The following APIs have been promoted to Stable and are now included in this Release SDK.
31+
32+
33+
<!-- ---------- -->
34+
###### Track navigation history for nested iframes (FrameCreatedEvent API)
35+
36+
The FrameCreatedEvent API supports nested iframes, such as recording the navigation history for a second-level iframe. Without this API, WebView2 only tracks first-level iframes, which are the direct child iframes of the main frame. Using this API, your app can subscribe to the nested iframe creation event, giving the app access to all properties, methods, and events of `CoreWebView2Frame` for the nested iframe.
37+
38+
Use this API to manage iframe tracking on a page that contains multiple levels of iframes. You can choose to track any of the following:
39+
40+
* Only the main page and first-level iframes (the default behavior).
41+
* A partial WebView2 frames tree with specific iframes of interest.
42+
* The full WebView2 frames tree.
43+
44+
##### [.NET/C#](#tab/dotnetcsharp)
45+
46+
* `CoreWebView2Frame` Class:
47+
* [CoreWebView2Frame.FrameCreated Event](/dotnet/api/microsoft.web.webview2.core.corewebview2frame.framecreated?view=webview2-dotnet-1.0.3240.44&preserve-view=true)
48+
49+
##### [WinRT/C#](#tab/winrtcsharp)
50+
51+
* `CoreWebView2Frame` Class:
52+
* [CoreWebView2Frame.FrameCreated Event](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2frame?view=webview2-winrt-1.0.3240.44&preserve-view=true#framecreated)
53+
54+
##### [Win32/C++](#tab/win32cpp)
55+
56+
* [ICoreWebView2Frame7](/microsoft-edge/webview2/reference/win32/icorewebview2frame7?view=webview2-1.0.3240.44&preserve-view=true)
57+
* [ICoreWebView2Frame7::add_FrameCreated](/microsoft-edge/webview2/reference/win32/icorewebview2frame7?view=webview2-1.0.3240.44&preserve-view=true#add_framecreated)
58+
* [ICoreWebView2Frame7::remove_FrameCreated](/microsoft-edge/webview2/reference/win32/icorewebview2frame7?view=webview2-1.0.3240.44&preserve-view=true#remove_framecreated)
59+
60+
* [ICoreWebView2FrameChildFrameCreatedEventHandler](/microsoft-edge/webview2/reference/win32/icorewebview2framechildframecreatedeventhandler?view=webview2-1.0.3240.44&preserve-view=true)<!-- win32 only -->
61+
62+
---
63+
64+
65+
<!-- ------------------------------ -->
66+
#### Bug fixes
67+
68+
69+
<!-- ---------- -->
70+
###### Runtime-only
71+
72+
* Fixed an issue where downloads from within the default browser frame didn't complete. ([Issue #5196](https://github.com/MicrosoftEdge/WebView2Feedback/issues/5196))
73+
* Fixed an issue where the pipe name was incorrectly returned, leading to a crash in some UWP apps.
74+
75+
<!-- end of May 2025 Release SDK -->
76+
77+
78+
<!-- May 2025 Prerelease SDK -->
79+
<!-- ====================================================================== -->
80+
## 1.0.3296-prerelease
81+
82+
Release Date: May 12, 2025
83+
84+
[NuGet package for WebView2 SDK 1.0.3296-prerelease](https://www.nuget.org/packages/Microsoft.Web.WebView2/1.0.3296-prerelease)
85+
86+
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 137.0.3296.0 or higher.
87+
88+
89+
<!-- ------------------------------ -->
90+
#### Experimental APIs
91+
92+
No Experimental APIs have been added in this Prerelease SDK.
93+
94+
95+
<!-- ------------------------------ -->
96+
#### Promotions
97+
98+
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
99+
100+
101+
<!-- ---------- -->
102+
###### Set default background color on WebView2 initialization (DefaultBackgroundColor API)
103+
104+
The DefaultBackgroundColor API allows users to set the `DefaultBackgroundColor` property at initialization. This prevents a disruptive white flash during the WebView2 loading process.
105+
106+
##### [.NET/C#](#tab/dotnetcsharp)
107+
108+
* `CoreWebView2ControllerOptions` Class:
109+
* [CoreWebView2ControllerOptions.DefaultBackgroundColor Property](/dotnet/api/microsoft.web.webview2.core.corewebview2controlleroptions.defaultbackgroundcolor?view=webview2-dotnet-1.0.3296-prerelease&preserve-view=true)
110+
111+
##### [WinRT/C#](#tab/winrtcsharp)
112+
113+
* `CoreWebView2ControllerOptions` Class:
114+
* [CoreWebView2ControllerOptions.DefaultBackgroundColor Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2controlleroptions?view=webview2-winrt-1.0.3296-prerelease&preserve-view=true#defaultbackgroundcolor)
115+
116+
##### [Win32/C++](#tab/win32cpp)
117+
118+
* [ICoreWebView2ControllerOptions3](/microsoft-edge/webview2/reference/win32/icorewebview2controlleroptions3?view=webview2-1.0.3296-prerelease&preserve-view=true)
119+
* [ICoreWebView2ControllerOptions3::get_DefaultBackgroundColor](/microsoft-edge/webview2/reference/win32/icorewebview2controlleroptions3?view=webview2-1.0.3296-prerelease&preserve-view=true#get_defaultbackgroundcolor)
120+
* [ICoreWebView2ControllerOptions3::put_DefaultBackgroundColor](/microsoft-edge/webview2/reference/win32/icorewebview2controlleroptions3?view=webview2-1.0.3296-prerelease&preserve-view=true#put_defaultbackgroundcolor)
121+
122+
---
123+
124+
125+
<!-- ------------------------------ -->
126+
#### Bug fixes
127+
128+
129+
<!-- ---------- -->
130+
###### Runtime-only
131+
132+
* Fixed the **Find** bar no longer appearing after the window is shifted.
133+
* Fixed a bug where the app wasn't able to cancel navigation to login pages via the `NavigationStarting` event.
134+
* Fixed an issue where downloads from within the default browser frame didn't complete. ([Issue #5196](https://github.com/MicrosoftEdge/WebView2Feedback/issues/5196))
135+
* Fixed an issue where the pipe name was incorrectly returned, leading to a crash in some UWP apps.
136+
137+
<!-- end of May 2025 Prerelease SDK -->
138+
139+
16140
<!-- Apr 2025 Release SDK -->
17141
<!-- ====================================================================== -->
18142
## 1.0.3179.45

microsoft-edge/webview2/release-notes/includes/templates.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- Oct 2025 Release SDK -->
1+
<!-- Dec 2025 Release SDK -->
22
<!-- ====================================================================== -->
33
## 1.0.####.##
44

@@ -59,10 +59,10 @@ This Release SDK includes the following bug fixes.
5959

6060
* Fixed behavior. ([Issue #]())
6161

62-
<!-- end of Oct 2025 Release SDK -->
62+
<!-- end of Dec 2025 Release SDK -->
6363

6464

65-
<!-- Oct 2025 Prerelease SDK -->
65+
<!-- Dec 2025 Prerelease SDK -->
6666
<!-- ====================================================================== -->
6767
## 1.0.####-prerelease
6868

@@ -144,4 +144,4 @@ This Prerelease SDK includes the following bug fixes.
144144

145145
* Fixed behavior. ([Issue #]())
146146

147-
<!-- end of Oct 2025 Prerelease SDK -->
147+
<!-- end of Dec 2025 Prerelease SDK -->

microsoft-edge/webview2/release-notes/index.md

Lines changed: 36 additions & 128 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.author: msedgedevrel
66
ms.topic: conceptual
77
ms.service: microsoft-edge
88
ms.subservice: webview
9-
ms.date: 10/07/2025
9+
ms.date: 11/03/2025
1010
---
1111
# Release Notes for the WebView2 SDK
1212

@@ -16,18 +16,50 @@ These Release Notes provide information about new features and bug fixes that ar
1616
the templates to copy for incoming sections are in ./includes/templates.md
1717
1818
this webpage covers the most recent 6 months; periodically move oldest h2 sections from bottom of present file to archive.md. eg covers:
19+
Nov 2025
1920
Oct 2025
2021
Sep 2025
2122
Aug 2025
2223
Jul 2025
2324
Jun 2025
24-
May 2025
2525
26-
moved to archive:
27-
Apr 2025
26+
moved to archive:
27+
May 2025
2828
-->
2929

3030

31+
<!-- Nov 2025 Release SDK -->
32+
<!-- ====================================================================== -->
33+
## 1.0.3595.46
34+
35+
Release Date: November 3, 2025
36+
37+
[NuGet package for WebView2 SDK 1.0.3595.46](https://www.nuget.org/packages/Microsoft.Web.WebView2/1.0.3595.46)
38+
39+
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 142.0.3595.46 or higher.
40+
41+
42+
<!-- ------------------------------ -->
43+
#### Promotions
44+
45+
No additional APIs have been promoted from Phase 2: Stable in Prerelease, to Phase 3: Stable in Release, in this Release SDK.
46+
47+
48+
<!-- ------------------------------ -->
49+
#### Bug fixes
50+
51+
This Release SDK includes the following bug fixes.
52+
53+
54+
<!-- ---------- -->
55+
###### Runtime-only
56+
57+
* Disabled creation of a "Speculative Renderer" process.
58+
* Enabled `EmbeddedBrowserBrowserProcessExitedTest` for ARM64.
59+
60+
<!-- end of Nov 2025 Release SDK -->
61+
62+
3163
<!-- Oct 2025 Release SDK -->
3264
<!-- ====================================================================== -->
3365
## 1.0.3537.50
@@ -1101,130 +1133,6 @@ The `CoreWebView2ControllerOptions` class now has an `AllowHostInputProcessing`
11011133
<!-- end of June 2025 Prerelease SDK -->
11021134

11031135

1104-
<!-- May 2025 Release SDK -->
1105-
<!-- ====================================================================== -->
1106-
## 1.0.3240.44
1107-
1108-
Release Date: May 05, 2025
1109-
1110-
[NuGet package for WebView2 SDK 1.0.3240.44](https://www.nuget.org/packages/Microsoft.Web.WebView2/1.0.3240.44)
1111-
1112-
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 136.0.3240.44 or higher.
1113-
1114-
1115-
<!-- ------------------------------ -->
1116-
#### Promotions
1117-
1118-
The following APIs have been promoted to Stable and are now included in this Release SDK.
1119-
1120-
1121-
<!-- ---------- -->
1122-
###### Track navigation history for nested iframes (FrameCreatedEvent API)
1123-
1124-
The FrameCreatedEvent API supports nested iframes, such as recording the navigation history for a second-level iframe. Without this API, WebView2 only tracks first-level iframes, which are the direct child iframes of the main frame. Using this API, your app can subscribe to the nested iframe creation event, giving the app access to all properties, methods, and events of `CoreWebView2Frame` for the nested iframe.
1125-
1126-
Use this API to manage iframe tracking on a page that contains multiple levels of iframes. You can choose to track any of the following:
1127-
1128-
* Only the main page and first-level iframes (the default behavior).
1129-
* A partial WebView2 frames tree with specific iframes of interest.
1130-
* The full WebView2 frames tree.
1131-
1132-
##### [.NET/C#](#tab/dotnetcsharp)
1133-
1134-
* `CoreWebView2Frame` Class:
1135-
* [CoreWebView2Frame.FrameCreated Event](/dotnet/api/microsoft.web.webview2.core.corewebview2frame.framecreated?view=webview2-dotnet-1.0.3240.44&preserve-view=true)
1136-
1137-
##### [WinRT/C#](#tab/winrtcsharp)
1138-
1139-
* `CoreWebView2Frame` Class:
1140-
* [CoreWebView2Frame.FrameCreated Event](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2frame?view=webview2-winrt-1.0.3240.44&preserve-view=true#framecreated)
1141-
1142-
##### [Win32/C++](#tab/win32cpp)
1143-
1144-
* [ICoreWebView2Frame7](/microsoft-edge/webview2/reference/win32/icorewebview2frame7?view=webview2-1.0.3240.44&preserve-view=true)
1145-
* [ICoreWebView2Frame7::add_FrameCreated](/microsoft-edge/webview2/reference/win32/icorewebview2frame7?view=webview2-1.0.3240.44&preserve-view=true#add_framecreated)
1146-
* [ICoreWebView2Frame7::remove_FrameCreated](/microsoft-edge/webview2/reference/win32/icorewebview2frame7?view=webview2-1.0.3240.44&preserve-view=true#remove_framecreated)
1147-
1148-
* [ICoreWebView2FrameChildFrameCreatedEventHandler](/microsoft-edge/webview2/reference/win32/icorewebview2framechildframecreatedeventhandler?view=webview2-1.0.3240.44&preserve-view=true)<!-- win32 only -->
1149-
1150-
---
1151-
1152-
1153-
<!-- ------------------------------ -->
1154-
#### Bug fixes
1155-
1156-
1157-
<!-- ---------- -->
1158-
###### Runtime-only
1159-
1160-
* Fixed an issue where downloads from within the default browser frame didn't complete. ([Issue #5196](https://github.com/MicrosoftEdge/WebView2Feedback/issues/5196))
1161-
* Fixed an issue where the pipe name was incorrectly returned, leading to a crash in some UWP apps.
1162-
1163-
<!-- end of May 2025 Release SDK -->
1164-
1165-
1166-
<!-- May 2025 Prerelease SDK -->
1167-
<!-- ====================================================================== -->
1168-
## 1.0.3296-prerelease
1169-
1170-
Release Date: May 12, 2025
1171-
1172-
[NuGet package for WebView2 SDK 1.0.3296-prerelease](https://www.nuget.org/packages/Microsoft.Web.WebView2/1.0.3296-prerelease)
1173-
1174-
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 137.0.3296.0 or higher.
1175-
1176-
1177-
<!-- ------------------------------ -->
1178-
#### Experimental APIs
1179-
1180-
No Experimental APIs have been added in this Prerelease SDK.
1181-
1182-
1183-
<!-- ------------------------------ -->
1184-
#### Promotions
1185-
1186-
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
1187-
1188-
1189-
<!-- ---------- -->
1190-
###### Set default background color on WebView2 initialization (DefaultBackgroundColor API)
1191-
1192-
The DefaultBackgroundColor API allows users to set the `DefaultBackgroundColor` property at initialization. This prevents a disruptive white flash during the WebView2 loading process.
1193-
1194-
##### [.NET/C#](#tab/dotnetcsharp)
1195-
1196-
* `CoreWebView2ControllerOptions` Class:
1197-
* [CoreWebView2ControllerOptions.DefaultBackgroundColor Property](/dotnet/api/microsoft.web.webview2.core.corewebview2controlleroptions.defaultbackgroundcolor?view=webview2-dotnet-1.0.3296-prerelease&preserve-view=true)
1198-
1199-
##### [WinRT/C#](#tab/winrtcsharp)
1200-
1201-
* `CoreWebView2ControllerOptions` Class:
1202-
* [CoreWebView2ControllerOptions.DefaultBackgroundColor Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2controlleroptions?view=webview2-winrt-1.0.3296-prerelease&preserve-view=true#defaultbackgroundcolor)
1203-
1204-
##### [Win32/C++](#tab/win32cpp)
1205-
1206-
* [ICoreWebView2ControllerOptions3](/microsoft-edge/webview2/reference/win32/icorewebview2controlleroptions3?view=webview2-1.0.3296-prerelease&preserve-view=true)
1207-
* [ICoreWebView2ControllerOptions3::get_DefaultBackgroundColor](/microsoft-edge/webview2/reference/win32/icorewebview2controlleroptions3?view=webview2-1.0.3296-prerelease&preserve-view=true#get_defaultbackgroundcolor)
1208-
* [ICoreWebView2ControllerOptions3::put_DefaultBackgroundColor](/microsoft-edge/webview2/reference/win32/icorewebview2controlleroptions3?view=webview2-1.0.3296-prerelease&preserve-view=true#put_defaultbackgroundcolor)
1209-
1210-
---
1211-
1212-
1213-
<!-- ------------------------------ -->
1214-
#### Bug fixes
1215-
1216-
1217-
<!-- ---------- -->
1218-
###### Runtime-only
1219-
1220-
* Fixed the **Find** bar no longer appearing after the window is shifted.
1221-
* Fixed a bug where the app wasn't able to cancel navigation to login pages via the `NavigationStarting` event.
1222-
* Fixed an issue where downloads from within the default browser frame didn't complete. ([Issue #5196](https://github.com/MicrosoftEdge/WebView2Feedback/issues/5196))
1223-
* Fixed an issue where the pipe name was incorrectly returned, leading to a crash in some UWP apps.
1224-
1225-
<!-- end of May 2025 Prerelease SDK -->
1226-
1227-
12281136
<!-- ====================================================================== -->
12291137
## See also
12301138

0 commit comments

Comments
 (0)