Skip to content

Commit 6fdde7f

Browse files
committed
documentation update
1 parent e4e83b7 commit 6fdde7f

File tree

1 file changed

+10
-11
lines changed

1 file changed

+10
-11
lines changed

specs/EnhancedSecurityModeLevel.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -26,14 +26,13 @@ the `--sdsm-state` browser feature flag ([webview2 browser flag docs](https://le
2626
The setting applies globally to all profiles and cannot be changed at runtime.
2727

2828
This proposal introduces an API to configure the Enhanced Security Mode level.
29-
The configuration is persisted for a WebView2 profile within the user data folder.
29+
The configuration is not persisted to the user data folder. The property is reset when the profile is recreated.
3030

3131
# Description
3232

3333
The `EnhancedSecurityModeLevel` property allows you to control the Enhanced Security
34-
Mode level for WebView2 instances associated with a profile. This level applies to the
35-
context of the profile. That is, all WebView2s sharing the same profile are affected
36-
and the value is persisted in the user data folder.
34+
Mode level for WebView2 instances associated with a profile. This level applies to the context of the profile. That is, all WebView2s sharing the same profile are affected.
35+
The configuration is not persisted to the user data folder. The property is reset when the profile is recreated.
3736

3837
The default value is `COREWEBVIEW2_ENHANCED_SECURITY_MODE_LEVEL_OFF`.
3938

@@ -42,11 +41,11 @@ When set to `Off`, Enhanced Security Mode is completely disabled. When set to
4241

4342
See `COREWEBVIEW2_ENHANCED_SECURITY_MODE_LEVEL` for descriptions of levels.
4443

45-
Changes apply to future navigations; reload may be required to see the effect.
44+
Changes apply to future navigations; a reload may be required for the change to take effect.
4645

4746
# Examples
4847

49-
## EnhancedSecurityModeLevel
48+
## Setting the ESM Level
5049

5150
Set Enhanced Security Mode level for a profile.
5251

@@ -95,7 +94,7 @@ typedef enum COREWEBVIEW2_ENHANCED_SECURITY_MODE_LEVEL {
9594
/// Enhanced Security Mode is turned off.
9695
COREWEBVIEW2_ENHANCED_SECURITY_MODE_LEVEL_OFF,
9796
/// Enhanced Security Mode is enabled in Strict level. Disables JavaScript
98-
/// Just-in-Time (JIT) compilation and enables additional OS protections.
97+
/// Just-in-Time (JIT) compilation and enables additional operating system protections.
9998
///
10099
/// This level applies enhanced security for all sites but may reduce JavaScript performance.
101100
///
@@ -107,13 +106,13 @@ typedef enum COREWEBVIEW2_ENHANCED_SECURITY_MODE_LEVEL {
107106
/// Extension of ICoreWebView2Profile to control Enhanced Security Mode (ESM) level.
108107
///
109108
/// ESM reduces the risk of memory-related vulnerabilities by disabling JavaScript
110-
/// Just-in-Time (JIT) compilation and enabling additional OS protections.
111-
/// This property applies to all WebView2 instances sharing the same profile and
112-
/// is persisted in the user data folder.
109+
/// Just-in-Time (JIT) compilation and enabling additional operating system protections.
110+
/// This property applies to all WebView2 instances sharing the same profile.
111+
/// The configuration is not persisted to the user data folder.
112+
/// The property is reset when the profile is recreated.
113113
///
114114
/// See `COREWEBVIEW2_ENHANCED_SECURITY_MODE_LEVEL` for descriptions of levels.
115115
///
116-
/// If `EnhancedSecurityModeLevel` is set, the property value is persisted in the profile.
117116
/// Changes apply to future navigations; reload may be required.
118117
///
119118
/// Enabling ESM improves security but may reduce JavaScript performance.

0 commit comments

Comments
 (0)