diff --git a/README.md b/README.md
index 7c2430a..14352ba 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@ WebView4Delphi is an open source project created by Salvador Díaz Fau to embed
WebView4Delphi only supports Windows. If you need to embed a web browser in Linux, Windows or MacOS consider using [CEF4Delphi](https://github.com/salvadordf/CEF4Delphi) instead.
-WebView4Delphi uses the [Microsoft Edge WebView2 Runtime](https://docs.microsoft.com/en-us/microsoft-edge/webview2/) and [Microsoft.Web.WebView2 NuGet package version 1.0.2535.41](https://www.nuget.org/packages/Microsoft.Web.WebView2) to embed a web browser.
+WebView4Delphi uses the [Microsoft Edge WebView2 Runtime](https://docs.microsoft.com/en-us/microsoft-edge/webview2/) and [Microsoft.Web.WebView2 NuGet package version 1.0.2592.51](https://www.nuget.org/packages/Microsoft.Web.WebView2) to embed a web browser.
WebView4Delphi was developed and tested on Delphi 12.1, Delphi XE2, Delphi 7 and Lazarus 3.4/FPC 3.2.2.
Delphi 6 support needs to be tested and it requires installing the second Delphi 6 patch.
diff --git a/bin32/WebView2Loader.dll b/bin32/WebView2Loader.dll
index d88aa4c..ae2684f 100644
Binary files a/bin32/WebView2Loader.dll and b/bin32/WebView2Loader.dll differ
diff --git a/bin64/WebView2Loader.dll b/bin64/WebView2Loader.dll
index 4fc0a46..f6d1d7b 100644
Binary files a/bin64/WebView2Loader.dll and b/bin64/WebView2Loader.dll differ
diff --git a/docs/WebView4Delphi.chm b/docs/WebView4Delphi.chm
index ff1bf12..c875e38 100644
Binary files a/docs/WebView4Delphi.chm and b/docs/WebView4Delphi.chm differ
diff --git a/docs/html/AllClasses.html b/docs/html/AllClasses.html
index 7d1231f..8480726 100644
--- a/docs/html/AllClasses.html
+++ b/docs/html/AllClasses.html
@@ -475,7 +475,7 @@
This interface represents a JavaScript exception. If the CoreWebView2.ExecuteScriptWithResult result has Succeeded as false, you can use the result's Exception property to get the script exception.
Defines properties that enable, disable, or modify WebView features. Changes to IsGeneralAutofillEnabled and IsPasswordAutosaveEnabled apply immediately, while other setting changes made after NavigationStarting event do not apply until the next top-level navigation.
The shared buffer object that is created by CreateSharedBuffer. The object is presented to script as ArrayBuffer when posted to script with PostSharedBufferToScript.
Implements the interface to receive StateChanged event. Use the ICoreWebView2DownloadOperation.State property to get the current state, which can be in progress, interrupted, or completed. Use the ICoreWebView2DownloadOperation.InterruptReason property to get the interrupt reason if the download is interrupted.
Runs when a URL request (through network, file, and so on) is made in the webview for a Web resource matching resource context filter and URL specified in AddWebResourceRequestedFilter. The host views and modifies the request or provide a response in a similar pattern to HTTP, in which case the request immediately completed. This may not contain any request headers that are added by the network stack, such as an Authorization header.
View of the HTTP representation for a web resource response. The properties of this object are not mutable. This response view is used with the TWVBrowserBase.OnWebResourceResponseReceived event.
VCL and LCL version of TWVBrowserBase that puts together all browser procedures, functions, properties and events in one place. It has all you need to create, modify and destroy a web browser.
Parent class of TWVBrowser and TWVFMXBrowser that puts together all browser procedures, functions, properties and events in one place. It has all you need to create, modify and destroy a web browser.
FMX version of TWVBrowserBase that puts together all browser procedures, functions, properties and events in one place. It has all you need to create, modify and destroy a web browser.
Class used by the TWVLoader.ProxySettigns property to configure a custom proxy server using the following command line switches: –no-proxy-server, –proxy-auto-detect, –proxy-bypass-list, –proxy-pac-url and –proxy-server.
Indicates permission to play audio and video automatically on sites. This permission affects the autoplay attribute and play method of the audio and video HTML elements, and the start method of the Web Audio API. See the [Autoplay guide for media and Web Audio APIs](https://developer.mozilla.org/en-US/docs/Web/Media/Autoplay_guide) for details.
+
Indicates permission to play audio and video automatically on sites. This permission affects the autoplay attribute and play method of the audio and video HTML elements, and the start method of the Web Audio API. See the [Autoplay guide for media and Web Audio APIs](https://developer.mozilla.org/docs/Web/Media/Autoplay_guide) for details.
Indicates permission to read and write to files or folders on the device. Permission is requested when developers use the [File System Access API](https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API) to show the file or folder picker to the end user, and then request "readwrite" permission for the user's selection.
+
Indicates permission to read and write to files or folders on the device. Permission is requested when developers use the [File System Access API](https://developer.mozilla.org/docs/Web/API/File_System_Access_API) to show the file or folder picker to the end user, and then request "readwrite" permission for the user's selection.
Indicates permission to send and receive system exclusive messages to/from MIDI (Musical Instrument Digital Interface) devices. Permission is requested when developers use the [Web MIDI API](https://developer.mozilla.org/en-US/docs/Web/API/Web_MIDI_API) to request access to system exclusive MIDI messages.
+
Indicates permission to send and receive system exclusive messages to/from MIDI (Musical Instrument Digital Interface) devices. Permission is requested when developers use the [Web MIDI API](https://developer.mozilla.org/docs/Web/API/Web_MIDI_API) to request access to system exclusive MIDI messages.
Indicates permission to play audio and video automatically on sites. This permission affects the autoplay attribute and play method of the audio and video HTML elements, and the start method of the Web Audio API. See the [Autoplay guide for media and Web Audio APIs](https://developer.mozilla.org/en-US/docs/Web/Media/Autoplay_guide) for details.
+
Indicates permission to play audio and video automatically on sites. This permission affects the autoplay attribute and play method of the audio and video HTML elements, and the start method of the Web Audio API. See the [Autoplay guide for media and Web Audio APIs](https://developer.mozilla.org/docs/Web/Media/Autoplay_guide) for details.
Indicates permission to read and write to files or folders on the device. Permission is requested when developers use the [File System Access API](https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API) to show the file or folder picker to the end user, and then request "readwrite" permission for the user's selection.
+
Indicates permission to read and write to files or folders on the device. Permission is requested when developers use the [File System Access API](https://developer.mozilla.org/docs/Web/API/File_System_Access_API) to show the file or folder picker to the end user, and then request "readwrite" permission for the user's selection.
Indicates permission to send and receive system exclusive messages to/from MIDI (Musical Instrument Digital Interface) devices. Permission is requested when developers use the [Web MIDI API](https://developer.mozilla.org/en-US/docs/Web/API/Web_MIDI_API) to request access to system exclusive MIDI messages.
+
Indicates permission to send and receive system exclusive messages to/from MIDI (Musical Instrument Digital Interface) devices. Permission is requested when developers use the [Web MIDI API](https://developer.mozilla.org/docs/Web/API/Web_MIDI_API) to request access to system exclusive MIDI messages.
This interface represents a JavaScript exception. If the CoreWebView2.ExecuteScriptWithResult result has Succeeded as false, you can use the result's Exception property to get the script exception.
Defines properties that enable, disable, or modify WebView features. Changes to IsGeneralAutofillEnabled and IsPasswordAutosaveEnabled apply immediately, while other setting changes made after NavigationStarting event do not apply until the next top-level navigation.
The shared buffer object that is created by CreateSharedBuffer. The object is presented to script as ArrayBuffer when posted to script with PostSharedBufferToScript.
Implements the interface to receive StateChanged event. Use the ICoreWebView2DownloadOperation.State property to get the current state, which can be in progress, interrupted, or completed. Use the ICoreWebView2DownloadOperation.InterruptReason property to get the interrupt reason if the download is interrupted.
Runs when a URL request (through network, file, and so on) is made in the webview for a Web resource matching resource context filter and URL specified in AddWebResourceRequestedFilter. The host views and modifies the request or provide a response in a similar pattern to HTTP, in which case the request immediately completed. This may not contain any request headers that are added by the network stack, such as an Authorization header.
View of the HTTP representation for a web resource response. The properties of this object are not mutable. This response view is used with the TWVBrowserBase.OnWebResourceResponseReceived event.
VCL and LCL version of TWVBrowserBase that puts together all browser procedures, functions, properties and events in one place. It has all you need to create, modify and destroy a web browser.
Parent class of TWVBrowser and TWVFMXBrowser that puts together all browser procedures, functions, properties and events in one place. It has all you need to create, modify and destroy a web browser.
The channel search kind determines the order that release channels are searched for during environment creation. The default behavior is to search for and use the most stable channel found on the device. The order from most to least stable is: WebView2 Runtime -> Beta -> Dev -> Canary. Switch the order to prefer the least stable channel in order to perform pre-release testing. See `COREWEBVIEW2_RELEASE_CHANNELS` for descriptions of channels.
A value representing RGBA color (Red, Green, Blue, Alpha) for WebView2. Each component takes a value from 0 to 255, with 0 being no intensity and 255 being the highest intensity.
The default download dialog can be aligned to any of the WebView corners by setting the DefaultDownloadDialogCornerAlignment property. The default position is top-right corner.
FMX version of TWVBrowserBase that puts together all browser procedures, functions, properties and events in one place. It has all you need to create, modify and destroy a web browser.
Kind of cross origin resource access allowed for host resources during download. Note that other normal access checks like same origin DOM access check and [Content Security Policy](https://developer.mozilla.org/docs/Web/HTTP/CSP) still apply. The following table illustrates the host resource cross origin access according to access context and COREWEBVIEW2_HOST_RESOURCE_ACCESS_KIND.
Cross Origin Access Context | DENY | ALLOW | DENY_CORS — | — | — | — From DOM like src of img, script or iframe element| Deny | Allow | Allow From Script like Fetch or XMLHttpRequest| Deny | Allow | Deny
Indicates the kind of context for which the context menu was created for the `ICoreWebView2ContextMenuTarget::get_Kind` method. This enum will always represent the active element that caused the context menu request. If there is a selection with multiple images, audio and text, for example, the element that the end user right clicks on within this selection will be the option represented by this enum.
Mouse event type used by SendMouseInput to convey the type of mouse event being sent to WebView. The values of this enum align with the matching WM_* window messages.
Mouse event virtual keys associated with a COREWEBVIEW2_MOUSE_EVENT_KIND for SendMouseInput. These values can be combined into a bit flag if more than one virtual key is pressed for the event. The values of this enum align with the matching MK_* mouse keys.
PDF toolbar item. This enum must be in sync with ToolBarItem in pdf-store-data-types.ts Specifies the PDF toolbar item types used for the ICoreWebView2Settings.put_HiddenPdfToolbarItems method.
Pointer event type used by SendPointerInput to convey the type of pointer event being sent to WebView. The values of this enum align with the matching WM_POINTER* window messages.
Specifies the process failure type used in the `ICoreWebView2ProcessFailedEventArgs` interface. The values in this enum make reference to the process kinds in the Chromium architecture. For more information about what these processes are and what they do, see [Browser Architecture - Inside look at modern web browser](https://developers.google.com/web/updates/2018/09/inside-browser-part1).
Class used by the TWVLoader.ProxySettigns property to configure a custom proxy server using the following command line switches: –no-proxy-server, –proxy-auto-detect, –proxy-bypass-list, –proxy-pac-url and –proxy-server.
* These constants are declared in the "Windows" unit but some old Delphi versions don't have them. We have to add "WV2_" to be compatible with C++ Builder. *
- `OnWindowCloseRequested` triggers when content inside the WebView requested to close the window, such as after `window.close` is run. The app should close the WebView and related app window if that makes sense to the app.
+ `OnWindowCloseRequested` triggers when content inside the WebView requested to close the window, such as after `window.close` is run. The app should close the WebView and related app window if that makes sense to the app. After the first window.close() call, this event may not fire for any immediate back to back window.close() calls.
The host can provide a response with credentials for the authentication or cancel the request. If the host sets the Cancel property to false but does not provide either UserName or Password properties on the Response property, then WebView2 will show the default authentication challenge dialog prompt to the user.
diff --git a/docs/html/uWVBrowserBase.TWVBrowserBase.html b/docs/html/uWVBrowserBase.TWVBrowserBase.html
index 8f9b172..fe5ece9 100644
--- a/docs/html/uWVBrowserBase.TWVBrowserBase.html
+++ b/docs/html/uWVBrowserBase.TWVBrowserBase.html
@@ -7203,7 +7203,7 @@
The extension folder path is the topmost folder of an unpacked browser extension and contains the browser extension manifest file.
@@ -8962,25 +8962,29 @@
Properties
-
Sets the `ReleaseChannels`, which is a mask of one or more indicating which channels environment creation should search for.
+
Sets the `ReleaseChannels`, which is a mask of one or more `COREWEBVIEW2_RELEASE_CHANNELS` indicating which channels environment creation should search for. OR operation(s) can be applied to multiple `COREWEBVIEW2_RELEASE_CHANNELS` to create a mask. The default value is a a mask of all the channels. By default, environment creation searches for channels from most to least stable, using the first channel found on the device. When `ReleaseChannels` is provided, environment creation will only search for the channels specified in the set. Set `ChannelSearchKind` to `COREWEBVIEW2_CHANNEL_SEARCH_KIND_LEAST_STABLE` to reverse the search order so environment creation searches for least stable build first. See `COREWEBVIEW2_RELEASE_CHANNELS` for descriptions of each channel.
-
OR operation(s) can be applied to multiple to create a mask. The default value is a mask of all the channels. By default, environment creation searches for channels from most to least stable, using the first channel found on the device. When is provided, environment creation will only search for the channels specified in the set. Set to to reverse the search order so that the loader searches for the least stable build first. See for descriptions of each channel. Environment creation fails if it is unable to find any channel from the installed on the device.
+
`CreateCoreWebView2EnvironmentWithOptions` fails with `HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)` if environment creation is unable to find any channel from the `ReleaseChannels` installed on the device. Use `GetAvailableCoreWebView2BrowserVersionStringWithOptions` on `ICoreWebView2Environment` to verify which channel is used when this option is set.
-
Use to verify which channel is used. If both a and are provided, the takes precedence. The can be overridden by the corresponding registry override or the environment variable . Set the value to a comma-separated string of integers, which map to the values: Stable (0), Beta (1), Dev (2), and Canary (3).
-
-
For example, the values "0,2" and "2,0" indicate that the loader should only search for Dev channel and the WebView2 Runtime, using the order indicated by . Environment creation attempts to interpret each integer and treats any invalid entry as Stable channel.
-
-
If both `BrowserExecutableFolder` and `ReleaseChannels` are provided, the `BrowserExecutableFolder` takes precedence, regardless of whether or not the channel of `BrowserExecutableFolder` is included in the `ReleaseChannels`.
+
+
`ReleaseChannels` can be overridden by the corresponding registry override `ReleaseChannels` or the environment variable `WEBVIEW2_RELEASE_CHANNELS`.
+
+
Set the value to a comma-separated string of integers, which map to the following release channel values: Stable (0), Beta (1), Dev (2), and Canary (3). For example, the values "0,2" and "2,0" indicate that environment creation should only search for Dev channel and the WebView2 Runtime, using the order indicated by `ChannelSearchKind`. Environment creation attempts to interpret each integer and treats any invalid entry as Stable channel. See `CreateCoreWebView2EnvironmentWithOptions` for more details on overrides.
+
+
@@ -9002,7 +9006,7 @@
Properties
The default value is `COREWEBVIEW2_SCROLLBAR_STYLE_DEFAULT` which specifies the default browser ScrollBar style.
-
CSS styles that modify the ScrollBar applied on top of native ScrollBar styling that is selected with `ScrollBarStyle`.
@@ -9574,6 +9578,8 @@
Properties
This property may be overridden if the User-Agent header is set in a request. If the parameter is empty the User Agent will not be updated and the current User Agent will remain. Setting this property may clear User Agent Client Hints headers Sec-CH-UA-* and script values from navigator.userAgentData. Current implementation behavior is subject to change.
+
The User Agent set will also be effective on service workers and shared workers associated with the WebView. If there are multiple WebViews associated with the same service worker or shared worker, the last User Agent set will be used.
+
@@ -10306,7 +10312,7 @@
Properties
- `OnWindowCloseRequested` triggers when content inside the WebView requested to close the window, such as after `window.close` is run. The app should close the WebView and related app window if that makes sense to the app.
+ `OnWindowCloseRequested` triggers when content inside the WebView requested to close the window, such as after `window.close` is run. The app should close the WebView and related app window if that makes sense to the app. After the first window.close() call, this event may not fire for any immediate back to back window.close() calls.
The host can provide a response with credentials for the authentication or cancel the request. If the host sets the Cancel property to false but does not provide either UserName or Password properties on the Response property, then WebView2 will show the default authentication challenge dialog prompt to the user.
diff --git a/docs/html/uWVConstants.html b/docs/html/uWVConstants.html
index c31ddf9..f72da6f 100644
--- a/docs/html/uWVConstants.html
+++ b/docs/html/uWVConstants.html
@@ -22,13 +22,13 @@
`shouldSerializeDates` | By default this is false, and javascript Date objects will be sent to host objects as a string using `JSON.stringify`. You can set this property to true to have Date objects properly serialize as a `VT_DATE` when sending to the native host object, and have `VT_DATE` properties and return values create a javascript Date object.
`defaultSyncProxy` | When calling a method on a synchronous proxy, the result should also be a synchronous proxy. But in some cases, the sync/async context is lost (for example, when providing to native code a reference to a function, and then calling that function in native code). In these cases, the proxy will be asynchronous, unless this property is set.
`forceAsyncMethodMatches ` | This is an array of regular expressions. When calling a method on a synchronous proxy, the method call will be performed asynchronously if the method name matches a string or regular expression in this array. Setting this value to `Async` will make any method that ends with Async be an asynchronous method call. If an async method doesn't match here and isn't forced to be asynchronous, the method will be invoked synchronously, blocking execution of the calling JavaScript and then returning the resolution of the promise, rather than returning a promise.
-`ignoreMemberNotFoundError` | By default, an exception is thrown when attempting to get the value of a proxy property that doesn't exist on the corresponding native class. Setting this property to `true` switches the behavior to match Chakra WinRT projection (and general JavaScript) behavior of returning `undefined` with no error.
+`ignoreMemberNotFoundError` | By default, an exception is thrown when attempting to get the value of a proxy property that doesn't exist on the corresponding native class. Setting this property to `true` switches the behavior to match Chakra WinRT projection (and general JavaScript) behavior of returning `undefined` with no error.
+`shouldPassTypedArraysAsArrays` | By default, typed arrays will be passed to host as IDispatch. Otherwise, set to true to pass typed arrays to host as array.
Host object proxies additionally have the following methods which run locally.
The origin initiating the external URI scheme launch.
-
The origin will be an empty string if the request is initiated by calling `CoreWebView2.Navigate` on the external URI scheme. If a script initiates the navigation, the `InitiatingOrigin` will be the top-level document's `Source`, for example, if `window.location` is set to `"calculator://", the `InitiatingOrigin` will be set to `calculator://`. If the request is initiated from a child frame, the `InitiatingOrigin` will be the source of that child frame.
+
The origin will be an empty string if the request is initiated by calling `CoreWebView2.Navigate` on the external URI scheme. If a script initiates the navigation, the `InitiatingOrigin` will be the top-level document's `Source`, for example, if `window.location` is set to `"calculator://"`, the `InitiatingOrigin` will be set to `calculator://`. If the request is initiated from a child frame, the `InitiatingOrigin` will be the source of that child frame.
If the `InitiatingOrigin` is [opaque](https://html.spec.whatwg.org/multipage/origin.html#concept-origin-opaque), the `InitiatingOrigin` reported in the event args will be its precursor origin. The precursor origin is the origin that created the opaque origin. For example, if a frame on example.com opens a subframe with a different opaque origin, the subframe's precursor origin is example.com.
diff --git a/docs/html/uWVCoreWebView2BrowserExtension.TCoreWebView2BrowserExtension.html b/docs/html/uWVCoreWebView2BrowserExtension.TCoreWebView2BrowserExtension.html
index a863a73..2e644bd 100644
--- a/docs/html/uWVCoreWebView2BrowserExtension.TCoreWebView2BrowserExtension.html
+++ b/docs/html/uWVCoreWebView2BrowserExtension.TCoreWebView2BrowserExtension.html
@@ -207,7 +207,7 @@
Properties
- This is the browser extension's ID. This is the same browser extension ID returned by the browser extension API [`chrome.runtime.id`](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/runtime/id). Please see that documentation for more details on how the ID is generated. After an extension is removed, calling `Id` will return the id of the extension that is removed.
+ This is the browser extension's ID. This is the same browser extension ID returned by the browser extension API [`chrome.runtime.id`](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/API/runtime/id). Please see that documentation for more details on how the ID is generated. After an extension is removed, calling `Id` will return the id of the extension that is removed.
@@ -217,7 +217,7 @@
Properties
- This is the browser extension's name. This value is defined in this browser extension's manifest.json file. If manifest.json define extension's localized name, this value will be the localized version of the name. Please see [Manifest.json name](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/name) for more details. After an extension is removed, calling `Name` will return the name of the extension that is removed.
+ This is the browser extension's name. This value is defined in this browser extension's manifest.json file. If manifest.json define extension's localized name, this value will be the localized version of the name. Please see [Manifest.json name](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/manifest.json/name) for more details. After an extension is removed, calling `Name` will return the name of the extension that is removed.
Sets the `ReleaseChannels`, which is a mask of one or more indicating which channels environment creation should search for.
+
Sets the `ReleaseChannels`, which is a mask of one or more `COREWEBVIEW2_RELEASE_CHANNELS` indicating which channels environment creation should search for. OR operation(s) can be applied to multiple `COREWEBVIEW2_RELEASE_CHANNELS` to create a mask. The default value is a a mask of all the channels. By default, environment creation searches for channels from most to least stable, using the first channel found on the device. When `ReleaseChannels` is provided, environment creation will only search for the channels specified in the set. Set `ChannelSearchKind` to `COREWEBVIEW2_CHANNEL_SEARCH_KIND_LEAST_STABLE` to reverse the search order so environment creation searches for least stable build first. See `COREWEBVIEW2_RELEASE_CHANNELS` for descriptions of each channel.
-
OR operation(s) can be applied to multiple to create a mask. The default value is a mask of all the channels. By default, environment creation searches for channels from most to least stable, using the first channel found on the device. When is provided, environment creation will only search for the channels specified in the set. Set to to reverse the search order so that the loader searches for the least stable build first. See for descriptions of each channel. Environment creation fails if it is unable to find any channel from the installed on the device.
+
`CreateCoreWebView2EnvironmentWithOptions` fails with `HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)` if environment creation is unable to find any channel from the `ReleaseChannels` installed on the device. Use `GetAvailableCoreWebView2BrowserVersionStringWithOptions` on `ICoreWebView2Environment` to verify which channel is used when this option is set.
-
Use to verify which channel is used. If both a and are provided, the takes precedence. The can be overridden by the corresponding registry override or the environment variable . Set the value to a comma-separated string of integers, which map to the values: Stable (0), Beta (1), Dev (2), and Canary (3).
-
-
For example, the values "0,2" and "2,0" indicate that the loader should only search for Dev channel and the WebView2 Runtime, using the order indicated by . Environment creation attempts to interpret each integer and treats any invalid entry as Stable channel.
-
-
If both `BrowserExecutableFolder` and `ReleaseChannels` are provided, the `BrowserExecutableFolder` takes precedence, regardless of whether or not the channel of `BrowserExecutableFolder` is included in the `ReleaseChannels`.
+
+
`ReleaseChannels` can be overridden by the corresponding registry override `ReleaseChannels` or the environment variable `WEBVIEW2_RELEASE_CHANNELS`.
+
+
Set the value to a comma-separated string of integers, which map to the following release channel values: Stable (0), Beta (1), Dev (2), and Canary (3). For example, the values "0,2" and "2,0" indicate that environment creation should only search for Dev channel and the WebView2 Runtime, using the order indicated by `ChannelSearchKind`. Environment creation attempts to interpret each integer and treats any invalid entry as Stable channel. See `CreateCoreWebView2EnvironmentWithOptions` for more details on overrides.
+
+
- The ScrollBar style being set on the WebView2 Environment. The default value is `COREWEBVIEW2_SCROLLBAR_STYLE_DEFAULT` which specifies the default browser ScrollBar style. The `color-scheme` CSS property needs to be set on the corresponding page to allow ScrollBar to follow light or dark theme. Please see [color-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/color-scheme#declaring_color_scheme_preferences) for how `color-scheme` can be set. CSS styles that modify the ScrollBar applied on top of native ScrollBar styling that is selected with `ScrollBarStyle`.
+ The ScrollBar style being set on the WebView2 Environment. The default value is `COREWEBVIEW2_SCROLLBAR_STYLE_DEFAULT` which specifies the default browser ScrollBar style. The `color-scheme` CSS property needs to be set on the corresponding page to allow ScrollBar to follow light or dark theme. Please see [color-scheme](https://developer.mozilla.org/docs/Web/CSS/color-scheme#declaring_color_scheme_preferences) for how `color-scheme` can be set. CSS styles that modify the ScrollBar applied on top of native ScrollBar styling that is selected with `ScrollBarStyle`.
Generated by PasDoc 0.16.0-snapshot.
diff --git a/docs/html/uWVCoreWebView2Profile.TCoreWebView2Profile.html b/docs/html/uWVCoreWebView2Profile.TCoreWebView2Profile.html
index 3b23803..d044ea8 100644
--- a/docs/html/uWVCoreWebView2Profile.TCoreWebView2Profile.html
+++ b/docs/html/uWVCoreWebView2Profile.TCoreWebView2Profile.html
@@ -586,7 +586,7 @@
Parameters
Sets permission state for the given permission kind and origin asynchronously. The change persists across sessions until it is changed by another call to `SetPermissionState`, or by setting the `State` property in `PermissionRequestedEventArgs`. Setting the state to `COREWEBVIEW2_PERMISSION_STATE_DEFAULT` will erase any state saved in the profile and restore the default behavior.
-
The extension folder path is the topmost folder of an unpacked browser extension and contains the browser extension manifest file.
diff --git a/docs/html/uWVCoreWebView2RegionRectCollectionView.TCoreWebView2RegionRectCollectionView.html b/docs/html/uWVCoreWebView2RegionRectCollectionView.TCoreWebView2RegionRectCollectionView.html
new file mode 100644
index 0000000..fa39acc
--- /dev/null
+++ b/docs/html/uWVCoreWebView2RegionRectCollectionView.TCoreWebView2RegionRectCollectionView.html
@@ -0,0 +1,181 @@
+
+
+
This property may be overridden if the User-Agent header is set in a request. If the parameter is empty the User Agent will not be updated and the current User Agent will remain. Setting this property may clear User Agent Client Hints headers Sec-CH-UA-* and script values from navigator.userAgentData. Current implementation behavior is subject to change.
+
The User Agent set will also be effective on service workers and shared workers associated with the WebView. If there are multiple WebViews associated with the same service worker or shared worker, the last User Agent set will be used.
+
HTTP response content as stream. Stream must have all the content data available by the time the `WebResourceRequested` event deferral of this response is completed. Stream should be agile or be created from a background thread to prevent performance impact to the UI thread. `Null` means no content data. `IStream` semantics apply (return `S_OK` to `Read` runs until all data is exhausted).
-
When providing the response data, you should consider relevant HTTP request headers just like an HTTP server would do. For example, if the request was for a video resource in a HTML video element, the request may contain the [Range](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Range) header to request only a part of the video that is streaming. In this case, your response stream should be only the portion of the video specified by the range HTTP request headers and you should set the appropriate [Content-Range](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Range) header in the response.
+
When providing the response data, you should consider relevant HTTP request headers just like an HTTP server would do. For example, if the request was for a video resource in a HTML video element, the request may contain the [Range](https://developer.mozilla.org/docs/Web/HTTP/Headers/Range) header to request only a part of the video that is streaming. In this case, your response stream should be only the portion of the video specified by the range HTTP request headers and you should set the appropriate [Content-Range](https://developer.mozilla.org/docs/Web/HTTP/Headers/Content-Range) header in the response.
- `OnWindowCloseRequested` triggers when content inside the WebView requested to close the window, such as after `window.close` is run. The app should close the WebView and related app window if that makes sense to the app.
+ `OnWindowCloseRequested` triggers when content inside the WebView requested to close the window, such as after `window.close` is run. The app should close the WebView and related app window if that makes sense to the app. After the first window.close() call, this event may not fire for any immediate back to back window.close() calls.
The host can provide a response with credentials for the authentication or cancel the request. If the host sets the Cancel property to false but does not provide either UserName or Password properties on the Response property, then WebView2 will show the default authentication challenge dialog prompt to the user.
diff --git a/docs/html/uWVLoader.TWVLoader.html b/docs/html/uWVLoader.TWVLoader.html
index be6767c..72b8584 100644
--- a/docs/html/uWVLoader.TWVLoader.html
+++ b/docs/html/uWVLoader.TWVLoader.html
@@ -2141,25 +2141,29 @@
Properties
-
Sets the `ReleaseChannels`, which is a mask of one or more indicating which channels environment creation should search for.
+
Sets the `ReleaseChannels`, which is a mask of one or more `COREWEBVIEW2_RELEASE_CHANNELS` indicating which channels environment creation should search for. OR operation(s) can be applied to multiple `COREWEBVIEW2_RELEASE_CHANNELS` to create a mask. The default value is a a mask of all the channels. By default, environment creation searches for channels from most to least stable, using the first channel found on the device. When `ReleaseChannels` is provided, environment creation will only search for the channels specified in the set. Set `ChannelSearchKind` to `COREWEBVIEW2_CHANNEL_SEARCH_KIND_LEAST_STABLE` to reverse the search order so environment creation searches for least stable build first. See `COREWEBVIEW2_RELEASE_CHANNELS` for descriptions of each channel.
-
OR operation(s) can be applied to multiple to create a mask. The default value is a mask of all the channels. By default, environment creation searches for channels from most to least stable, using the first channel found on the device. When is provided, environment creation will only search for the channels specified in the set. Set to to reverse the search order so that the loader searches for the least stable build first. See for descriptions of each channel. Environment creation fails if it is unable to find any channel from the installed on the device.
+
`CreateCoreWebView2EnvironmentWithOptions` fails with `HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)` if environment creation is unable to find any channel from the `ReleaseChannels` installed on the device. Use `GetAvailableCoreWebView2BrowserVersionStringWithOptions` on `ICoreWebView2Environment` to verify which channel is used when this option is set.
-
Use to verify which channel is used. If both a and are provided, the takes precedence. The can be overridden by the corresponding registry override or the environment variable . Set the value to a comma-separated string of integers, which map to the values: Stable (0), Beta (1), Dev (2), and Canary (3).
-
-
For example, the values "0,2" and "2,0" indicate that the loader should only search for Dev channel and the WebView2 Runtime, using the order indicated by . Environment creation attempts to interpret each integer and treats any invalid entry as Stable channel.
-
-
If both `BrowserExecutableFolder` and `ReleaseChannels` are provided, the `BrowserExecutableFolder` takes precedence, regardless of whether or not the channel of `BrowserExecutableFolder` is included in the `ReleaseChannels`.
+
+
`ReleaseChannels` can be overridden by the corresponding registry override `ReleaseChannels` or the environment variable `WEBVIEW2_RELEASE_CHANNELS`.
+
+
Set the value to a comma-separated string of integers, which map to the following release channel values: Stable (0), Beta (1), Dev (2), and Canary (3). For example, the values "0,2" and "2,0" indicate that environment creation should only search for Dev channel and the WebView2 Runtime, using the order indicated by `ChannelSearchKind`. Environment creation attempts to interpret each integer and treats any invalid entry as Stable channel. See `CreateCoreWebView2EnvironmentWithOptions` for more details on overrides.
+
+
@@ -2181,7 +2185,7 @@
Properties
The default value is `COREWEBVIEW2_SCROLLBAR_STYLE_DEFAULT` which specifies the default browser ScrollBar style.
-
CSS styles that modify the ScrollBar applied on top of native ScrollBar styling that is selected with `ScrollBarStyle`.
diff --git a/docs/html/uWVTypeLibrary.ICoreWebView2.html b/docs/html/uWVTypeLibrary.ICoreWebView2.html
index e7dcbe9..3f896f4 100644
--- a/docs/html/uWVTypeLibrary.ICoreWebView2.html
+++ b/docs/html/uWVTypeLibrary.ICoreWebView2.html
@@ -840,7 +840,7 @@
Attributes
The `chrome.webview.hostObjects.options` object provides the ability to change some functionality of host objects.
-
Options property | Details —|— `forceLocalProperties` | This is an array of host object property names that will be run locally, instead of being called on the native host object. This defaults to `then`, `toJSON`, `Symbol.toString`, and `Symbol.toPrimitive`. You can add other properties to specify that they should be run locally on the javascript host object proxy. `log` | This is a callback that will be called with debug information. For example, you can set this to `console.log.bind(console)` to have it print debug information to the console to help when troubleshooting host object usage. By default this is null. `shouldSerializeDates` | By default this is false, and javascript Date objects will be sent to host objects as a string using `JSON.stringify`. You can set this property to true to have Date objects properly serialize as a `VT_DATE` when sending to the native host object, and have `VT_DATE` properties and return values create a javascript Date object. `defaultSyncProxy` | When calling a method on a synchronous proxy, the result should also be a synchronous proxy. But in some cases, the sync/async context is lost (for example, when providing to native code a reference to a function, and then calling that function in native code). In these cases, the proxy will be asynchronous, unless this property is set. `forceAsyncMethodMatches ` | This is an array of regular expressions. When calling a method on a synchronous proxy, the method call will be performed asynchronously if the method name matches a string or regular expression in this array. Setting this value to `Async` will make any method that ends with Async be an asynchronous method call. If an async method doesn't match here and isn't forced to be asynchronous, the method will be invoked synchronously, blocking execution of the calling JavaScript and then returning the resolution of the promise, rather than returning a promise. `ignoreMemberNotFoundError` | By default, an exception is thrown when attempting to get the value of a proxy property that doesn't exist on the corresponding native class. Setting this property to `true` switches the behavior to match Chakra WinRT projection (and general JavaScript) behavior of returning `undefined` with no error.
+
Options property | Details —|— `forceLocalProperties` | This is an array of host object property names that will be run locally, instead of being called on the native host object. This defaults to `then`, `toJSON`, `Symbol.toString`, and `Symbol.toPrimitive`. You can add other properties to specify that they should be run locally on the javascript host object proxy. `log` | This is a callback that will be called with debug information. For example, you can set this to `console.log.bind(console)` to have it print debug information to the console to help when troubleshooting host object usage. By default this is null. `shouldSerializeDates` | By default this is false, and javascript Date objects will be sent to host objects as a string using `JSON.stringify`. You can set this property to true to have Date objects properly serialize as a `VT_DATE` when sending to the native host object, and have `VT_DATE` properties and return values create a javascript Date object. `defaultSyncProxy` | When calling a method on a synchronous proxy, the result should also be a synchronous proxy. But in some cases, the sync/async context is lost (for example, when providing to native code a reference to a function, and then calling that function in native code). In these cases, the proxy will be asynchronous, unless this property is set. `forceAsyncMethodMatches ` | This is an array of regular expressions. When calling a method on a synchronous proxy, the method call will be performed asynchronously if the method name matches a string or regular expression in this array. Setting this value to `Async` will make any method that ends with Async be an asynchronous method call. If an async method doesn't match here and isn't forced to be asynchronous, the method will be invoked synchronously, blocking execution of the calling JavaScript and then returning the resolution of the promise, rather than returning a promise. `ignoreMemberNotFoundError` | By default, an exception is thrown when attempting to get the value of a proxy property that doesn't exist on the corresponding native class. Setting this property to `true` switches the behavior to match Chakra WinRT projection (and general JavaScript) behavior of returning `undefined` with no error. `shouldPassTypedArraysAsArrays` | By default, typed arrays will be passed to host as IDispatch. Otherwise, set to true to pass typed arrays to host as array.
Host object proxies additionally have the following methods which run locally.
@@ -982,7 +982,7 @@
Attributes
- Add an event handler for the `WindowCloseRequested` event. `WindowCloseRequested` triggers when content inside the WebView requested to close the window, such as after `window.close` is run. The app should close the WebView and related app window if that makes sense to the app.
+ Add an event handler for the `WindowCloseRequested` event. `WindowCloseRequested` triggers when content inside the WebView requested to close the window, such as after `window.close` is run. The app should close the WebView and related app window if that makes sense to the app. After the first window.close() call, this event may not fire for any immediate back to back window.close() calls.
- This is the browser extension's ID. This is the same browser extension ID returned by the browser extension API [`chrome.runtime.id`](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/runtime/id). Please see that documentation for more details on how the ID is generated. After an extension is removed, calling `Id` will return the id of the extension that is removed. The caller must free the returned string with `CoTaskMemFree`. See [API Conventions](/microsoft-edge/webview2/concepts/win32-api-conventions#strings).
+ This is the browser extension's ID. This is the same browser extension ID returned by the browser extension API [`chrome.runtime.id`](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/API/runtime/id). Please see that documentation for more details on how the ID is generated. After an extension is removed, calling `Id` will return the id of the extension that is removed. The caller must free the returned string with `CoTaskMemFree`. See [API Conventions](/microsoft-edge/webview2/concepts/win32-api-conventions#strings).
Attributes
GUID['{7EF7FFA0-FAC5-462C-B189-3D9EDBE575DA}']
@@ -74,7 +74,7 @@
Attributes
- This is the browser extension's name. This value is defined in this browser extension's manifest.json file. If manifest.json define extension's localized name, this value will be the localized version of the name. Please see [Manifest.json name](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/name) for more details. After an extension is removed, calling `Name` will return the name of the extension that is removed. The caller must free the returned string with `CoTaskMemFree`. See [API Conventions](/microsoft-edge/webview2/concepts/win32-api-conventions#strings).
+ This is the browser extension's name. This value is defined in this browser extension's manifest.json file. If manifest.json define extension's localized name, this value will be the localized version of the name. Please see [Manifest.json name](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/manifest.json/name) for more details. After an extension is removed, calling `Name` will return the name of the extension that is removed. The caller must free the returned string with `CoTaskMemFree`. See [API Conventions](/microsoft-edge/webview2/concepts/win32-api-conventions#strings).
Sets the `ReleaseChannels`, which is a mask of one or more indicating which channels environment creation should search for.
+
Sets the `ReleaseChannels`, which is a mask of one or more `COREWEBVIEW2_RELEASE_CHANNELS` indicating which channels environment creation should search for. OR operation(s) can be applied to multiple `COREWEBVIEW2_RELEASE_CHANNELS` to create a mask. The default value is a a mask of all the channels. By default, environment creation searches for channels from most to least stable, using the first channel found on the device. When `ReleaseChannels` is provided, environment creation will only search for the channels specified in the set. Set `ChannelSearchKind` to `COREWEBVIEW2_CHANNEL_SEARCH_KIND_LEAST_STABLE` to reverse the search order so environment creation searches for least stable build first. See `COREWEBVIEW2_RELEASE_CHANNELS` for descriptions of each channel.
-
OR operation(s) can be applied to multiple to create a mask. The default value is a mask of all the channels. By default, environment creation searches for channels from most to least stable, using the first channel found on the device. When is provided, environment creation will only search for the channels specified in the set. Set to to reverse the search order so that the loader searches for the least stable build first. See for descriptions of each channel. Environment creation fails if it is unable to find any channel from the installed on the device.
+
`CreateCoreWebView2EnvironmentWithOptions` fails with `HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)` if environment creation is unable to find any channel from the `ReleaseChannels` installed on the device. Use `GetAvailableCoreWebView2BrowserVersionStringWithOptions` on `ICoreWebView2Environment` to verify which channel is used when this option is set.
-
Use to verify which channel is used. If both a and are provided, the takes precedence. The can be overridden by the corresponding registry override or the environment variable . Set the value to a comma-separated string of integers, which map to the values: Stable (0), Beta (1), Dev (2), and Canary (3).
-
-
For example, the values "0,2" and "2,0" indicate that the loader should only search for Dev channel and the WebView2 Runtime, using the order indicated by . Environment creation attempts to interpret each integer and treats any invalid entry as Stable channel.
-
-
If both `BrowserExecutableFolder` and `ReleaseChannels` are provided, the `BrowserExecutableFolder` takes precedence, regardless of whether or not the channel of `BrowserExecutableFolder` is included in the `ReleaseChannels`.
+
+
`ReleaseChannels` can be overridden by the corresponding registry override `ReleaseChannels` or the environment variable `WEBVIEW2_RELEASE_CHANNELS`.
+
+
Set the value to a comma-separated string of integers, which map to the following release channel values: Stable (0), Beta (1), Dev (2), and Canary (3). For example, the values "0,2" and "2,0" indicate that environment creation should only search for Dev channel and the WebView2 Runtime, using the order indicated by `ChannelSearchKind`. Environment creation attempts to interpret each integer and treats any invalid entry as Stable channel. See `CreateCoreWebView2EnvironmentWithOptions` for more details on overrides.
+
+
Generated by PasDoc 0.16.0-snapshot.
diff --git a/docs/html/uWVTypeLibrary.ICoreWebView2EnvironmentOptions8.html b/docs/html/uWVTypeLibrary.ICoreWebView2EnvironmentOptions8.html
index 28d9df9..ed27440 100644
--- a/docs/html/uWVTypeLibrary.ICoreWebView2EnvironmentOptions8.html
+++ b/docs/html/uWVTypeLibrary.ICoreWebView2EnvironmentOptions8.html
@@ -62,7 +62,7 @@
Attributes
- The ScrollBar style being set on the WebView2 Environment. The default value is `COREWEBVIEW2_SCROLLBAR_STYLE_DEFAULT` which specifies the default browser ScrollBar style. The `color-scheme` CSS property needs to be set on the corresponding page to allow ScrollBar to follow light or dark theme. Please see [color-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/color-scheme#declaring_color_scheme_preferences) for how `color-scheme` can be set. CSS styles that modify the ScrollBar applied on top of native ScrollBar styling that is selected with `ScrollBarStyle`.
+ The ScrollBar style being set on the WebView2 Environment. The default value is `COREWEBVIEW2_SCROLLBAR_STYLE_DEFAULT` which specifies the default browser ScrollBar style. The `color-scheme` CSS property needs to be set on the corresponding page to allow ScrollBar to follow light or dark theme. Please see [color-scheme](https://developer.mozilla.org/docs/Web/CSS/color-scheme#declaring_color_scheme_preferences) for how `color-scheme` can be set. CSS styles that modify the ScrollBar applied on top of native ScrollBar styling that is selected with `ScrollBarStyle`.
Generated by PasDoc 0.16.0-snapshot.
diff --git a/docs/html/uWVTypeLibrary.ICoreWebView2File.html b/docs/html/uWVTypeLibrary.ICoreWebView2File.html
index f5757b2..55bb5c5 100644
--- a/docs/html/uWVTypeLibrary.ICoreWebView2File.html
+++ b/docs/html/uWVTypeLibrary.ICoreWebView2File.html
@@ -19,7 +19,7 @@
The origin initiating the external URI scheme launch. The origin will be an empty string if the request is initiated by calling `CoreWebView2.Navigate` on the external URI scheme. If a script initiates the navigation, the `InitiatingOrigin` will be the top-level document's `Source`, for example, if `window.location` is set to `"calculator://", the `InitiatingOrigin` will be set to `calculator://`. If the request is initiated from a child frame, the `InitiatingOrigin` will be the source of that child frame.
+
The origin initiating the external URI scheme launch. The origin will be an empty string if the request is initiated by calling `CoreWebView2.Navigate` on the external URI scheme. If a script initiates the navigation, the `InitiatingOrigin` will be the top-level document's `Source`, for example, if `window.location` is set to `"calculator://"`, the `InitiatingOrigin` will be set to `calculator://`. If the request is initiated from a child frame, the `InitiatingOrigin` will be the source of that child frame.
If the `InitiatingOrigin` is [opaque](https://html.spec.whatwg.org/multipage/origin.html#concept-origin-opaque), the `InitiatingOrigin` reported in the event args will be its precursor origin. The precursor origin is the origin that created the opaque origin. For example, if a frame on example.com opens a subframe with a different opaque origin, the subframe's precursor origin is example.com.
diff --git a/docs/html/uWVTypeLibrary.ICoreWebView2NewWindowRequestedEventArgs.html b/docs/html/uWVTypeLibrary.ICoreWebView2NewWindowRequestedEventArgs.html
index 2c4d3ba..4d74b46 100644
--- a/docs/html/uWVTypeLibrary.ICoreWebView2NewWindowRequestedEventArgs.html
+++ b/docs/html/uWVTypeLibrary.ICoreWebView2NewWindowRequestedEventArgs.html
@@ -88,7 +88,7 @@
Attributes
- Sets a CoreWebView2 as a result of the NewWindowRequested event. Provides a WebView as the target for a `window.open()` from inside the requesting WebView. If this is set, the top-level window of this WebView is returned as the opened [WindowProxy](https://developer.mozilla.org/en-US/docs/glossary/windowproxy) to the opener script. If this is not set, then `Handled` is checked to determine behavior for NewWindowRequested event. CoreWebView2 provided in the `NewWindow` property must be on the same Environment as the opener WebView and should not have been navigated previously. Don't use methods that cause navigation or interact with the DOM on this CoreWebView2 until the target content has loaded. Setting event handlers, changing Settings properties, or other methods are fine to call. Changes to settings should be made before `put_NewWindow` is called to ensure that those settings take effect for the newly setup WebView. Once the NewWindow is set the underlying web contents of this CoreWebView2 will be replaced and navigated as appropriate for the new window. After setting new window it cannot be changed and error will be return otherwise.
+ Sets a CoreWebView2 as a result of the NewWindowRequested event. Provides a WebView as the target for a `window.open()` from inside the requesting WebView. If this is set, the top-level window of this WebView is returned as the opened [WindowProxy](https://developer.mozilla.org/docs/glossary/windowproxy) to the opener script. If this is not set, then `Handled` is checked to determine behavior for NewWindowRequested event. CoreWebView2 provided in the `NewWindow` property must be on the same Environment as the opener WebView and should not have been navigated previously. Don't use methods that cause navigation or interact with the DOM on this CoreWebView2 until the target content has loaded. Setting event handlers, changing Settings properties, or other methods are fine to call. Changes to settings should be made before `put_NewWindow` is called to ensure that those settings take effect for the newly setup WebView. Once the NewWindow is set the underlying web contents of this CoreWebView2 will be replaced and navigated as appropriate for the new window. After setting new window it cannot be changed and error will be return otherwise.
The methods which should affect the new web contents like AddScriptToExecuteOnDocumentCreated has to be called and completed before setting NewWindow. Other methods which should affect the new web contents like add_WebResourceRequested have to be called after setting NewWindow. It is best not to use RemoveScriptToExecuteOnDocumentCreated before setting NewWindow, otherwise it may not work for later added scripts.
diff --git a/docs/html/uWVTypeLibrary.ICoreWebView2Profile4.html b/docs/html/uWVTypeLibrary.ICoreWebView2Profile4.html
index a9aa0c2..4600fd1 100644
--- a/docs/html/uWVTypeLibrary.ICoreWebView2Profile4.html
+++ b/docs/html/uWVTypeLibrary.ICoreWebView2Profile4.html
@@ -50,7 +50,7 @@
Methods
- Sets permission state for the given permission kind and origin asynchronously. The change persists across sessions until it is changed by another call to `SetPermissionState`, or by setting the `State` property in `PermissionRequestedEventArgs`. Setting the state to `COREWEBVIEW2_PERMISSION_STATE_DEFAULT` will erase any state saved in the profile and restore the default behavior. The origin should have a valid scheme and host (e.g. "https://www.example.com"), otherwise the method fails with `E_INVALIDARG`. Additional URI parts like path and fragment are ignored. For example, "https://wwww.example.com/app1/index.html/" is treated the same as "https://wwww.example.com". See the [MDN origin definition](https://developer.mozilla.org/en-US/docs/Glossary/Origin) for more details.
+ Sets permission state for the given permission kind and origin asynchronously. The change persists across sessions until it is changed by another call to `SetPermissionState`, or by setting the `State` property in `PermissionRequestedEventArgs`. Setting the state to `COREWEBVIEW2_PERMISSION_STATE_DEFAULT` will erase any state saved in the profile and restore the default behavior. The origin should have a valid scheme and host (e.g. "https://www.example.com"), otherwise the method fails with `E_INVALIDARG`. Additional URI parts like path and fragment are ignored. For example, "https://wwww.example.com/app1/index.html/" is treated the same as "https://wwww.example.com". See the [MDN origin definition](https://developer.mozilla.org/docs/Glossary/Origin) for more details.
- Adds the [browser extension](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions) using the extension path for unpacked extensions from the local device. Extension is running right after installation. The extension folder path is the topmost folder of an unpacked browser extension and contains the browser extension manifest file. If the `extensionFolderPath` is an invalid path or doesn't contain the extension manifest.json file, this function will return `ERROR_FILE_NOT_FOUND` to callers. Installed extension will default `IsEnabled` to true. When `AreBrowserExtensionsEnabled` is `FALSE`, `AddBrowserExtension` will fail and return HRESULT `ERROR_NOT_SUPPORTED`. During installation, the content of the extension is not copied to the user data folder. Once the extension is installed, changing the content of the extension will cause the extension to be removed from the installed profile. When an extension is added the extension is persisted in the corresponding profile. The extension will still be installed the next time you use this profile. When an extension is installed from a folder path, adding the same extension from the same folder path means reinstalling this extension. When two extensions with the same Id are installed, only the later installed extension will be kept.
+ Adds the [browser extension](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions) using the extension path for unpacked extensions from the local device. Extension is running right after installation. The extension folder path is the topmost folder of an unpacked browser extension and contains the browser extension manifest file. If the `extensionFolderPath` is an invalid path or doesn't contain the extension manifest.json file, this function will return `ERROR_FILE_NOT_FOUND` to callers. Installed extension will default `IsEnabled` to true. When `AreBrowserExtensionsEnabled` is `FALSE`, `AddBrowserExtension` will fail and return HRESULT `ERROR_NOT_SUPPORTED`. During installation, the content of the extension is not copied to the user data folder. Once the extension is installed, changing the content of the extension will cause the extension to be removed from the installed profile. When an extension is added the extension is persisted in the corresponding profile. The extension will still be installed the next time you use this profile. When an extension is installed from a folder path, adding the same extension from the same folder path means reinstalling this extension. When two extensions with the same Id are installed, only the later installed extension will be kept.
Extensions that are designed to include any UI interactions (e.g. icon, badge, pop up, etc.) can be loaded and used but will have missing UI entry points due to the lack of browser UI elements to host these entry points in WebView2.
diff --git a/docs/html/uWVTypeLibrary.ICoreWebView2Settings2.html b/docs/html/uWVTypeLibrary.ICoreWebView2Settings2.html
index ebfb843..7206ca3 100644
--- a/docs/html/uWVTypeLibrary.ICoreWebView2Settings2.html
+++ b/docs/html/uWVTypeLibrary.ICoreWebView2Settings2.html
@@ -67,7 +67,7 @@
Attributes
- Sets the `UserAgent` property. This property may be overridden if the User-Agent header is set in a request. If the parameter is empty the User Agent will not be updated and the current User Agent will remain. Setting this property may clear User Agent Client Hints headers Sec-CH-UA-* and script values from navigator.userAgentData. Current implementation behavior is subject to change. Returns `HRESULT_FROM_WIN32(ERROR_INVALID_STATE)` if the owning WebView is closed.
+ Sets the `UserAgent` property. This property may be overridden if the User-Agent header is set in a request. If the parameter is empty the User Agent will not be updated and the current User Agent will remain. Setting this property may clear User Agent Client Hints headers Sec-CH-UA-* and script values from navigator.userAgentData. Current implementation behavior is subject to change. The User Agent set will also be effective on service workers and shared workers associated with the WebView. If there are multiple WebViews associated with the same service worker or shared worker, the last User Agent set will be used. Returns `HRESULT_FROM_WIN32(ERROR_INVALID_STATE)` if the owning WebView is closed.
Generated by PasDoc 0.16.0-snapshot.
diff --git a/docs/html/uWVTypeLibrary.ICoreWebView2WebResourceResponse.html b/docs/html/uWVTypeLibrary.ICoreWebView2WebResourceResponse.html
index dd23739..adc66c3 100644
--- a/docs/html/uWVTypeLibrary.ICoreWebView2WebResourceResponse.html
+++ b/docs/html/uWVTypeLibrary.ICoreWebView2WebResourceResponse.html
@@ -67,7 +67,7 @@
Methods
- HTTP response content as stream. Stream must have all the content data available by the time the `WebResourceRequested` event deferral of this response is completed. Stream should be agile or be created from a background thread to prevent performance impact to the UI thread. `Null` means no content data. `IStream` semantics apply (return `S_OK` to `Read` runs until all data is exhausted). When providing the response data, you should consider relevant HTTP request headers just like an HTTP server would do. For example, if the request was for a video resource in a HTML video element, the request may contain the [Range](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Range) header to request only a part of the video that is streaming. In this case, your response stream should be only the portion of the video specified by the range HTTP request headers and you should set the appropriate [Content-Range](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Range) header in the response.
+ HTTP response content as stream. Stream must have all the content data available by the time the `WebResourceRequested` event deferral of this response is completed. Stream should be agile or be created from a background thread to prevent performance impact to the UI thread. `Null` means no content data. `IStream` semantics apply (return `S_OK` to `Read` runs until all data is exhausted). When providing the response data, you should consider relevant HTTP request headers just like an HTTP server would do. For example, if the request was for a video resource in a HTML video element, the request may contain the [Range](https://developer.mozilla.org/docs/Web/HTTP/Headers/Range) header to request only a part of the video that is streaming. In this case, your response stream should be only the portion of the video specified by the range HTTP request headers and you should set the appropriate [Content-Range](https://developer.mozilla.org/docs/Web/HTTP/Headers/Content-Range) header in the response.
The host can provide a response with credentials for the authentication or cancel the request. If the host sets the Cancel property to false but does not provide either UserName or Password properties on the Response property, then WebView2 will show the default authentication challenge dialog prompt to the user.
diff --git a/docs/html/uWVTypeLibrary.html b/docs/html/uWVTypeLibrary.html
index 6585289..2d6a208 100644
--- a/docs/html/uWVTypeLibrary.html
+++ b/docs/html/uWVTypeLibrary.html
@@ -961,7 +961,7 @@
- Indicates permission to read and write to files or folders on the device. Permission is requested when developers use the [File System Access API](https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API) to show the file or folder picker to the end user, and then request "readwrite" permission for the user's selection.
+ Indicates permission to read and write to files or folders on the device. Permission is requested when developers use the [File System Access API](https://developer.mozilla.org/docs/Web/API/File_System_Access_API) to show the file or folder picker to the end user, and then request "readwrite" permission for the user's selection.
@@ -5423,7 +5423,7 @@
Constants
- Indicates permission to play audio and video automatically on sites. This permission affects the autoplay attribute and play method of the audio and video HTML elements, and the start method of the Web Audio API. See the [Autoplay guide for media and Web Audio APIs](https://developer.mozilla.org/en-US/docs/Web/Media/Autoplay_guide) for details.
+ Indicates permission to play audio and video automatically on sites. This permission affects the autoplay attribute and play method of the audio and video HTML elements, and the start method of the Web Audio API. See the [Autoplay guide for media and Web Audio APIs](https://developer.mozilla.org/docs/Web/Media/Autoplay_guide) for details.
@@ -5449,7 +5449,7 @@
Constants
- Indicates permission to send and receive system exclusive messages to/from MIDI (Musical Instrument Digital Interface) devices. Permission is requested when developers use the [Web MIDI API](https://developer.mozilla.org/en-US/docs/Web/API/Web_MIDI_API) to request access to system exclusive MIDI messages.
+ Indicates permission to send and receive system exclusive messages to/from MIDI (Musical Instrument Digital Interface) devices. Permission is requested when developers use the [Web MIDI API](https://developer.mozilla.org/docs/Web/API/Web_MIDI_API) to request access to system exclusive MIDI messages.
@@ -7521,7 +7521,7 @@
Constants
Window style fluent overlay scroll bar.
-
Please see [Fluent UI](https:/-/developer.microsoft.com/en-us/fluentui#/) for more details on fluent UI.
+
diff --git a/packages/WebView4Delphi.pds b/packages/WebView4Delphi.pds
index 640d5c1..4e59daa 100644
--- a/packages/WebView4Delphi.pds
+++ b/packages/WebView4Delphi.pds
@@ -67,7 +67,7 @@ Count=1
Item_0=..\source
[Files]
-Count=65
+Count=66
Item_0=..\source\uWVBrowser.pas
Item_1=..\source\uWVBrowserBase.pas
Item_2=..\source\uWVConstants.pas
@@ -113,26 +113,27 @@ Item_41=..\source\uWVCoreWebView2ProcessExtendedInfoCollection.pas
Item_42=..\source\uWVCoreWebView2ProcessInfo.pas
Item_43=..\source\uWVCoreWebView2ProcessInfoCollection.pas
Item_44=..\source\uWVCoreWebView2Profile.pas
-Item_45=..\source\uWVCoreWebView2ScriptException.pas
-Item_46=..\source\uWVCoreWebView2Settings.pas
-Item_47=..\source\uWVCoreWebView2SharedBuffer.pas
-Item_48=..\source\uWVCoreWebView2StringCollection.pas
-Item_49=..\source\uWVCoreWebView2WebResourceRequest.pas
-Item_50=..\source\uWVCoreWebView2WebResourceResponse.pas
-Item_51=..\source\uWVCoreWebView2WebResourceResponseView.pas
-Item_52=..\source\uWVCoreWebView2WindowFeatures.pas
-Item_53=..\source\uWVEvents.pas
-Item_54=..\source\uWVFMXBrowser.pas
-Item_55=..\source\uWVFMXWindowParent.pas
-Item_56=..\source\uWVInterfaces.pas
-Item_57=..\source\uWVLibFunctions.pas
-Item_58=..\source\uWVLoader.pas
-Item_59=..\source\uWVLoaderInternal.pas
-Item_60=..\source\uWVMiscFunctions.pas
-Item_61=..\source\uWVTypeLibrary.pas
-Item_62=..\source\uWVTypes.pas
-Item_63=..\source\uWVWinControl.pas
-Item_64=..\source\uWVWindowParent.pas
+Item_45=..\source\uWVCoreWebView2RegionRectCollectionView.pas
+Item_46=..\source\uWVCoreWebView2ScriptException.pas
+Item_47=..\source\uWVCoreWebView2Settings.pas
+Item_48=..\source\uWVCoreWebView2SharedBuffer.pas
+Item_49=..\source\uWVCoreWebView2StringCollection.pas
+Item_50=..\source\uWVCoreWebView2WebResourceRequest.pas
+Item_51=..\source\uWVCoreWebView2WebResourceResponse.pas
+Item_52=..\source\uWVCoreWebView2WebResourceResponseView.pas
+Item_53=..\source\uWVCoreWebView2WindowFeatures.pas
+Item_54=..\source\uWVEvents.pas
+Item_55=..\source\uWVFMXBrowser.pas
+Item_56=..\source\uWVFMXWindowParent.pas
+Item_57=..\source\uWVInterfaces.pas
+Item_58=..\source\uWVLibFunctions.pas
+Item_59=..\source\uWVLoader.pas
+Item_60=..\source\uWVLoaderInternal.pas
+Item_61=..\source\uWVMiscFunctions.pas
+Item_62=..\source\uWVTypeLibrary.pas
+Item_63=..\source\uWVTypes.pas
+Item_64=..\source\uWVWinControl.pas
+Item_65=..\source\uWVWindowParent.pas
[AdditionalFiles]
Count=0
diff --git a/packages/webview4delphi.lpk b/packages/webview4delphi.lpk
index 44932d1..c42b061 100644
--- a/packages/webview4delphi.lpk
+++ b/packages/webview4delphi.lpk
@@ -16,7 +16,7 @@
-
+
diff --git a/source/uWVBrowserBase.pas b/source/uWVBrowserBase.pas
index b9423f3..d5d00e2 100644
--- a/source/uWVBrowserBase.pas
+++ b/source/uWVBrowserBase.pas
@@ -787,7 +787,7 @@ TWVBrowserBase = class(TComponent, IWVBrowserEvents)
///
function GetNonDefaultPermissionSettings: boolean;
///
- /// Adds the [browser extension](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions)
+ /// Adds the [browser extension](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions)
/// using the extension path for unpacked extensions from the local device. Extension is
/// running right after installation.
/// The extension folder path is the topmost folder of an unpacked browser extension and
@@ -1890,32 +1890,43 @@ TWVBrowserBase = class(TComponent, IWVBrowserEvents)
property ChannelSearchKind : TWVChannelSearchKind read FChannelSearchKind write FChannelSearchKind;
///
/// Sets the `ReleaseChannels`, which is a mask of one or more
- /// indicating which channels environment creation should search for.
- /// OR operation(s) can be applied to multiple to create a mask.
- /// The default value is a mask of all the channels. By default, environment
- /// creation searches for channels from most to least stable, using the first
- /// channel found on the device. When is provided, environment creation will
- /// only search for the channels specified in the set. Set to to reverse
- /// the search order so that the loader searches for the least stable build
- /// first. See for descriptions of each channel. Environment creation fails
- /// if it is unable to find any channel from the installed on the device.
- /// Use to verify which channel is used. If both a and are provided,
- /// the takes precedence. The can be overridden by the corresponding
- /// registry override or the environment variable . Set the value to a
- /// comma-separated string of integers, which map to the values: Stable (0),
- /// Beta (1), Dev (2), and Canary (3).
- /// For example, the values "0,2" and "2,0" indicate that the loader
- /// should only search for Dev channel and the WebView2 Runtime, using the
- /// order indicated by . Environment creation attempts to interpret each
- /// integer and treats any invalid entry as Stable channel.
+ /// `COREWEBVIEW2_RELEASE_CHANNELS` indicating which channels environment
+ /// creation should search for. OR operation(s) can be applied to multiple
+ /// `COREWEBVIEW2_RELEASE_CHANNELS` to create a mask. The default value is a
+ /// a mask of all the channels. By default, environment creation searches for
+ /// channels from most to least stable, using the first channel found on the
+ /// device. When `ReleaseChannels` is provided, environment creation will only
+ /// search for the channels specified in the set. Set `ChannelSearchKind` to
+ /// `COREWEBVIEW2_CHANNEL_SEARCH_KIND_LEAST_STABLE` to reverse the search order
+ /// so environment creation searches for least stable build first. See
+ /// `COREWEBVIEW2_RELEASE_CHANNELS` for descriptions of each channel.
+ /// `CreateCoreWebView2EnvironmentWithOptions` fails with
+ /// `HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)` if environment creation is unable
+ /// to find any channel from the `ReleaseChannels` installed on the device.
+ /// Use `GetAvailableCoreWebView2BrowserVersionStringWithOptions` on
+ /// `ICoreWebView2Environment` to verify which channel is used when this option
+ /// is set.
+ /// Examples:
///
/// | ReleaseChannels | Channel Search Kind: Most Stable (default) | Channel Search Kind: Least Stable |
/// | --- | --- | --- |
- /// |CoreWebView2ReleaseChannels.Beta \| CoreWebView2ReleaseChannels.Stable| WebView2 Runtime -> Beta | Beta -> WebView2 Runtime|
- /// |CoreWebView2ReleaseChannels.Canary \| CoreWebView2ReleaseChannels.Dev \| CoreWebView2ReleaseChannels.Beta \| CoreWebView2ReleaseChannels.Stable | WebView2 Runtime -> Beta -> Dev -> Canary | Canary -> Dev -> Beta -> WebView2 Runtime |
- /// |CoreWebView2ReleaseChannels.Canary| Canary | Canary |
- /// |CoreWebView2ReleaseChannels.Beta \| CoreWebView2ReleaseChannels.Canary \| CoreWebView2ReleaseChannels.Stable | WebView2 Runtime -> Beta -> Canary | Canary -> Beta -> WebView2 Runtime |
+ /// |COREWEBVIEW2_RELEASE_CHANNELS_BETA \| COREWEBVIEW2_RELEASE_CHANNELS_STABLE| WebView2 Runtime -> Beta | Beta -> WebView2 Runtime|
+ /// |COREWEBVIEW2_RELEASE_CHANNELS_CANARY \| COREWEBVIEW2_RELEASE_CHANNELS_DEV \| COREWEBVIEW2_RELEASE_CHANNELS_BETA \| COREWEBVIEW2_RELEASE_CHANNELS_STABLE| WebView2 Runtime -> Beta -> Dev -> Canary | Canary -> Dev -> Beta -> WebView2 Runtime |
+ /// |COREWEBVIEW2_RELEASE_CHANNELS_CANARY| Canary | Canary |
+ /// |COREWEBVIEW2_RELEASE_CHANNELS_BETA \| COREWEBVIEW2_RELEASE_CHANNELS_CANARY \| COREWEBVIEW2_RELEASE_CHANNELS_STABLE | WebView2 Runtime -> Beta -> Canary | Canary -> Beta -> WebView2 Runtime |
///
+ /// If both `BrowserExecutableFolder` and `ReleaseChannels` are provided, the
+ /// `BrowserExecutableFolder` takes precedence, regardless of whether or not the
+ /// channel of `BrowserExecutableFolder` is included in the `ReleaseChannels`.
+ /// `ReleaseChannels` can be overridden by the corresponding registry override
+ /// `ReleaseChannels` or the environment variable `WEBVIEW2_RELEASE_CHANNELS`.
+ /// Set the value to a comma-separated string of integers, which map to the
+ /// following release channel values: Stable (0), Beta (1), Dev (2), and
+ /// Canary (3). For example, the values "0,2" and "2,0" indicate that environment
+ /// creation should only search for Dev channel and the WebView2 Runtime, using the
+ /// order indicated by `ChannelSearchKind`. Environment creation attempts to
+ /// interpret each integer and treats any invalid entry as Stable channel. See
+ /// `CreateCoreWebView2EnvironmentWithOptions` for more details on overrides.
///
///
/// Property used to create the environment. Used as ICoreWebView2EnvironmentOptions7.Get_ReleaseChannels.
@@ -1928,7 +1939,7 @@ TWVBrowserBase = class(TComponent, IWVBrowserEvents)
/// which specifies the default browser ScrollBar style.
/// The `color-scheme` CSS property needs to be set on the corresponding page
/// to allow ScrollBar to follow light or dark theme. Please see
- /// [color-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/color-scheme#declaring_color_scheme_preferences)
+ /// [color-scheme](https://developer.mozilla.org/docs/Web/CSS/color-scheme#declaring_color_scheme_preferences)
/// for how `color-scheme` can be set.
/// CSS styles that modify the ScrollBar applied on top of native ScrollBar styling
/// that is selected with `ScrollBarStyle`.
@@ -2345,6 +2356,10 @@ TWVBrowserBase = class(TComponent, IWVBrowserEvents)
/// Setting this property may clear User Agent Client Hints headers
/// Sec-CH-UA-* and script values from navigator.userAgentData. Current
/// implementation behavior is subject to change.
+ /// The User Agent set will also be effective on service workers
+ /// and shared workers associated with the WebView.
+ /// If there are multiple WebViews associated with the same service worker or
+ /// shared worker, the last User Agent set will be used.
///
///
/// See the ICoreWebView2Settings2 article.
@@ -2933,7 +2948,8 @@ TWVBrowserBase = class(TComponent, IWVBrowserEvents)
/// `OnWindowCloseRequested` triggers when content inside the WebView
/// requested to close the window, such as after `window.close` is run. The
/// app should close the WebView and related app window if that makes sense
- /// to the app.
+ /// to the app. After the first window.close() call, this event may not fire
+ /// for any immediate back to back window.close() calls.
///
///
/// See the ICoreWebView2 article.
@@ -3027,7 +3043,7 @@ TWVBrowserBase = class(TComponent, IWVBrowserEvents)
/// Basic HTTP Authentication request as described in
/// https://developer.mozilla.org/docs/Web/HTTP/Authentication, a Digest
/// HTTP Authentication request as described in
- /// https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Authorization#digest,
+ /// https://developer.mozilla.org/docs/Web/HTTP/Headers/Authorization#digest,
/// an NTLM authentication or a Proxy Authentication request.
/// The host can provide a response with credentials for the authentication or
/// cancel the request. If the host sets the Cancel property to false but does not
diff --git a/source/uWVCoreWebView2.pas b/source/uWVCoreWebView2.pas
index 0e97264..bd21b1a 100644
--- a/source/uWVCoreWebView2.pas
+++ b/source/uWVCoreWebView2.pas
@@ -588,6 +588,7 @@ TCoreWebView2 = class
/// `defaultSyncProxy` | When calling a method on a synchronous proxy, the result should also be a synchronous proxy. But in some cases, the sync/async context is lost (for example, when providing to native code a reference to a function, and then calling that function in native code). In these cases, the proxy will be asynchronous, unless this property is set.
/// `forceAsyncMethodMatches ` | This is an array of regular expressions. When calling a method on a synchronous proxy, the method call will be performed asynchronously if the method name matches a string or regular expression in this array. Setting this value to `Async` will make any method that ends with Async be an asynchronous method call. If an async method doesn't match here and isn't forced to be asynchronous, the method will be invoked synchronously, blocking execution of the calling JavaScript and then returning the resolution of the promise, rather than returning a promise.
/// `ignoreMemberNotFoundError` | By default, an exception is thrown when attempting to get the value of a proxy property that doesn't exist on the corresponding native class. Setting this property to `true` switches the behavior to match Chakra WinRT projection (and general JavaScript) behavior of returning `undefined` with no error.
+ /// `shouldPassTypedArraysAsArrays` | By default, typed arrays will be passed to host as IDispatch. Otherwise, set to true to pass typed arrays to host as array.
///
/// Host object proxies additionally have the following methods which run
/// locally.
diff --git a/source/uWVCoreWebView2Args.pas b/source/uWVCoreWebView2Args.pas
index 6ef89ea..5c31164 100644
--- a/source/uWVCoreWebView2Args.pas
+++ b/source/uWVCoreWebView2Args.pas
@@ -1816,7 +1816,7 @@ TCoreWebView2LaunchingExternalUriSchemeEventArgs = class
/// The origin will be an empty string if the request is initiated by calling
/// `CoreWebView2.Navigate` on the external URI scheme. If a script initiates
/// the navigation, the `InitiatingOrigin` will be the top-level document's
- /// `Source`, for example, if `window.location` is set to `"calculator://", the
+ /// `Source`, for example, if `window.location` is set to `"calculator://"`, the
/// `InitiatingOrigin` will be set to `calculator://`. If the request is initiated
/// from a child frame, the `InitiatingOrigin` will be the source of that child frame.
/// If the `InitiatingOrigin` is
diff --git a/source/uWVCoreWebView2BrowserExtension.pas b/source/uWVCoreWebView2BrowserExtension.pas
index 4cdbc79..0b54203 100644
--- a/source/uWVCoreWebView2BrowserExtension.pas
+++ b/source/uWVCoreWebView2BrowserExtension.pas
@@ -64,7 +64,7 @@ TCoreWebView2BrowserExtension = class
property BaseIntf : ICoreWebView2BrowserExtension read FBaseIntf write FBaseIntf;
///
/// This is the browser extension's ID. This is the same browser extension ID returned by
- /// the browser extension API [`chrome.runtime.id`](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/runtime/id).
+ /// the browser extension API [`chrome.runtime.id`](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/API/runtime/id).
/// Please see that documentation for more details on how the ID is generated.
/// After an extension is removed, calling `Id` will return the id of the extension that is removed.
///
@@ -73,7 +73,7 @@ TCoreWebView2BrowserExtension = class
/// This is the browser extension's name. This value is defined in this browser extension's
/// manifest.json file. If manifest.json define extension's localized name, this value will
/// be the localized version of the name.
- /// Please see [Manifest.json name](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/name)
+ /// Please see [Manifest.json name](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/manifest.json/name)
/// for more details.
/// After an extension is removed, calling `Name` will return the name of the extension that is removed.
///
diff --git a/source/uWVCoreWebView2File.pas b/source/uWVCoreWebView2File.pas
index d2ac4c9..0e40e8c 100644
--- a/source/uWVCoreWebView2File.pas
+++ b/source/uWVCoreWebView2File.pas
@@ -12,7 +12,7 @@ interface
type
///
/// Representation of a DOM
- /// [File](https://developer.mozilla.org/en-US/docs/Web/API/File) object
+ /// [File](https://developer.mozilla.org/docs/Web/API/File) object
/// passed via WebMessage. You can use this object to obtain the path of a
/// File dropped on WebView2.
///
diff --git a/source/uWVCoreWebView2Profile.pas b/source/uWVCoreWebView2Profile.pas
index 58bdf82..80da4e7 100644
--- a/source/uWVCoreWebView2Profile.pas
+++ b/source/uWVCoreWebView2Profile.pas
@@ -131,7 +131,7 @@ TCoreWebView2Profile = class
/// otherwise the method fails with `E_INVALIDARG`. Additional URI parts like
/// path and fragment are ignored. For example, "https://wwww.example.com/app1/index.html/"
/// is treated the same as "https://wwww.example.com". See the
- /// [MDN origin definition](https://developer.mozilla.org/en-US/docs/Glossary/Origin)
+ /// [MDN origin definition](https://developer.mozilla.org/docs/Glossary/Origin)
/// for more details.
///
///
@@ -148,7 +148,7 @@ TCoreWebView2Profile = class
///
function GetNonDefaultPermissionSettings(const completedHandler: ICoreWebView2GetNonDefaultPermissionSettingsCompletedHandler): boolean;
///
- /// Adds the [browser extension](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions)
+ /// Adds the [browser extension](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions)
/// using the extension path for unpacked extensions from the local device. Extension is
/// running right after installation.
/// The extension folder path is the topmost folder of an unpacked browser extension and
diff --git a/source/uWVCoreWebView2Settings.pas b/source/uWVCoreWebView2Settings.pas
index fd0da55..9e292d2 100644
--- a/source/uWVCoreWebView2Settings.pas
+++ b/source/uWVCoreWebView2Settings.pas
@@ -193,6 +193,10 @@ TCoreWebView2Settings = class
/// Setting this property may clear User Agent Client Hints headers
/// Sec-CH-UA-* and script values from navigator.userAgentData. Current
/// implementation behavior is subject to change.
+ /// The User Agent set will also be effective on service workers
+ /// and shared workers associated with the WebView.
+ /// If there are multiple WebViews associated with the same service worker or
+ /// shared worker, the last User Agent set will be used.
///
///
/// See the ICoreWebView2Settings2 article.
diff --git a/source/uWVCoreWebView2WebResourceResponse.pas b/source/uWVCoreWebView2WebResourceResponse.pas
index 0226cf9..2ea4cdb 100644
--- a/source/uWVCoreWebView2WebResourceResponse.pas
+++ b/source/uWVCoreWebView2WebResourceResponse.pas
@@ -71,12 +71,12 @@ TCoreWebView2WebResourceResponse = class
/// When providing the response data, you should consider relevant HTTP
/// request headers just like an HTTP server would do. For example, if the
/// request was for a video resource in a HTML video element, the request may
- /// contain the [Range](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Range)
+ /// contain the [Range](https://developer.mozilla.org/docs/Web/HTTP/Headers/Range)
/// header to request only a part of the video that is streaming. In this
/// case, your response stream should be only the portion of the video
/// specified by the range HTTP request headers and you should set the
/// appropriate
- /// [Content-Range](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Range)
+ /// [Content-Range](https://developer.mozilla.org/docs/Web/HTTP/Headers/Content-Range)
/// header in the response.
///
///
diff --git a/source/uWVLoader.pas b/source/uWVLoader.pas
index 64a8d0b..adad130 100644
--- a/source/uWVLoader.pas
+++ b/source/uWVLoader.pas
@@ -388,32 +388,43 @@ TWVLoader = class(TComponent, IWVLoaderEvents)
property ChannelSearchKind : TWVChannelSearchKind read FChannelSearchKind write FChannelSearchKind;
///
/// Sets the `ReleaseChannels`, which is a mask of one or more
- /// indicating which channels environment creation should search for.
- /// OR operation(s) can be applied to multiple to create a mask.
- /// The default value is a mask of all the channels. By default, environment
- /// creation searches for channels from most to least stable, using the first
- /// channel found on the device. When is provided, environment creation will
- /// only search for the channels specified in the set. Set to to reverse
- /// the search order so that the loader searches for the least stable build
- /// first. See for descriptions of each channel. Environment creation fails
- /// if it is unable to find any channel from the installed on the device.
- /// Use to verify which channel is used. If both a and are provided,
- /// the takes precedence. The can be overridden by the corresponding
- /// registry override or the environment variable . Set the value to a
- /// comma-separated string of integers, which map to the values: Stable (0),
- /// Beta (1), Dev (2), and Canary (3).
- /// For example, the values "0,2" and "2,0" indicate that the loader
- /// should only search for Dev channel and the WebView2 Runtime, using the
- /// order indicated by . Environment creation attempts to interpret each
- /// integer and treats any invalid entry as Stable channel.
+ /// `COREWEBVIEW2_RELEASE_CHANNELS` indicating which channels environment
+ /// creation should search for. OR operation(s) can be applied to multiple
+ /// `COREWEBVIEW2_RELEASE_CHANNELS` to create a mask. The default value is a
+ /// a mask of all the channels. By default, environment creation searches for
+ /// channels from most to least stable, using the first channel found on the
+ /// device. When `ReleaseChannels` is provided, environment creation will only
+ /// search for the channels specified in the set. Set `ChannelSearchKind` to
+ /// `COREWEBVIEW2_CHANNEL_SEARCH_KIND_LEAST_STABLE` to reverse the search order
+ /// so environment creation searches for least stable build first. See
+ /// `COREWEBVIEW2_RELEASE_CHANNELS` for descriptions of each channel.
+ /// `CreateCoreWebView2EnvironmentWithOptions` fails with
+ /// `HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)` if environment creation is unable
+ /// to find any channel from the `ReleaseChannels` installed on the device.
+ /// Use `GetAvailableCoreWebView2BrowserVersionStringWithOptions` on
+ /// `ICoreWebView2Environment` to verify which channel is used when this option
+ /// is set.
+ /// Examples:
///
/// | ReleaseChannels | Channel Search Kind: Most Stable (default) | Channel Search Kind: Least Stable |
/// | --- | --- | --- |
- /// |CoreWebView2ReleaseChannels.Beta \| CoreWebView2ReleaseChannels.Stable| WebView2 Runtime -> Beta | Beta -> WebView2 Runtime|
- /// |CoreWebView2ReleaseChannels.Canary \| CoreWebView2ReleaseChannels.Dev \| CoreWebView2ReleaseChannels.Beta \| CoreWebView2ReleaseChannels.Stable | WebView2 Runtime -> Beta -> Dev -> Canary | Canary -> Dev -> Beta -> WebView2 Runtime |
- /// |CoreWebView2ReleaseChannels.Canary| Canary | Canary |
- /// |CoreWebView2ReleaseChannels.Beta \| CoreWebView2ReleaseChannels.Canary \| CoreWebView2ReleaseChannels.Stable | WebView2 Runtime -> Beta -> Canary | Canary -> Beta -> WebView2 Runtime |
+ /// |COREWEBVIEW2_RELEASE_CHANNELS_BETA \| COREWEBVIEW2_RELEASE_CHANNELS_STABLE| WebView2 Runtime -> Beta | Beta -> WebView2 Runtime|
+ /// |COREWEBVIEW2_RELEASE_CHANNELS_CANARY \| COREWEBVIEW2_RELEASE_CHANNELS_DEV \| COREWEBVIEW2_RELEASE_CHANNELS_BETA \| COREWEBVIEW2_RELEASE_CHANNELS_STABLE| WebView2 Runtime -> Beta -> Dev -> Canary | Canary -> Dev -> Beta -> WebView2 Runtime |
+ /// |COREWEBVIEW2_RELEASE_CHANNELS_CANARY| Canary | Canary |
+ /// |COREWEBVIEW2_RELEASE_CHANNELS_BETA \| COREWEBVIEW2_RELEASE_CHANNELS_CANARY \| COREWEBVIEW2_RELEASE_CHANNELS_STABLE | WebView2 Runtime -> Beta -> Canary | Canary -> Beta -> WebView2 Runtime |
///
+ /// If both `BrowserExecutableFolder` and `ReleaseChannels` are provided, the
+ /// `BrowserExecutableFolder` takes precedence, regardless of whether or not the
+ /// channel of `BrowserExecutableFolder` is included in the `ReleaseChannels`.
+ /// `ReleaseChannels` can be overridden by the corresponding registry override
+ /// `ReleaseChannels` or the environment variable `WEBVIEW2_RELEASE_CHANNELS`.
+ /// Set the value to a comma-separated string of integers, which map to the
+ /// following release channel values: Stable (0), Beta (1), Dev (2), and
+ /// Canary (3). For example, the values "0,2" and "2,0" indicate that environment
+ /// creation should only search for Dev channel and the WebView2 Runtime, using the
+ /// order indicated by `ChannelSearchKind`. Environment creation attempts to
+ /// interpret each integer and treats any invalid entry as Stable channel. See
+ /// `CreateCoreWebView2EnvironmentWithOptions` for more details on overrides.
///
///
/// Property used to create the environment. Used as ICoreWebView2EnvironmentOptions7.Get_ReleaseChannels.
@@ -426,7 +437,7 @@ TWVLoader = class(TComponent, IWVLoaderEvents)
/// which specifies the default browser ScrollBar style.
/// The `color-scheme` CSS property needs to be set on the corresponding page
/// to allow ScrollBar to follow light or dark theme. Please see
- /// [color-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/color-scheme#declaring_color_scheme_preferences)
+ /// [color-scheme](https://developer.mozilla.org/docs/Web/CSS/color-scheme#declaring_color_scheme_preferences)
/// for how `color-scheme` can be set.
/// CSS styles that modify the ScrollBar applied on top of native ScrollBar styling
/// that is selected with `ScrollBarStyle`.
diff --git a/source/uWVTypeLibrary.pas b/source/uWVTypeLibrary.pas
index 2504acc..a660370 100644
--- a/source/uWVTypeLibrary.pas
+++ b/source/uWVTypeLibrary.pas
@@ -613,7 +613,7 @@ interface
COREWEBVIEW2_PERMISSION_KIND_MULTIPLE_AUTOMATIC_DOWNLOADS = $00000007;
///
/// Indicates permission to read and write to files or folders on the device.
- /// Permission is requested when developers use the [File System Access API](https://developer.mozilla.org/en-US/docs/Web/API/File_System_Access_API)
+ /// Permission is requested when developers use the [File System Access API](https://developer.mozilla.org/docs/Web/API/File_System_Access_API)
/// to show the file or folder picker to the end user, and then request
/// "readwrite" permission for the user's selection.
///
@@ -625,7 +625,7 @@ interface
/// Indicates permission to play audio and video automatically on sites. This
/// permission affects the autoplay attribute and play method of the audio and
/// video HTML elements, and the start method of the Web Audio API. See the
- /// [Autoplay guide for media and Web Audio APIs](https://developer.mozilla.org/en-US/docs/Web/Media/Autoplay_guide) for details.
+ /// [Autoplay guide for media and Web Audio APIs](https://developer.mozilla.org/docs/Web/Media/Autoplay_guide) for details.
///
///
/// This is one of the COREWEBVIEW2_PERMISSION_KIND values.
@@ -643,7 +643,7 @@ interface
///
/// Indicates permission to send and receive system exclusive messages to/from MIDI
/// (Musical Instrument Digital Interface) devices. Permission is requested
- /// when developers use the [Web MIDI API](https://developer.mozilla.org/en-US/docs/Web/API/Web_MIDI_API)
+ /// when developers use the [Web MIDI API](https://developer.mozilla.org/docs/Web/API/Web_MIDI_API)
/// to request access to system exclusive MIDI messages.
///
///
@@ -2170,7 +2170,7 @@ interface
COREWEBVIEW2_SCROLLBAR_STYLE_DEFAULT = $00000000;
///
/// Window style fluent overlay scroll bar.
- /// Please see [Fluent UI](https:/-/developer.microsoft.com/en-us/fluentui#/)
+ /// Please see [Fluent UI](https://developer.microsoft.com/fluentui#/)
/// for more details on fluent UI.
///
///
@@ -4261,6 +4261,7 @@ EventRegistrationToken = record
/// `defaultSyncProxy` | When calling a method on a synchronous proxy, the result should also be a synchronous proxy. But in some cases, the sync/async context is lost (for example, when providing to native code a reference to a function, and then calling that function in native code). In these cases, the proxy will be asynchronous, unless this property is set.
/// `forceAsyncMethodMatches ` | This is an array of regular expressions. When calling a method on a synchronous proxy, the method call will be performed asynchronously if the method name matches a string or regular expression in this array. Setting this value to `Async` will make any method that ends with Async be an asynchronous method call. If an async method doesn't match here and isn't forced to be asynchronous, the method will be invoked synchronously, blocking execution of the calling JavaScript and then returning the resolution of the promise, rather than returning a promise.
/// `ignoreMemberNotFoundError` | By default, an exception is thrown when attempting to get the value of a proxy property that doesn't exist on the corresponding native class. Setting this property to `true` switches the behavior to match Chakra WinRT projection (and general JavaScript) behavior of returning `undefined` with no error.
+ /// `shouldPassTypedArraysAsArrays` | By default, typed arrays will be passed to host as IDispatch. Otherwise, set to true to pass typed arrays to host as array.
///
/// Host object proxies additionally have the following methods which run
/// locally.
@@ -4432,11 +4433,12 @@ EventRegistrationToken = record
/// `WindowCloseRequested` triggers when content inside the WebView
/// requested to close the window, such as after `window.close` is run. The
/// app should close the WebView and related app window if that makes sense
- /// to the app.
+ /// to the app. After the first window.close() call, this event may not fire
+ /// for any immediate back to back window.close() calls.
///
/// \snippet AppWindow.cpp WindowCloseRequested
///
- function add_WindowCloseRequested(const eventHandler: ICoreWebView2WindowCloseRequestedEventHandler;
+ function add_WindowCloseRequested(const eventHandler: ICoreWebView2WindowCloseRequestedEventHandler;
out token: EventRegistrationToken): HResult; stdcall;
///
/// Remove an event handler previously added with `add_WindowCloseRequested`.
@@ -5271,7 +5273,7 @@ EventRegistrationToken = record
/// a WebView as the target for a `window.open()` from inside the
/// requesting WebView. If this is set, the top-level window of this WebView
/// is returned as the opened
- /// [WindowProxy](https://developer.mozilla.org/en-US/docs/glossary/windowproxy)
+ /// [WindowProxy](https://developer.mozilla.org/docs/glossary/windowproxy)
/// to the opener script. If this is not set, then `Handled` is checked to
/// determine behavior for NewWindowRequested event.
/// CoreWebView2 provided in the `NewWindow` property must be on the same
@@ -5570,12 +5572,12 @@ EventRegistrationToken = record
/// When providing the response data, you should consider relevant HTTP
/// request headers just like an HTTP server would do. For example, if the
/// request was for a video resource in a HTML video element, the request may
- /// contain the [Range](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Range)
+ /// contain the [Range](https://developer.mozilla.org/docs/Web/HTTP/Headers/Range)
/// header to request only a part of the video that is streaming. In this
/// case, your response stream should be only the portion of the video
/// specified by the range HTTP request headers and you should set the
/// appropriate
- /// [Content-Range](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Range)
+ /// [Content-Range](https://developer.mozilla.org/docs/Web/HTTP/Headers/Content-Range)
/// header in the response.
///
function Get_Content(out Content: IStream): HResult; stdcall;
@@ -7465,7 +7467,7 @@ EventRegistrationToken = record
/// Basic HTTP Authentication request as described in
/// https://developer.mozilla.org/docs/Web/HTTP/Authentication, a Digest
/// HTTP Authentication request as described in
- /// https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Authorization#digest,
+ /// https://developer.mozilla.org/docs/Web/HTTP/Headers/Authorization#digest,
/// an NTLM authentication or a Proxy Authentication request.
///
/// The host can provide a response with credentials for the authentication or
@@ -8650,7 +8652,7 @@ EventRegistrationToken = record
/// The origin will be an empty string if the request is initiated by calling
/// `CoreWebView2.Navigate` on the external URI scheme. If a script initiates
/// the navigation, the `InitiatingOrigin` will be the top-level document's
- /// `Source`, for example, if `window.location` is set to `"calculator://", the
+ /// `Source`, for example, if `window.location` is set to `"calculator://"`, the
/// `InitiatingOrigin` will be set to `calculator://`. If the request is initiated
/// from a child frame, the `InitiatingOrigin` will be the source of that child frame.
/// If the `InitiatingOrigin` is
@@ -11009,32 +11011,43 @@ EventRegistrationToken = record
function Get_ReleaseChannels(out value: COREWEBVIEW2_RELEASE_CHANNELS): HResult; stdcall;
///
/// Sets the `ReleaseChannels`, which is a mask of one or more
- /// indicating which channels environment creation should search for.
- /// OR operation(s) can be applied to multiple to create a mask.
- /// The default value is a mask of all the channels. By default, environment
- /// creation searches for channels from most to least stable, using the first
- /// channel found on the device. When is provided, environment creation will
- /// only search for the channels specified in the set. Set to to reverse
- /// the search order so that the loader searches for the least stable build
- /// first. See for descriptions of each channel. Environment creation fails
- /// if it is unable to find any channel from the installed on the device.
- /// Use to verify which channel is used. If both a and are provided,
- /// the takes precedence. The can be overridden by the corresponding
- /// registry override or the environment variable . Set the value to a
- /// comma-separated string of integers, which map to the values: Stable (0),
- /// Beta (1), Dev (2), and Canary (3).
- /// For example, the values "0,2" and "2,0" indicate that the loader
- /// should only search for Dev channel and the WebView2 Runtime, using the
- /// order indicated by . Environment creation attempts to interpret each
- /// integer and treats any invalid entry as Stable channel.
+ /// `COREWEBVIEW2_RELEASE_CHANNELS` indicating which channels environment
+ /// creation should search for. OR operation(s) can be applied to multiple
+ /// `COREWEBVIEW2_RELEASE_CHANNELS` to create a mask. The default value is a
+ /// a mask of all the channels. By default, environment creation searches for
+ /// channels from most to least stable, using the first channel found on the
+ /// device. When `ReleaseChannels` is provided, environment creation will only
+ /// search for the channels specified in the set. Set `ChannelSearchKind` to
+ /// `COREWEBVIEW2_CHANNEL_SEARCH_KIND_LEAST_STABLE` to reverse the search order
+ /// so environment creation searches for least stable build first. See
+ /// `COREWEBVIEW2_RELEASE_CHANNELS` for descriptions of each channel.
+ /// `CreateCoreWebView2EnvironmentWithOptions` fails with
+ /// `HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)` if environment creation is unable
+ /// to find any channel from the `ReleaseChannels` installed on the device.
+ /// Use `GetAvailableCoreWebView2BrowserVersionStringWithOptions` on
+ /// `ICoreWebView2Environment` to verify which channel is used when this option
+ /// is set.
+ /// Examples:
///
/// | ReleaseChannels | Channel Search Kind: Most Stable (default) | Channel Search Kind: Least Stable |
/// | --- | --- | --- |
- /// |CoreWebView2ReleaseChannels.Beta \| CoreWebView2ReleaseChannels.Stable| WebView2 Runtime -> Beta | Beta -> WebView2 Runtime|
- /// |CoreWebView2ReleaseChannels.Canary \| CoreWebView2ReleaseChannels.Dev \| CoreWebView2ReleaseChannels.Beta \| CoreWebView2ReleaseChannels.Stable | WebView2 Runtime -> Beta -> Dev -> Canary | Canary -> Dev -> Beta -> WebView2 Runtime |
- /// |CoreWebView2ReleaseChannels.Canary| Canary | Canary |
- /// |CoreWebView2ReleaseChannels.Beta \| CoreWebView2ReleaseChannels.Canary \| CoreWebView2ReleaseChannels.Stable | WebView2 Runtime -> Beta -> Canary | Canary -> Beta -> WebView2 Runtime |
+ /// |COREWEBVIEW2_RELEASE_CHANNELS_BETA \| COREWEBVIEW2_RELEASE_CHANNELS_STABLE| WebView2 Runtime -> Beta | Beta -> WebView2 Runtime|
+ /// |COREWEBVIEW2_RELEASE_CHANNELS_CANARY \| COREWEBVIEW2_RELEASE_CHANNELS_DEV \| COREWEBVIEW2_RELEASE_CHANNELS_BETA \| COREWEBVIEW2_RELEASE_CHANNELS_STABLE| WebView2 Runtime -> Beta -> Dev -> Canary | Canary -> Dev -> Beta -> WebView2 Runtime |
+ /// |COREWEBVIEW2_RELEASE_CHANNELS_CANARY| Canary | Canary |
+ /// |COREWEBVIEW2_RELEASE_CHANNELS_BETA \| COREWEBVIEW2_RELEASE_CHANNELS_CANARY \| COREWEBVIEW2_RELEASE_CHANNELS_STABLE | WebView2 Runtime -> Beta -> Canary | Canary -> Beta -> WebView2 Runtime |
///
+ /// If both `BrowserExecutableFolder` and `ReleaseChannels` are provided, the
+ /// `BrowserExecutableFolder` takes precedence, regardless of whether or not the
+ /// channel of `BrowserExecutableFolder` is included in the `ReleaseChannels`.
+ /// `ReleaseChannels` can be overridden by the corresponding registry override
+ /// `ReleaseChannels` or the environment variable `WEBVIEW2_RELEASE_CHANNELS`.
+ /// Set the value to a comma-separated string of integers, which map to the
+ /// following release channel values: Stable (0), Beta (1), Dev (2), and
+ /// Canary (3). For example, the values "0,2" and "2,0" indicate that environment
+ /// creation should only search for Dev channel and the WebView2 Runtime, using the
+ /// order indicated by `ChannelSearchKind`. Environment creation attempts to
+ /// interpret each integer and treats any invalid entry as Stable channel. See
+ /// `CreateCoreWebView2EnvironmentWithOptions` for more details on overrides.
///
function Set_ReleaseChannels(value: COREWEBVIEW2_RELEASE_CHANNELS): HResult; stdcall;
end;
@@ -11057,7 +11070,7 @@ EventRegistrationToken = record
/// which specifies the default browser ScrollBar style.
/// The `color-scheme` CSS property needs to be set on the corresponding page
/// to allow ScrollBar to follow light or dark theme. Please see
- /// [color-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/color-scheme#declaring_color_scheme_preferences)
+ /// [color-scheme](https://developer.mozilla.org/docs/Web/CSS/color-scheme#declaring_color_scheme_preferences)
/// for how `color-scheme` can be set.
/// CSS styles that modify the ScrollBar applied on top of native ScrollBar styling
/// that is selected with `ScrollBarStyle`.
@@ -12082,7 +12095,7 @@ EventRegistrationToken = record
/// otherwise the method fails with `E_INVALIDARG`. Additional URI parts like
/// path and fragment are ignored. For example, "https://wwww.example.com/app1/index.html/"
/// is treated the same as "https://wwww.example.com". See the
- /// [MDN origin definition](https://developer.mozilla.org/en-US/docs/Glossary/Origin)
+ /// [MDN origin definition](https://developer.mozilla.org/docs/Glossary/Origin)
/// for more details.
///
/// \snippet ScenarioPermissionManagement.cpp SetPermissionState
@@ -12207,7 +12220,7 @@ EventRegistrationToken = record
ICoreWebView2Profile7 = interface(ICoreWebView2Profile6)
['{7B4C7906-A1AA-4CB4-B723-DB09F813D541}']
///
- /// Adds the [browser extension](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions)
+ /// Adds the [browser extension](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions)
/// using the extension path for unpacked extensions from the local device. Extension is
/// running right after installation.
/// The extension folder path is the topmost folder of an unpacked browser extension and
@@ -12279,7 +12292,7 @@ EventRegistrationToken = record
['{7EF7FFA0-FAC5-462C-B189-3D9EDBE575DA}']
///
/// This is the browser extension's ID. This is the same browser extension ID returned by
- /// the browser extension API [`chrome.runtime.id`](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/runtime/id).
+ /// the browser extension API [`chrome.runtime.id`](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/API/runtime/id).
/// Please see that documentation for more details on how the ID is generated.
/// After an extension is removed, calling `Id` will return the id of the extension that is removed.
/// The caller must free the returned string with `CoTaskMemFree`. See
@@ -12290,7 +12303,7 @@ EventRegistrationToken = record
/// This is the browser extension's name. This value is defined in this browser extension's
/// manifest.json file. If manifest.json define extension's localized name, this value will
/// be the localized version of the name.
- /// Please see [Manifest.json name](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/name)
+ /// Please see [Manifest.json name](https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/manifest.json/name)
/// for more details.
/// After an extension is removed, calling `Name` will return the name of the extension that is removed.
/// The caller must free the returned string with `CoTaskMemFree`. See
@@ -12468,6 +12481,10 @@ EventRegistrationToken = record
/// Setting this property may clear User Agent Client Hints headers
/// Sec-CH-UA-* and script values from navigator.userAgentData. Current
/// implementation behavior is subject to change.
+ /// The User Agent set will also be effective on service workers
+ /// and shared workers associated with the WebView.
+ /// If there are multiple WebViews associated with the same service worker or
+ /// shared worker, the last User Agent set will be used.
/// Returns `HRESULT_FROM_WIN32(ERROR_INVALID_STATE)` if the owning WebView is
/// closed.
///
@@ -12879,7 +12896,7 @@ EventRegistrationToken = record
///
/// Representation of a DOM
- /// [File](https://developer.mozilla.org/en-US/docs/Web/API/File) object
+ /// [File](https://developer.mozilla.org/docs/Web/API/File) object
/// passed via WebMessage. You can use this object to obtain the path of a
/// File dropped on WebView2.
///
diff --git a/source/uWVVersion.inc b/source/uWVVersion.inc
index 2a54e1c..fce0f32 100644
--- a/source/uWVVersion.inc
+++ b/source/uWVVersion.inc
@@ -1,12 +1,12 @@
WEBVIEW2LOADERLIB_VERSION_MAJOR = 1;
WEBVIEW2LOADERLIB_VERSION_MINOR = 0;
- WEBVIEW2LOADERLIB_VERSION_RELEASE = 2535;
- WEBVIEW2LOADERLIB_VERSION_BUILD = 41;
+ WEBVIEW2LOADERLIB_VERSION_RELEASE = 2592;
+ WEBVIEW2LOADERLIB_VERSION_BUILD = 51;
// For full API compatibility, WebView4Delphi requires the same
// WebView2 Runtime version mentioned in the release notes :
// https://docs.microsoft.com/en-us/microsoft-edge/webview2/release-notes
- CHROMIUM_VERSION_MAJOR = 125;
+ CHROMIUM_VERSION_MAJOR = 126;
CHROMIUM_VERSION_MINOR = 0;
CHROMIUM_VERSION_RELEASE = WEBVIEW2LOADERLIB_VERSION_RELEASE;
CHROMIUM_VERSION_BUILD = WEBVIEW2LOADERLIB_VERSION_BUILD;
\ No newline at end of file
diff --git a/update_WebView4Delphi.json b/update_WebView4Delphi.json
index b3f1cf9..5416b28 100644
--- a/update_WebView4Delphi.json
+++ b/update_WebView4Delphi.json
@@ -2,9 +2,9 @@
"UpdateLazPackages" : [
{
"ForceNotify" : true,
- "InternalVersion" : 152,
+ "InternalVersion" : 153,
"Name" : "webview4delphi.lpk",
- "Version" : "1.0.2535.41"
+ "Version" : "1.0.2592.51"
}
],
"UpdatePackageData" : {
