diff --git a/microsoft-edge/toc.yml b/microsoft-edge/toc.yml index 1e8b7f8868..46d9ac734f 100644 --- a/microsoft-edge/toc.yml +++ b/microsoft-edge/toc.yml @@ -1534,7 +1534,10 @@ - name: Release notes for the WebView2 Runtime href: ./webview2/release-notes/runtime/index.md - - name: Preview Runtime 153.0.4234.6 (Aug. 28, 2026) + - name: Preview Runtime 154.0.4255.0 (Sep. 3, 2026) + href: ./webview2/release-notes/runtime/154.md + + - name: Runtime nnn.n.nnnn.nn (Mmm. dd, yyyy) href: ./webview2/release-notes/runtime/153.md - name: Runtime 152.0.4191.53 (Aug. 28, 2026) @@ -1776,6 +1779,12 @@ - name: Release notes for WebView2 SDKs href: ./webview2/release-notes/sdk/index.md + - name: SDK 1.0.4255-prerelease, for Runtime 154 (Sep. 3, 2026) + href: ./webview2/release-notes/sdk/1-0-4255-prerelease.md + + - name: SDK n.n.nnnn.nn, for Runtime nnn (Mmm. dd, yyyy) + href: ./webview2/release-notes/sdk/n-n-nnnn-nn.md + - name: SDK 1.0.4191.47, for Runtime 152 (Aug. 28, 2026) href: ./webview2/release-notes/sdk/1-0-4191-47.md @@ -2401,9 +2410,6 @@ # ----------------------------------------------------------------------------- - name: Test and automation for WebView2 apps items: - - name: Test upcoming APIs and features - href: ./webview2/how-to/set-preview-channel.md - - name: Use the Chrome DevTools Protocol (CDP) in WebView2 apps href: ./webview2/how-to/chromium-devtools-protocol.md displayName: chrome developer protocol # catch mis-expansion @@ -2414,12 +2420,17 @@ - name: Automate and test WebView2 apps with Microsoft Edge WebDriver href: ./webview2/how-to/webdriver.md - - name: Prerelease testing using preview channels - href: ./webview2/how-to/prerelease-testing.md + - name: Prerelease testing using preview channels of Microsoft Edge + items: + - name: Prerelease testing using preview channels of Microsoft Edge # short article + href: ./webview2/how-to/prerelease-testing.md + + - name: Switch to a preview channel to test upcoming APIs and features # long article + href: ./webview2/how-to/set-preview-channel.md - - name: Self-host by deploying preview channels - href: ./webview2/how-to/self-hosting.md - displayName: self-hosting + - name: Self-host by deploying preview channels + href: ./webview2/how-to/self-hosting.md + displayName: self-hosting # ----------------------------------------------------------------------------- - name: Debug WebView2 apps items: diff --git a/microsoft-edge/webview2/concepts/developer-guide.md b/microsoft-edge/webview2/concepts/developer-guide.md index 7c823b49d4..56709015a6 100644 --- a/microsoft-edge/webview2/concepts/developer-guide.md +++ b/microsoft-edge/webview2/concepts/developer-guide.md @@ -52,7 +52,7 @@ When using the Evergreen WebView2 Runtime, run forward-compatibility tests by us Because the Evergreen Runtime updates automatically, you should regularly run compatibility tests to ensure that your WebView2 app will continue to work as expected on the new Runtime version. This can be done by testing your web content in the WebView2 control against the Microsoft Edge preview channels. -Follow the guidance in [Prerelease testing using preview channels](../how-to/prerelease-testing.md) and [Self-host by deploying preview channels](../how-to/self-hosting.md). +Follow the guidance in [Prerelease testing using preview channels of Microsoft Edge](../how-to/prerelease-testing.md) and [Self-host by deploying preview channels](../how-to/self-hosting.md). @@ -146,7 +146,7 @@ Follow the guidance in [Develop secure WebView2 apps](./security.md). * [The Fixed Version runtime distribution mode](./distribution.md#the-fixed-version-runtime-distribution-mode) in _Distribute your app and the WebView2 Runtime_. * [Handle Evergreen WebView2 Runtime updates](./distribution.md#handle-evergreen-webview2-runtime-updates) in _Distribute your app and the WebView2 Runtime_. * [Develop secure WebView2 apps](./security.md) -* [Prerelease testing using preview channels](../how-to/prerelease-testing.md) +* [Prerelease testing using preview channels of Microsoft Edge](../how-to/prerelease-testing.md) * [Self-host by deploying preview channels](../how-to/self-hosting.md) * [Manage user data folders](./user-data-folder.md) diff --git a/microsoft-edge/webview2/concepts/distribution.md b/microsoft-edge/webview2/concepts/distribution.md index 908b47b148..386a49488f 100644 --- a/microsoft-edge/webview2/concepts/distribution.md +++ b/microsoft-edge/webview2/concepts/distribution.md @@ -33,7 +33,7 @@ During development and testing, a WebView2 app can use either option as the back * The WebView2 Runtime. The Runtime generally provides the same web platform capabilities and update release cadence as the Stable channel of the Microsoft Edge browser; see [Microsoft Edge release schedule](/deployedge/microsoft-edge-release-schedule). Use the WebView2 Runtime in a production environment or to develop and test against the web platform that your users have today. -* A preview (Insider) Microsoft Edge browser channel. These Microsoft Edge preview channels are Beta, Dev, and Canary. Use this approach to test your app for forward-compatibility, so that you know if a breaking change is coming that will require updating your app. See [Test upcoming APIs and features](../how-to/set-preview-channel.md). +* A preview (Insider) Microsoft Edge browser channel. These Microsoft Edge preview channels are Beta, Dev, and Canary. Use this approach to test your app for forward-compatibility, so that you know if a breaking change is coming that will require updating your app. See [Switch to a preview channel to test upcoming APIs and features](../how-to/set-preview-channel.md). A production release of a WebView2 app can only use the WebView2 Runtime as the backing web platform, not Microsoft Edge. @@ -224,7 +224,7 @@ To use the new version of the WebView2 Runtime, you need to either release all r In the Evergreen distribution mode, the WebView2 Runtime is automatically kept up to date on the client to provide the latest features and security fixes. If you use Evergreen distribution, to ensure that your WebView2 app stays compatible with the web, you should set up testing infrastructure. -For best practices about how to test your app for forward-compatibility, see [Prerelease testing using preview channels](../how-to/prerelease-testing.md) and [Self-host by deploying preview channels](../how-to/self-hosting.md). +For best practices about how to test your app for forward-compatibility, see [Prerelease testing using preview channels of Microsoft Edge](../how-to/prerelease-testing.md) and [Self-host by deploying preview channels](../how-to/self-hosting.md). @@ -360,8 +360,8 @@ Example managed app folder structure: * [Feature-detecting to test whether the installed Runtime supports recently added APIs](./versioning.md#feature-detecting-to-test-whether-the-installed-runtime-supports-recently-added-apis) in _Prerelease and Release SDKs for WebView2_. * [Evergreen vs. fixed version of the WebView2 Runtime](./evergreen-vs-fixed-version.md) * [Windows Server Update Services (WSUS)](./enterprise.md#windows-server-update-services-wsus) in _Enterprise management of WebView2 Runtimes_. -* [Test upcoming APIs and features](../how-to/set-preview-channel.md) -* [Prerelease testing using preview channels](../how-to/prerelease-testing.md) +* [Switch to a preview channel to test upcoming APIs and features](../how-to/set-preview-channel.md) +* [Prerelease testing using preview channels of Microsoft Edge](../how-to/prerelease-testing.md) * [Self-host by deploying preview channels](../how-to/self-hosting.md) * [Distribute a WebView2 app as a single executable file](../how-to/static.md) - statically linking the WebView2 loader library. diff --git a/microsoft-edge/webview2/concepts/overview-features-apis.md b/microsoft-edge/webview2/concepts/overview-features-apis.md index 460a883c1c..716ecf8738 100644 --- a/microsoft-edge/webview2/concepts/overview-features-apis.md +++ b/microsoft-edge/webview2/concepts/overview-features-apis.md @@ -3681,8 +3681,8 @@ Runtime selection supports prerelease testing and self-hosting. When creating a * To specify which browser preview channels are searched for, use the `CoreWebView2EnvironmentOptions.ReleaseChannels` property. See also: -* [Test upcoming APIs and features](../how-to/set-preview-channel.md) -* [Prerelease testing using preview channels](../how-to/prerelease-testing.md) +* [Switch to a preview channel to test upcoming APIs and features](../how-to/set-preview-channel.md) +* [Prerelease testing using preview channels of Microsoft Edge](../how-to/prerelease-testing.md) * [Self-host by deploying preview channels](../how-to/self-hosting.md) ##### [.NET/C#](#tab/dotnetcsharp) diff --git a/microsoft-edge/webview2/concepts/security.md b/microsoft-edge/webview2/concepts/security.md index 03fe33ca86..999723c627 100644 --- a/microsoft-edge/webview2/concepts/security.md +++ b/microsoft-edge/webview2/concepts/security.md @@ -112,17 +112,17 @@ When the host process is running elevated: * [Setting browser flags programmatically through code](./webview-features-flags.md#setting-browser-flags-programmatically-through-code) in _WebView2 browser flags_. * `HKEY_CURRENT_USER` (`HKCU`) policy overrides are ignored. See: - * [Switching the channel search order (recommended)](../how-to/set-preview-channel.md#switching-the-channel-search-order-recommended) in _Test upcoming APIs and features_ - Select the **Registry key** tab, and then Find `HKCU`. - * [How to use `ChannelSearchKind` to ensure that a particular channel is used](../how-to/set-preview-channel.md#how-to-use-channelsearchkind-to-ensure-that-a-particular-channel-is-used) in _Test upcoming APIs and features_ - Select the **Registry key** tab, and then Find `HKCU`. - * [Setting the browser executable folder (for local testing)](../how-to/set-preview-channel.md#setting-the-browser-executable-folder-for-local-testing) in _Test upcoming APIs and features_ - Select the **Registry key** tab, and then Find `HKCU`. + * [Switching the channel search order (recommended)](../how-to/set-preview-channel.md#switching-the-channel-search-order-recommended) in _Switch to a preview channel to test upcoming APIs and features_ - Select the **Registry key** tab, and then Find `HKCU`. + * [How to use `ChannelSearchKind` to ensure that a particular channel is used](../how-to/set-preview-channel.md#how-to-use-channelsearchkind-to-ensure-that-a-particular-channel-is-used) in _Switch to a preview channel to test upcoming APIs and features_ - Select the **Registry key** tab, and then Find `HKCU`. + * [Setting the browser executable folder (for local testing)](../how-to/set-preview-channel.md#setting-the-browser-executable-folder-for-local-testing) in _Switch to a preview channel to test upcoming APIs and features_ - Select the **Registry key** tab, and then Find `HKCU`. * [Debug WebView2 apps with Visual Studio Code](../how-to/debug-visual-studio-code.md) - Find `HKEY_CURRENT_USER`. * `AdditionalBrowserArguments` registry overrides that are under `HKCU` are ignored. * `HKEY_LOCAL_MACHINE` (`HKLM`) policy overrides are honored. See: - * [Switching the channel search order (recommended)](../how-to/set-preview-channel.md#switching-the-channel-search-order-recommended) in _Test upcoming APIs and features_ - Select the **Registry key** tab, and then Find `HKLM`. - * [How to use `ChannelSearchKind` to ensure that a particular channel is used](../how-to/set-preview-channel.md#how-to-use-channelsearchkind-to-ensure-that-a-particular-channel-is-used) in _Test upcoming APIs and features_ - Select the **Registry key** tab, and then Find `HKLM`. - * [Setting the browser executable folder (for local testing)](../how-to/set-preview-channel.md#setting-the-browser-executable-folder-for-local-testing) in _Test upcoming APIs and features_ - Select the **Registry key** tab, and then Find `HKLM`. + * [Switching the channel search order (recommended)](../how-to/set-preview-channel.md#switching-the-channel-search-order-recommended) in _Switch to a preview channel to test upcoming APIs and features_ - Select the **Registry key** tab, and then Find `HKLM`. + * [How to use `ChannelSearchKind` to ensure that a particular channel is used](../how-to/set-preview-channel.md#how-to-use-channelsearchkind-to-ensure-that-a-particular-channel-is-used) in _Switch to a preview channel to test upcoming APIs and features_ - Select the **Registry key** tab, and then Find `HKLM`. + * [Setting the browser executable folder (for local testing)](../how-to/set-preview-channel.md#setting-the-browser-executable-folder-for-local-testing) in _Switch to a preview channel to test upcoming APIs and features_ - Select the **Registry key** tab, and then Find `HKLM`. Non-elevated WebView2 apps honor all of the supported override mechanisms. diff --git a/microsoft-edge/webview2/concepts/versioning.md b/microsoft-edge/webview2/concepts/versioning.md index 45b22e1d06..39f156f910 100644 --- a/microsoft-edge/webview2/concepts/versioning.md +++ b/microsoft-edge/webview2/concepts/versioning.md @@ -63,11 +63,11 @@ The Prerelease SDK package is a superset of the Release SDK package. A Prerelea Preview channels of Microsoft Edge provide the implementations of Experimental WebView2 APIs and of Stable APIs. The Experimental APIs are subject to change based on feedback. Avoid using a Prerelease SDK package to build production apps. -For information about temporarily pointing your app to a preview channel instead of defaulting to the WebView2 Runtime, see [Test upcoming APIs and features](../how-to/set-preview-channel.md). +For information about temporarily pointing your app to a preview channel instead of defaulting to the WebView2 Runtime, see [Switch to a preview channel to test upcoming APIs and features](../how-to/set-preview-channel.md). See also: * [Evergreen vs. fixed version of the WebView2 Runtime](./evergreen-vs-fixed-version.md) -* [Prerelease testing using preview channels](../how-to/prerelease-testing.md) +* [Prerelease testing using preview channels of Microsoft Edge](../how-to/prerelease-testing.md) * [Self-host by deploying preview channels](../how-to/self-hosting.md) @@ -212,8 +212,8 @@ If your code determines that an API is unavailable in the client's installed Web * [WebView2 deployment samples](../samples/deployment-samples.md) * [Evergreen vs. fixed version of the WebView2 Runtime](./evergreen-vs-fixed-version.md) * [Distribute your app and the WebView2 Runtime](./distribution.md) -* [Test upcoming APIs and features](../how-to/set-preview-channel.md) -* [Prerelease testing using preview channels](../how-to/prerelease-testing.md) +* [Switch to a preview channel to test upcoming APIs and features](../how-to/set-preview-channel.md) +* [Prerelease testing using preview channels of Microsoft Edge](../how-to/prerelease-testing.md) * [Self-host by deploying preview channels](../how-to/self-hosting.md) * [Phases of adding APIs](../release-notes/about.md#phases-of-adding-apis) in _About Release notes for the WebView2 SDK_. * [Release notes for WebView2](../release-notes/index.md) diff --git a/microsoft-edge/webview2/how-to/prerelease-testing.md b/microsoft-edge/webview2/how-to/prerelease-testing.md index 36d64d6b19..a2b34a6e16 100644 --- a/microsoft-edge/webview2/how-to/prerelease-testing.md +++ b/microsoft-edge/webview2/how-to/prerelease-testing.md @@ -1,5 +1,5 @@ --- -title: Prerelease testing using preview channels +title: Prerelease testing using preview channels of Microsoft Edge description: How to test your WebView2 app by using the preview channels of Microsoft Edge (Edge Canary, Edge Dev, or Edge Beta) to find issues that will affect your particular WebView2 app, before WebView2 changes reach the Evergreen WebView2 Runtime. author: MSEdgeTeam ms.author: msedgedevrel @@ -8,10 +8,14 @@ ms.service: microsoft-edge ms.subservice: webview ms.date: 04/22/2024 --- -# Prerelease testing using preview channels +# Prerelease testing using preview channels of Microsoft Edge + _Prerelease testing_ means testing your WebView2 app by using the preview channels of Microsoft Edge to find issues that will affect your particular WebView2 app, before any changes ship in the Stable Evergreen WebView2 Runtime. This helps catch any bugs before they degrade the app experience for end users. +See also: +* [Switch to a preview channel to test upcoming APIs and features](./set-preview-channel.md) + Conduct both automated and manual testing: * For **automated testing**, do **prerelease testing**, which means testing with a WebView2 Preview Runtime. Covered by the present article. * For **manual testing**, use **self-hosting**, which means deploying a WebView2 Preview Runtime with your app, to use daily by your team. See [Self-host by deploying preview channels](./self-hosting.md). @@ -38,12 +42,12 @@ To do automated testing: 1. **Set the preview channel for your app.** - You can set the preview channel by using `ChannelSearchKind`, so that your WebView2 app uses the least-stable channel (Canary, then Dev). To do this, see [Switching the channel search order (recommended)](./set-preview-channel.md#switching-the-channel-search-order-recommended) in _Test upcoming APIs and features_. + You can set the preview channel by using `ChannelSearchKind`, so that your WebView2 app uses the least-stable channel (Canary, then Dev). To do this, see [Switching the channel search order (recommended)](./set-preview-channel.md#switching-the-channel-search-order-recommended) in _Switch to a preview channel to test upcoming APIs and features_. 1. **Install or deploy the preview channel.** * If you choose to install preview channels manually, install them from the page [Become a Microsoft Edge Insider](https://www.microsoft.com/edge/download/insider). - * If you instead choose to deploy preview channels to devices, see [How to deploy preview channels](./set-preview-channel.md#how-to-deploy-preview-channels) in _Test upcoming APIs and features_. + * If you instead choose to deploy preview channels to devices, see [How to deploy preview channels](./set-preview-channel.md#how-to-deploy-preview-channels) in _Switch to a preview channel to test upcoming APIs and features_. 1. **Conduct automated testing on your app running against the preview channels.** @@ -60,7 +64,7 @@ Upon finding issues, you can report them via the [Microsoft Edge / WebView2Feedb ## See also * [Self-host by deploying preview channels](./self-hosting.md) -* [Test upcoming APIs and features](./set-preview-channel.md) +* [Switch to a preview channel to test upcoming APIs and features](./set-preview-channel.md) * [Automate and test WebView2 apps with Microsoft Edge WebDriver](./webdriver.md) * [Site compatibility-impacting changes coming to Microsoft Edge](../../web-platform/site-impacting-changes.md) * [WebView2 feedback repo](https://github.com/MicrosoftEdge/WebView2Feedback) diff --git a/microsoft-edge/webview2/how-to/self-hosting.md b/microsoft-edge/webview2/how-to/self-hosting.md index afe89b4847..6439e2f24f 100644 --- a/microsoft-edge/webview2/how-to/self-hosting.md +++ b/microsoft-edge/webview2/how-to/self-hosting.md @@ -15,7 +15,7 @@ _Self-hosting_ means deploying a WebView2 Preview Runtime with your app. This a The self-hosting approach provides real-world usage of your app with the latest WebView2 Preview Runtime to catch any issues that may arise. You should self-host your app in tandem with doing prerelease testing on your app, to provide a structured approach to testing your app with the latest version of the WebView2 Runtime. Conduct both automated and manual testing: -* For **automated testing**, do **prerelease testing**, which means testing with a WebView2 Preview Runtime. See [Prerelease testing using preview channels](./prerelease-testing.md). +* For **automated testing**, do **prerelease testing**, which means testing with a WebView2 Preview Runtime. See [Prerelease testing using preview channels of Microsoft Edge](./prerelease-testing.md). * For **manual testing**, use **self-hosting**, which means deploying a WebView2 Preview Runtime with your app, to use daily by your team. Covered by the present article. @@ -35,7 +35,7 @@ To self-host a preview channel of WebView2: 1. **Install the preview channel on your team's machines.** - To install preview channels on a small number of devices, you can download and install them manually from the page [Become a Microsoft Edge Insider](https://www.microsoft.com/edge/download/insider). To deploy preview channels to a large number of devices, see [How to deploy preview channels](./set-preview-channel.md#how-to-deploy-preview-channels) in _Test upcoming APIs and features_. + To install preview channels on a small number of devices, you can download and install them manually from the page [Become a Microsoft Edge Insider](https://www.microsoft.com/edge/download/insider). To deploy preview channels to a large number of devices, see [How to deploy preview channels](./set-preview-channel.md#how-to-deploy-preview-channels) in _Switch to a preview channel to test upcoming APIs and features_. 1. **Use your app daily with the preview channel of WebView2, and diagnose potential issues with the WebView2 Runtime.** @@ -83,8 +83,8 @@ If you are using the API, then we recommend building UI in your app that allows ## See also -* [Test upcoming APIs and features](./set-preview-channel.md) -* [Prerelease testing using preview channels](./prerelease-testing.md) +* [Switch to a preview channel to test upcoming APIs and features](./set-preview-channel.md) +* [Prerelease testing using preview channels of Microsoft Edge](./prerelease-testing.md) * [Site compatibility-impacting changes coming to Microsoft Edge](../../web-platform/site-impacting-changes.md) External: diff --git a/microsoft-edge/webview2/how-to/set-preview-channel.md b/microsoft-edge/webview2/how-to/set-preview-channel.md index 3b5481888a..bfc1133c7f 100644 --- a/microsoft-edge/webview2/how-to/set-preview-channel.md +++ b/microsoft-edge/webview2/how-to/set-preview-channel.md @@ -1,5 +1,5 @@ --- -title: Test upcoming APIs and features +title: Switch to a preview channel to test upcoming APIs and features description: How to specify a Microsoft Edge preview channel to use, to test experimental APIs in a prerelease package. author: MSEdgeTeam ms.author: msedgedevrel @@ -8,13 +8,32 @@ ms.service: microsoft-edge ms.subservice: webview ms.date: 04/22/2024 --- -# Test upcoming APIs and features - + This article explains how to switch to a preview channel of Microsoft Edge, to test experimental APIs that are in a WebView2 Prerelease SDK package. +**Detailed contents:** +* [Use a preview channel of WebView2 to test your app against the most recent experimental WebView2 APIs](#use-a-preview-channel-of-webview2-to-test-your-app-against-the-most-recent-experimental-webview2-apis) + * [Interplay between the WebView2 Prerelease SDK and Microsoft Edge Preview Channels](#interplay-between-the-webview2-prerelease-sdk-and-microsoft-edge-preview-channels) + * [Forward-compatibility testing by using the preview channel](#forward-compatibility-testing-by-using-the-preview-channel) +* [Downloading the prerelease SDK and a preview channel](#downloading-the-prerelease-sdk-and-a-preview-channel) +* [Approaches to making your app use a specific browser channel](#approaches-to-making-your-app-use-a-specific-browser-channel) + * [Switching the channel search order (recommended)](#switching-the-channel-search-order-recommended) + * [How to use ChannelSearchKind to ensure that a particular channel is used](#how-to-use-channelsearchkind-to-ensure-that-a-particular-channel-is-used) + * [Setting the browser executable folder (for local testing)](#setting-the-browser-executable-folder-for-local-testing) +* [When the new runtime gets picked up](#when-the-new-runtime-gets-picked-up) +* [How to set an environment variable](#how-to-set-an-environment-variable) + * [Setting environmental variables by using APIs, for a specific app](#setting-environmental-variables-by-using-apis-for-a-specific-app) + * [Setting environmental variables globally, for all apps](#setting-environmental-variables-globally-for-all-apps) +* [How to deploy preview channels](#how-to-deploy-preview-channels) + * [Option 1: Manually install preview channels on machines](#option-1-manually-install-preview-channels-on-machines) + * [Option 2: Programmatically deploy preview channels via API endpoints](#option-2-programmatically-deploy-preview-channels-via-api-endpoints) +* [See also](#see-also) + +See also: +* [Prerelease testing using preview channels of Microsoft Edge](./prerelease-testing.md) + To test new or forthcoming APIs and features, switch to a Microsoft Edge preview channel rather than using the stable WebView2 Runtime. The Evergreen WebView2 Runtime is updated frequently to add new APIs and functionalities. These updates can include APIs have been promoted from `Experimental` in a Prerelease WebView2 SDK to `Stable` in the WebView2 Release SDK. Some of the updates in the Evergreen WebView2 Runtime could potentially break your WebView2 app. We recommend that you test the Experimental APIs ahead of time, before they are promoted to Stable in the WebView2 Release SDK, by switching to a preview channel of Microsoft Edge (which includes WebView2), to ensure that your app is forward-compatible. @@ -25,7 +44,7 @@ See also: -#### Use a preview channel of WebView2 to test your app against the most recent experimental WebView2 APIs +## Use a preview channel of WebView2 to test your app against the most recent experimental WebView2 APIs The Evergreen WebView2 Runtime doesn't include experimental WebView2 APIs. Instead, to use these experimental features in your WebView2 code, have your app use the version of WebView2 that is in a Microsoft Edge preview channel (Edge Beta, Edge Dev, or Edge Canary). @@ -47,7 +66,7 @@ For more information about how SDK versions interact with the WebView2 Runtime a We recommend that you test upcoming changes using preview channels to ensure your app's forward compatibility, by following these best practices: -* [Prerelease testing using preview channels](./prerelease-testing.md) +* [Prerelease testing using preview channels of Microsoft Edge](./prerelease-testing.md) * [Self-host by deploying preview channels](./self-hosting.md) @@ -70,15 +89,13 @@ When a WebView2 is initialized, it will attempt to find a valid runtime on the m There are two ways to make your WebView2 app use a specific preview channel of Microsoft Edge: -* [Switching the channel search order (recommended)](#switching-the-channel-search-order-recommended). +* [Switching the channel search order (recommended)](#switching-the-channel-search-order-recommended), below. -* [Setting the browser executable folder (for local testing)](#setting-the-browser-executable-folder-for-local-testing). - -These approaches are described below. +* [Setting the browser executable folder (for local testing)](#setting-the-browser-executable-folder-for-local-testing), below. - -## Switching the channel search order (recommended) + +#### Switching the channel search order (recommended) This section applies to using an API, registry override, environment variable, or group policy. @@ -165,8 +182,8 @@ Do either of the following: --- - -## How to use `ChannelSearchKind` to ensure that a particular channel is used + +###### How to use `ChannelSearchKind` to ensure that a particular channel is used When using `ChannelSearchKind`, here's how you can make sure that a certain preview browser channel is used when you have multiple preview browser channels installed. @@ -244,10 +261,10 @@ Do either of the following: --- - -## Setting the browser executable folder (for local testing) + +#### Setting the browser executable folder (for local testing) -An alternative approach is to use a browser executable folder. In this approach, you specify a folder that contains runtime binaries. This folder can be any of the following locations: +An alternative approach instead of [Switching the channel search order (recommended)](#switching-the-channel-search-order-recommended), above, is to use a browser executable folder. In this approach, you specify a folder that contains runtime binaries. This folder can be any of the following locations: * The installed location of the WebView2 Runtime. * A preview channel of Microsoft Edge. * A folder containing Fixed Version binaries that you have deployed to the machine yourself. @@ -428,7 +445,7 @@ In your app's code, write your own custom logic to deploy the latest version of ## See also -* [Prerelease testing using preview channels](./prerelease-testing.md) +* [Prerelease testing using preview channels of Microsoft Edge](./prerelease-testing.md) * [Self-host by deploying preview channels](./self-hosting.md) * [Phases of introducing APIs](../concepts/versioning.md#phases-of-introducing-apis) in _Prerelease and Release SDKs for WebView2_. * [Distribute your app and the WebView2 Runtime](../concepts/distribution.md) diff --git a/microsoft-edge/webview2/how-to/webdriver.md b/microsoft-edge/webview2/how-to/webdriver.md index 4b116c1e66..2073e61663 100644 --- a/microsoft-edge/webview2/how-to/webdriver.md +++ b/microsoft-edge/webview2/how-to/webdriver.md @@ -241,7 +241,7 @@ For more info about the `DebuggerAddress` property of the `EdgeOptions` object, 1. Do the steps in [Remote debugging UWP apps with Remote Tools for Microsoft Edge](./remote-debugging.md). - This WebView2 feature is currently only supported in the Canary preview channel of Microsoft Edge. Set the environment variable `WEBVIEW2_RELEASE_CHANNEL_PREFERENCE=1`, to ensure that the WebView2 version is Canary. For more information, see [How to set an environment variable](./set-preview-channel.md#how-to-set-an-environment-variable) in _Test upcoming APIs and features_. + This WebView2 feature is currently only supported in the Canary preview channel of Microsoft Edge. Set the environment variable `WEBVIEW2_RELEASE_CHANNEL_PREFERENCE=1`, to ensure that the WebView2 version is Canary. For more information, see [How to set an environment variable](./set-preview-channel.md#how-to-set-an-environment-variable) in _Switch to a preview channel to test upcoming APIs and features_. ![Settings for UWP app](./webdriver-images/sample-uwp-settings.png) diff --git a/microsoft-edge/webview2/landing/index.yml b/microsoft-edge/webview2/landing/index.yml index 355207a3b5..805f7ac8f9 100644 --- a/microsoft-edge/webview2/landing/index.yml +++ b/microsoft-edge/webview2/landing/index.yml @@ -200,7 +200,7 @@ landingContent: linkLists: - linkListType: how-to-guide links: - - text: Test upcoming APIs and features + - text: Switch to a preview channel to test upcoming APIs and features url: ../how-to/set-preview-channel.md - text: Use the Chrome DevTools Protocol (CDP) in WebView2 apps @@ -212,7 +212,7 @@ landingContent: - text: Automate and test WebView2 apps with Microsoft Edge WebDriver url: ../how-to/webdriver.md - - text: Prerelease testing using preview channels + - text: Prerelease testing using preview channels of Microsoft Edge url: ../how-to/prerelease-testing.md - text: Self-host by deploying preview channels diff --git a/microsoft-edge/webview2/release-notes/includes/runtime-preview-template.md b/microsoft-edge/webview2/release-notes/includes/runtime-preview-template.md index c554db6247..d944ec8d95 100644 --- a/microsoft-edge/webview2/release-notes/includes/runtime-preview-template.md +++ b/microsoft-edge/webview2/release-notes/includes/runtime-preview-template.md @@ -14,7 +14,7 @@ ms.date: 01/01/2026 Release notes for Microsoft Edge WebView2 Preview Runtime, release date: Mmm. dd, yyyy. -This is a Preview Runtime, for early testing. Prerelease testing of WebView2 SDKs uses a preview channel of Microsoft Edge (Beta, Dev, or Canary), which includes the WebView2 Preview Runtime. See [Prerelease testing using preview channels](../../how-to/prerelease-testing.md). +This is a Preview Runtime, for early testing. Prerelease testing of WebView2 SDKs uses a preview channel of Microsoft Edge (Beta, Dev, or Canary), which includes the WebView2 Preview Runtime. See [Prerelease testing using preview channels of Microsoft Edge](../../how-to/prerelease-testing.md). diff --git a/microsoft-edge/webview2/release-notes/includes/sdk-prerelease-template.md b/microsoft-edge/webview2/release-notes/includes/sdk-prerelease-template.md index d6dfdb2f33..eadaaef180 100644 --- a/microsoft-edge/webview2/release-notes/includes/sdk-prerelease-template.md +++ b/microsoft-edge/webview2/release-notes/includes/sdk-prerelease-template.md @@ -12,9 +12,9 @@ ms.date: 01/01/2026 Release notes for Microsoft Edge WebView2 Prerelease SDK, release date: Mmm. dd, yyyy. -[NuGet package for WebView2 SDK n.n.nnnn-prerelease] (https://www.nuget.org/packages/Microsoft.Web.WebView2/n.n.nnnn-prerelease) +[NuGet package for WebView2 SDK n.n.nnnn-prerelease] (`https://www.nuget.org/packages/Microsoft.Web.WebView2/n.n.nnnn-prerelease`) -For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version nnn.n.nnnn.n or later. +For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version nnn.n.nnnn.n or later; see [Runtime nnn.n.nnnn.nn (Mmm. dd, yyyy)] (../runtime/nnn.md). diff --git a/microsoft-edge/webview2/release-notes/includes/sdk-release-template.md b/microsoft-edge/webview2/release-notes/includes/sdk-release-template.md index b72d8f1e78..08d01eb5ad 100644 --- a/microsoft-edge/webview2/release-notes/includes/sdk-release-template.md +++ b/microsoft-edge/webview2/release-notes/includes/sdk-release-template.md @@ -12,9 +12,9 @@ ms.date: 01/01/2026 Release notes for Microsoft Edge WebView2 SDK, release date: Mmm. dd, yyyy. -[NuGet package for WebView2 SDK n.n.nnnn.nn] (https://www.nuget.org/packages/Microsoft.Web.WebView2/n.n.nnnn.nn) +[NuGet package for WebView2 SDK n.n.nnnn.nn] (`https://www.nuget.org/packages/Microsoft.Web.WebView2/n.n.nnnn.nn`) -For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version nnn.n.nnnn.nn or later. +For full API compatibility, this Release version of the WebView2 SDK requires WebView2 [Runtime nnn.n.nnnn.nn (Mmm. dd, yyyy)] (../runtime/nnn.md) or later. diff --git a/microsoft-edge/webview2/release-notes/runtime/153.md b/microsoft-edge/webview2/release-notes/runtime/153.md index bb2524a953..8bbf4ee991 100644 --- a/microsoft-edge/webview2/release-notes/runtime/153.md +++ b/microsoft-edge/webview2/release-notes/runtime/153.md @@ -1,20 +1,17 @@ --- -title: Preview Runtime 153.0.4234.6 (Aug. 28, 2026) -description: Release notes for Microsoft Edge WebView2 Preview Runtime 153.0.4234.6. +title: Runtime nnn.n.nnnn.nn (Mmm. dd, yyyy) +description: Release notes for Microsoft Edge WebView2 Runtime nnn.n.nnnn.nn. author: MSEdgeTeam ms.author: msedgedevrel ms.topic: article ms.service: microsoft-edge ms.subservice: webview -ms.date: 08/28/2026 +ms.date: 09/07/2026 --- -# Preview Runtime 153.0.4234.6 (Aug. 28, 2026) +# Runtime nnn.n.nnnn.nn (Mmm. dd, yyyy) -Release notes for Microsoft Edge WebView2 Preview Runtime, release date: Aug. 28, 2026. - - -This is a Preview Runtime, for early testing. Prerelease testing of WebView2 SDKs uses a preview channel of Microsoft Edge (Beta, Dev, or Canary), which includes the WebView2 Preview Runtime. See [Prerelease testing using preview channels](../../how-to/prerelease-testing.md). +Release notes for Microsoft Edge WebView2 Runtime, release date: Aug. 28, 2026. @@ -36,6 +33,8 @@ This is a Preview Runtime, for early testing. Prerelease testing of WebView2 SD ## See also +* [SDK n.n.nnnn.nn, for Runtime nnn (Mmm. dd, yyyy)] (../sdk/n-n-nnnn-nn.md) +* [SDK n.n.nnnn-prerelease, for Runtime nnn (Mmm. dd, yyyy)] (../sdk/n-n-nnnn-prerelease.md) * [Release notes for WebView2](../index.md) * [Release notes for the WebView2 Runtime](./index.md) * [Release notes for WebView2 SDKs](../sdk/index.md) diff --git a/microsoft-edge/webview2/release-notes/runtime/154.md b/microsoft-edge/webview2/release-notes/runtime/154.md new file mode 100644 index 0000000000..31fcb11bf4 --- /dev/null +++ b/microsoft-edge/webview2/release-notes/runtime/154.md @@ -0,0 +1,42 @@ +--- +title: Preview Runtime 154.0.4255.0 (Sep. 3, 2026) +description: Release notes for Microsoft Edge WebView2 Preview Runtime 154.0.4255.0. +author: MSEdgeTeam +ms.author: msedgedevrel +ms.topic: article +ms.service: microsoft-edge +ms.subservice: webview +ms.date: 09/03/2026 +--- +# Preview Runtime 154.0.4255.0 (Sep. 3, 2026) + + +Release notes for Microsoft Edge WebView2 Preview Runtime, release date: Sep. 3, 2026. + + +This is a Preview Runtime, for early testing; specifically, the Beta (rather than Dev or Canary) Runtime build. +Prerelease testing of WebView2 SDKs uses a preview channel of Microsoft Edge (Beta, Dev, or Canary), which includes the WebView2 Preview Runtime. +We recommend testing your app against the Beta preview channel of Microsoft Edge (to test against the Preview Runtime) before these changes are promoted to Stable. +These release notes are for the WebView2 Preview Runtime, which corresponds to the Beta (two-week release cadence) preview channel of Microsoft Edge. +If you want to test even earlier, you can test against Edge Dev (weekly release cadence) or Edge Canary (daily release cadence). + +_todo: finalize the above lead-in, copy to runtime-preview-template.md_ + +See [Prerelease testing using preview channels of Microsoft Edge](../../how-to/prerelease-testing.md). + + + +#### Bug fixes + +* Fixed downloads to be submitted for antivirus scanning under the host app's identity instead of the shared runtime's. + +* Fixed Mark-of-the-Web prompt state so it is tracked per host app instead of per shared WebView2 runtime. + + + +## See also + +* [SDK 1.0.4255-prerelease, for Runtime 154 (Sep. 3, 2026)](../sdk/1-0-4255-prerelease.md) +* [Release notes for WebView2](../index.md) + * [Release notes for the WebView2 Runtime](./index.md) + * [Release notes for WebView2 SDKs](../sdk/index.md) diff --git a/microsoft-edge/webview2/release-notes/runtime/index.md b/microsoft-edge/webview2/release-notes/runtime/index.md index c628cd4fda..5e23ccc4f9 100644 --- a/microsoft-edge/webview2/release-notes/runtime/index.md +++ b/microsoft-edge/webview2/release-notes/runtime/index.md @@ -15,7 +15,8 @@ list past 10 releases (runtimes) in toc.yml, add new relnotes pages, move relnotes pages to archive in /webview2/release-notes/runtime/index.md, add new relnotes link, remove earliest relnotes link --> Release notes for recent Runtimes: -* [Preview Runtime 153.0.4234.6 (Aug. 28, 2026)](./153.md) +* [Preview Runtime 154.0.4255.0 (Sep. 3, 2026)](./154.md) +* [Runtime nnn.n.nnnn.nn (Mmm. dd, yyyy)](./153.md) * [Runtime 152.0.4191.53 (Aug. 28, 2026)](./152.md) * [Runtime 151.0.4129.50 (Aug. 3, 2026)](./151.md) * [Runtime 150.0.4078.44 (Jul. 7, 2026)](./150.md) @@ -53,7 +54,7 @@ Make sure to re-compile your WebView2 app after updating the WebView2 SDK NuGet Canary is the recommended preview channel, because it ships at the fastest cadence and has the newest APIs. - Prerelease testing of WebView2 SDKs uses a preview channel of Microsoft Edge (Beta, Dev, or Canary), which includes the WebView2 Preview Runtime. See [Prerelease testing using preview channels](../../how-to/prerelease-testing.md). + Prerelease testing of WebView2 SDKs uses a preview channel of Microsoft Edge (Beta, Dev, or Canary), which includes the WebView2 Preview Runtime. See [Prerelease testing using preview channels of Microsoft Edge](../../how-to/prerelease-testing.md). * Use the Evergreen WebView2 Runtime when you use a release version of the WebView2 SDK package. @@ -86,7 +87,7 @@ See also: To load WebView2, the minimum version of Microsoft Edge or the WebView2 Runtime is 86.0.616.0; see [Runtime 86.0.705.50 (Jan. 25, 2021)](./86.md). The minimum version to load WebView2 only changes when a breaking change occurs in the web platform. -To use a Prerelease SDK along with a Microsoft Edge preview channel (containing the WebView2 Preview Runtime), see [Test upcoming APIs and features](../../how-to/set-preview-channel.md). +To use a Prerelease SDK along with a Microsoft Edge preview channel (containing the WebView2 Preview Runtime), see [Switch to a preview channel to test upcoming APIs and features](../../how-to/set-preview-channel.md). +## Experimental APIs (Phase 1: Experimental in Prerelease) + +The following APIs are in Phase 1: Experimental in Prerelease, and have been added in this Prerelease SDK. + +todo: sync list in 3 tabs: + +##### [.NET/C#](#tab/dotnetcsharp) + +* [CoreWebView2ClusterEnvironmentCreateResult Class](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentcreateresult?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentCreateResult.Environment Property](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentcreateresult.environment?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentCreateResult.Status Property](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentcreateresult.status?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + +* [CoreWebView2ClusterEnvironmentOptions Class](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentoptions?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentOptions. Method](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentoptions.?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentOptions.AdditionalBrowserArguments Property](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentoptions.additionalbrowserarguments?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentOptions.AllowSingleSignOnUsingOSPrimaryAccount Property](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentoptions.allowsinglesignonusingosprimaryaccount?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentOptions.AreBrowserExtensionsEnabled Property](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentoptions.arebrowserextensionsenabled?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentOptions.ChannelSearchKind Property](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentoptions.channelsearchkind?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentOptions.ClusterName Property](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentoptions.clustername?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentOptions.CustomSchemeRegistrations Property](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentoptions.customschemeregistrations?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentOptions.EnableTrackingPrevention Property](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentoptions.enabletrackingprevention?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentOptions.Language Property](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentoptions.language?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentOptions.PerHostProfileIsolation Property](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentoptions.perhostprofileisolation?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentOptions.ReleaseChannels Property](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentoptions.releasechannels?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + +* [CoreWebView2ClusterEnvironmentStatus Class](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentstatus?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentStatus.NotSupported Enum Value](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentstatus?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentStatus.OptionsMismatch Enum Value](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentstatus?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentStatus.Succeeded Enum Value](/dotnet/api/microsoft.web.webview2.core.corewebview2clusterenvironmentstatus?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + +* CoreWebView2Environment: + * [CoreWebView2Environment.CreateOrJoinClusterEnvironmentAsync Method](/dotnet/api/microsoft.web.webview2.core.corewebview2environment.createorjoinclusterenvironmentasync?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2Environment.GetClusterEnvironmentOptions Method](/dotnet/api/microsoft.web.webview2.core.corewebview2environment.getclusterenvironmentoptions?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + +* CoreWebView2Frame: + * [CoreWebView2Frame.LaunchingExternalUriScheme Event](/dotnet/api/microsoft.web.webview2.core.corewebview2frame.launchingexternalurischeme?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + +* CoreWebView2LaunchingExternalUriSchemeEventArgs: + * [CoreWebView2LaunchingExternalUriSchemeEventArgs.Handled Property](/dotnet/api/microsoft.web.webview2.core.corewebview2launchingexternalurischemeeventargs.handled?view=webview2-dotnet-1.0.4255-prerelease&preserve-view=true) + +##### [WinRT/C#](#tab/winrtcsharp) + +* [CoreWebView2ClusterEnvironmentCreateResult Class](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentcreateresult?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentCreateResult.Environment Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentcreateresult?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true#environment) + * [CoreWebView2ClusterEnvironmentCreateResult.Status Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentcreateresult?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true#status) + +* [CoreWebView2ClusterEnvironmentOptions Class](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentoptions?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2ClusterEnvironmentOptions.AdditionalBrowserArguments Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentoptions?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true#additionalbrowserarguments) + * [CoreWebView2ClusterEnvironmentOptions.AllowSingleSignOnUsingOSPrimaryAccount Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentoptions?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true#allowsinglesignonusingosprimaryaccount) + * [CoreWebView2ClusterEnvironmentOptions.AreBrowserExtensionsEnabled Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentoptions?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true#arebrowserextensionsenabled) + * [CoreWebView2ClusterEnvironmentOptions.ChannelSearchKind Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentoptions?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true#channelsearchkind) + * [CoreWebView2ClusterEnvironmentOptions.ClusterName Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentoptions?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true#clustername) + * [CoreWebView2ClusterEnvironmentOptions.CustomSchemeRegistrations Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentoptions?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true#customschemeregistrations) + * [CoreWebView2ClusterEnvironmentOptions.EnableTrackingPrevention Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentoptions?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true#enabletrackingprevention) + * [CoreWebView2ClusterEnvironmentOptions.Handled Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentoptions?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true#handled) + * [CoreWebView2ClusterEnvironmentOptions.Language Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentoptions?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true#language) + * [CoreWebView2ClusterEnvironmentOptions.PerHostProfileIsolation Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentoptions?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true#perhostprofileisolation) + * [CoreWebView2ClusterEnvironmentOptions.ReleaseChannels Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentoptions?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true#releasechannels) + +* [CoreWebView2ClusterEnvironmentStatus Enum](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2clusterenvironmentstatus?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true) + +* [CoreWebView2Frame Class](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2frame?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2Frame.LaunchingExternalUriScheme Event](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2frame?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true#launchingexternalurischeme) + +* [CoreWebView2LaunchingExternalUriSchemeEventArgs Class](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2launchingexternalurischemeeventargs?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true) + * [CoreWebView2LaunchingExternalUriSchemeEventArgs.IAsyncOperation Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2launchingexternalurischemeeventargs?view=webview2-winrt-1.0.4255-prerelease&preserve-view=true#iasyncoperation) + +##### [Win32/C++](#tab/win32cpp) + +* [ICoreWebView2ExperimentalClusterEnvironmentCreateResult](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentcreateresult?view=webview2-1.0.4255-prerelease&preserve-view=true) + * [ICoreWebView2ExperimentalClusterEnvironmentCreateResult::get_Environment](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentcreateresult?view=webview2-1.0.4255-prerelease&preserve-view=true#get_environment) + * [ICoreWebView2ExperimentalClusterEnvironmentCreateResult::get_Status](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentcreateresult?view=webview2-1.0.4255-prerelease&preserve-view=true#get_status) + +* [ICoreWebView2ExperimentalClusterEnvironmentOptions](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::get_AdditionalBrowserArguments](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#get_additionalbrowserarguments) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::get_AllowSingleSignOnUsingOSPrimaryAccount](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#get_allowsinglesignonusingosprimaryaccount) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::get_AreBrowserExtensionsEnabled](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#get_arebrowserextensionsenabled) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::get_ChannelSearchKind](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#get_channelsearchkind) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::get_ClusterName](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#get_clustername) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::get_EnableTrackingPrevention](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#get_enabletrackingprevention) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::get_Language](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#get_language) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::get_PerHostProfileIsolation](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#get_perhostprofileisolation) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::get_ReleaseChannels](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#get_releasechannels) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::GetCustomSchemeRegistrations](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#getcustomschemeregistrations) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::put_AdditionalBrowserArguments](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#put_additionalbrowserarguments) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::put_AllowSingleSignOnUsingOSPrimaryAccount](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#put_allowsinglesignonusingosprimaryaccount) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::put_AreBrowserExtensionsEnabled](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#put_arebrowserextensionsenabled) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::put_ChannelSearchKind](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#put_channelsearchkind) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::put_ClusterName](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#put_clustername) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::put_EnableTrackingPrevention](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#put_enabletrackingprevention) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::put_Language](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#put_language) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::put_PerHostProfileIsolation](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#put_perhostprofileisolation) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::put_ReleaseChannels](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#put_releasechannels) + * [ICoreWebView2ExperimentalClusterEnvironmentOptions::SetCustomSchemeRegistrations](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalclusterenvironmentoptions?view=webview2-1.0.4255-prerelease&preserve-view=true#setcustomschemeregistrations) + +* [ICoreWebView2ExperimentalCreateOrJoinClusterEnvironmentCompletedHandler](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalcreateorjoinclusterenvironmentcompletedhandler?view=webview2-1.0.4255-prerelease&preserve-view=true) + +* [ICoreWebView2ExperimentalFrame10](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalframe10?view=webview2-1.0.4255-prerelease&preserve-view=true) + * [ICoreWebView2ExperimentalFrame10::add_LaunchingExternalUriScheme](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalframe10?view=webview2-1.0.4255-prerelease&preserve-view=true#add_launchingexternalurischeme) + * [ICoreWebView2ExperimentalFrame10::remove_LaunchingExternalUriScheme](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalframe10?view=webview2-1.0.4255-prerelease&preserve-view=true#remove_launchingexternalurischeme) + +* [ICoreWebView2ExperimentalFrameLaunchingExternalUriSchemeEventHandler](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalframelaunchingexternalurischemeeventhandler?view=webview2-1.0.4255-prerelease&preserve-view=true) + +* [ICoreWebView2ExperimentalLaunchingExternalUriSchemeEventArgs2](/microsoft-edge/webview2/reference/win32/icorewebview2experimentallaunchingexternalurischemeeventargs2?view=webview2-1.0.4255-prerelease&preserve-view=true) + * [ICoreWebView2ExperimentalLaunchingExternalUriSchemeEventArgs2::get_Handled](/microsoft-edge/webview2/reference/win32/icorewebview2experimentallaunchingexternalurischemeeventargs2?view=webview2-1.0.4255-prerelease&preserve-view=true#get_handled) + * [ICoreWebView2ExperimentalLaunchingExternalUriSchemeEventArgs2::put_Handled](/microsoft-edge/webview2/reference/win32/icorewebview2experimentallaunchingexternalurischemeeventargs2?view=webview2-1.0.4255-prerelease&preserve-view=true#put_handled) + +* [COREWEBVIEW2_CLUSTER_ENVIRONMENT_STATUS Enum](/microsoft-edge/webview2/reference/win32/webview2-idl-experimental?view=webview2-1.0.4255-prerelease&preserve-view=true#corewebview2_cluster_environment_status) + * `COREWEBVIEW2_CLUSTER_ENVIRONMENT_STATUS_NOT_SUPPORTED` + * `COREWEBVIEW2_CLUSTER_ENVIRONMENT_STATUS_OPTIONS_MISMATCH` + * `COREWEBVIEW2_CLUSTER_ENVIRONMENT_STATUS_SUCCEEDED` + +--- + + + +## See also + +* [Preview Runtime 154.0.4255.0 (Sep. 3, 2026)](../runtime/154.md) +* [Release notes for WebView2](../index.md) + * [Release notes for the WebView2 Runtime](../runtime/index.md) + * [Release notes for WebView2 SDKs](./index.md) diff --git a/microsoft-edge/webview2/release-notes/sdk/index.md b/microsoft-edge/webview2/release-notes/sdk/index.md index daa3caa3d2..68ebb4efbc 100644 --- a/microsoft-edge/webview2/release-notes/sdk/index.md +++ b/microsoft-edge/webview2/release-notes/sdk/index.md @@ -15,6 +15,8 @@ list past 10 releases in toc.yml, add new relnotes pages, move relnotes pages to archive in /webview2/release-notes/sdk/index.md, add new relnotes links, remove earliest relnotes links --> Release notes for recent SDKs: +* [SDK 1.0.4255-prerelease, for Runtime 154 (Sep. 3, 2026)](./1-0-4255-prerelease.md) +* [SDK n.n.nnnn.nn, for Runtime nnn (Mmm. dd, yyyy)](./n-n-nnnn-nn.md) * [SDK 1.0.4191.47, for Runtime 152 (Aug. 28, 2026)](./1-0-4191-47.md) * [SDK 1.0.4181-prerelease, for Runtime 152 (Aug. 3, 2026)](./1-0-4181-prerelease.md) * [SDK 1.0.4129.50, for Runtime 151 (Aug. 3, 2026)](./1-0-4129-50.md) @@ -126,7 +128,7 @@ See also: To load WebView2, the minimum version of Microsoft Edge or the WebView2 Runtime is 86.0.616.0; see [Runtime 86.0.705.50 (Jan. 25, 2021)](../runtime/86.md). The minimum version to load WebView2 only changes when a breaking change occurs in the web platform. -To use a Prerelease SDK along with a Microsoft Edge preview channel, see [Test upcoming APIs and features](../../how-to/set-preview-channel.md). +To use a Prerelease SDK along with a Microsoft Edge preview channel, see [Switch to a preview channel to test upcoming APIs and features](../../how-to/set-preview-channel.md). + + + +## Breaking changes + + + +#### heading + + + +## General changes + + + +#### heading + + + +## Promotions to Phase 3 (Stable in Release) + +The following APIs have been promoted from Phase 2: Stable in Prerelease, to Phase 3: Stable in Release, and are now included in this Release SDK. + + + +#### heading + +description + +Previous phase: [~] (./~.md#~) in _~_. + +##### [.NET/C#](#tab/dotnetcsharp) + +##### [WinRT/C#](#tab/winrtcsharp) + +##### [Win32/C++](#tab/win32cpp) + +--- + + + +## Bug fixes + +* Fixed behavior. ([Issue #] ()) + + + +## See also + +* [Release notes for WebView2](./index.md)