Skip to content

Commit 95ef576

Browse files
authored
v2.0.0-beta.3
1 parent 9b1ab89 commit 95ef576

1 file changed

Lines changed: 34 additions & 3 deletions

File tree

README.md

Lines changed: 34 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,11 @@ The `OnAcceleratorKeyPressed` event now provides 1:1 access to the underlying Wi
7878
- **Standalone Argument Logic**: Argument wrappers have been moved to dedicated files (e.g., `WebView2AcceleratorKeyPressedEventArgs.cs`).
7979
- **Lean Core**: Reduced `WebViewManager.cs` complexity by outsourcing event data structures.
8080

81+
#### **3. Process Stability & Authentication**
82+
- **Robust Crash Handling**: `OnProcessFailed` provides deep insights into process crashes, allowing for automated recovery or logging.
83+
- **Crash Dump Management**: `FailureReportFolderPath` allows redirection of diagnostic files.
84+
- **Native Authentication**: `OnBasicAuthenticationRequested` brings support for server-level auth prompts, including asynchronous credential entry via the `.Complete()` method.
85+
8186
---
8287

8388
## 🚀 What's New in v2.0.0-beta.2 - COM Versioning & Handle Alignment
@@ -98,12 +103,11 @@ You can now access the `.version` property on all primary COM objects.
98103
- **GUID Collision Resolution**: Fixed internal interface IDs that caused registration issues in v2.0.0-beta.1.
99104
- **`ParentWindowHandle`**: New property to retrieve the handle passed during initialization.
100105

101-
102106
<p align="center">
103107
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%">
104108
</p>
105109

106-
## 📖 NetWebView2Lib Version 2.0.0-beta.3 (Quick Reference)
110+
## 📖 NetWebView2Lib Version 2.0.0-beta.3 (2026-02-11) (Quick Reference)
107111

108112
### NetWebView2Lib (ProgId: NetWebView2.Manager)
109113

@@ -205,6 +209,13 @@ Returns the parent window handle provided during initialization. [Format: `[HAND
205209
A comma-separated list of Virtual Key codes to be blocked synchronously (e.g., "116,123").
206210
`object.BlockedVirtualKeys = "116,123"`
207211

212+
##### FailureReportFolderPath
213+
Sets or gets the path where the WebView2 browser stores crash reports (dump files).
214+
- **Default**: If NOT set by the user, the system automatically uses the `Crashes` subfolder within the `UserDataFolder` (assigned during `.Initialize`).
215+
- **Manual Override**: You can set a custom path **before** calling `.Initialize`.
216+
- **Example (Custom Path)**: `object.FailureReportFolderPath = "C:\MyCustomCrashDumps"`
217+
- **Example (Read current)**: `$sPath = object.FailureReportFolderPath`
218+
208219
#### ===Method===
209220

210221
##### Initialize
@@ -365,7 +376,6 @@ Enables or disables the Web Message communication system.
365376
Enables or disables the browser status bar.
366377
`object.SetStatusBarEnabled(Enabled As Boolean)`
367378

368-
369379
##### CapturePreview
370380
Captures a screenshot of the current view to a file.
371381
`object.CapturePreview(FilePath As String, Format As String)`
@@ -584,6 +594,27 @@ Fired when an accelerator key is pressed. Allows blocking browser shortcuts.
584594
IsKeyReleased (bool): True if the event is a key up.
585595
KeyEventLParam (int): Gets the LPARAM value that accompanied the window message*
586596

597+
##### OnProcessFailed
598+
Fired when a renderer or other browser process fails/crashes.
599+
`object_OnProcessFailed(Sender As Object, ParentHandle As HWND, Args As Object)`
600+
*Args properties:
601+
ProcessFailedKind (int): The kind of process failure.
602+
Reason (int): The reason for the failure.
603+
ExitCode (int): The exit code of the failed process.
604+
ProcessDescription (string): A description of the process.*
605+
606+
##### OnBasicAuthenticationRequested
607+
Fired when the browser requires basic authentication credentials for a URI.
608+
`object_OnBasicAuthenticationRequested(Sender As Object, ParentHandle As HWND, Args As Object)`
609+
*Args properties:
610+
Uri (string): The URI requesting authentication.
611+
Challenge (string): The authentication challenge string.
612+
Cancel (bool): Set to True to cancel the request.
613+
UserName (string): The username to provide.
614+
Password (string): The password to provide.
615+
*Args methods:
616+
Complete(): Notifies the browser that credentials have been set (supports asynchronous data gathering).*
617+
587618

588619
---
589620

0 commit comments

Comments
 (0)