Merge pull request #98 from ioa747/neo

MappedFolder

Author: ioa747

NetWebView2Lib.au3

@@ -6,7 +6,7 @@
 
 #Tidy_Parameters=/tcb=-1
 
-; NetWebView2Lib.au3 - Script Version: 2026.2.16.3 🚩
+; NetWebView2Lib.au3 - Script Version: 2026.2.16.20 🚩
 
 #include <Array.au3>
 #include <GUIConstantsEx.au3>
@@ -822,7 +822,7 @@ EndFunc   ;==>_NetWebView2_PrintToPdfStream
 ; Description ...: Adds a JavaScript to be executed before any other script when a new page is loaded.
 ; Syntax.........: _NetWebView2_AddInitializationScript($oWeb, $sScript)
 ; Parameters ....: $oWeb    - The NetWebView2 Manager object.
-;                  $sScript - The JavaScript code to inject.
+;                  $vScript - The JavaScript code to inject (String) OR the full path to a JavaScript file.
 ; Return values .: Success  - Returns a Script ID (string).
 ;                  Failure  - Returns the error message and sets @error.
 ; Author ........: ioa747, mLipok
@@ -832,12 +832,16 @@ EndFunc   ;==>_NetWebView2_PrintToPdfStream
 ; Link ..........:
 ; Example .......: No
 ; ===============================================================================================================================
-Func _NetWebView2_AddInitializationScript($oWebV2M, $sScript)
+Func _NetWebView2_AddInitializationScript($oWebV2M, $vScript)
 	If (Not IsObj($oWebV2M)) Or ObjName($oWebV2M, $OBJ_PROGID) <> 'NetWebView2.Manager' Then Return SetError(1, 0, "ERROR: Invalid Object")
-	Local $sScriptId = $oWebV2M.AddInitializationScript($sScript)
+
+	; Smart Detection
+	If FileExists($vScript) Then $vScript = FileRead($vScript)
+
+	Local $sScriptId = $oWebV2M.AddInitializationScript($vScript)
 	If StringInStr($sScriptId, "ERROR:") Then Return SetError(2, 0, $sScriptId)
 	Return SetError(0, 0, $sScriptId)
-EndFunc   ;==>_NetWebView2_AddInitializationScript
+EndFunc   ;==>New_NetWebView2_AddInitializationScript
 
 ; #FUNCTION# ====================================================================================================================
 ; Name...........: _NetWebView2_RemoveInitializationScript
@@ -2149,3 +2153,4 @@ EndFunc   ;==>__NetWebView2_Events__OnScreenCaptureStarting
 #EndRegion ; NetWebView2Lib UDF - === EVENT HANDLERS ===
 
 
+

README.md

@@ -23,7 +23,7 @@ https://www.autoitscript.com/forum/topic/213375-webview2autoit-autoit-webview2-c
 ### 🛠 Prerequisites
 
 1. **.NET Framework 4.8** or higher.
-2. **Microsoft Edge WebView2 Runtime**.
+2. **Microsoft Edge WebView2 Runtime version 128.0.2739.15 or higher**.
 
    * *The registration script will check for this and provide a download link if missing.*
 
@@ -62,54 +62,105 @@ This project is provided "as-is". You are free to use, modify, and distribute it
 <p align="center">
   <img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%">
 </p>
+## 🚀 What's New in v2.0.0-stable - Professional Naming & Absolute Stability
 
-## 🚀 What's New in v2.0.0-beta.3 - AcceleratorKey Detail & Refactoring
-
-This update focuses on deep keyboard interception and code modularity.
+This stable release marks the transition to a professional, standardized COM architecture and introduces high-performance infrastructure for production-grade applications.
 
 ### ⚡ Key Features & Enhancements
 
-#### **1. PhysicalKeyStatus Expansion**
-The `OnAcceleratorKeyPressed` event now provides 1:1 access to the underlying Windows keyboard state.
-- **New Properties**: `RepeatCount`, `ScanCode`, `IsExtendedKey`, `IsMenuKeyDown`, `WasKeyDown`, and `IsKeyReleased`.
-- **Use Case**: Detect held keys, distinguish between left/right Alt/Ctrl, and implement complex hotkey logic without Win32 API calls.
+#### **1. COM Standardizing (NetWebView2Lib)**
+The library has transitioned to a consistent naming convention for all subsystems, improving discoverability and professional alignment.
+- **New ProgIDs**: `NetWebView2Lib.WebView2Manager`, `NetWebView2Lib.WebView2Bridge`, and `NetWebView2Lib.WebView2Parser`.
+- **Full Backward Compatibility**: Legacy ProgIDs (e.g., `NetWebView2.Manager`) continue to function via an inheritance-based compatibility layer.
 
-#### **2. Performance & Modularity**
-- **Standalone Argument Logic**: Argument wrappers have been moved to dedicated files (e.g., `WebView2AcceleratorKeyPressedEventArgs.cs`).
-- **Lean Core**: Reduced `WebViewManager.cs` complexity by outsourcing event data structures.
+#### **2. Threading & Stability Mastery**
+Identified and resolved complex threading deadlocks in asynchronous handlers. 
+- **UI-Thread Marshalling**: Explicit synchronization ensure that events like Context Menus, Downloads, and IFrame HTML extraction always safely interact with the AutoIt UI thread.
+- **SDK Resilience**: Reflection-based URI retrieval for IFrames ensures compatibility across different versions of the WebView2 SDK.
 
-#### **3. Process Stability & Authentication**
-- **Robust Crash Handling**: `OnProcessFailed` provides deep insights into process crashes, allowing for automated recovery or logging.
-- **Crash Dump Management**: `FailureReportFolderPath` allows redirection of diagnostic files.
-- **Native Authentication**: `OnBasicAuthenticationRequested` brings support for server-level auth prompts, including asynchronous credential entry via the `.Complete()` method.
+#### **3. Standardized SDK Locking (v1.0.2739.15)**
+To ensure maximum reliability across the broadest possible range of Windows installations, we have standardized the core engine on a specific, high-stability SDK version.
+- **Fixed Version**: Locked to **WebView2 SDK 1.0.2739.15** (Released August 26, 2024).
+- **Runtime Requirement**: Requires **WebView2 Runtime 128.0.2739.15** or newer.
+- **Strategic Choice**: This version provides a "Sweet Spot" of features—including full support for IFrame scraping, Basic Authentication, and Process Failure events—while maintaining compatibility with the vast majority of current "Evergreen" browser installations.
+- **Strict Validation**: The registration utility (`Register_web2.au3`) has been updated to perform a mandatory check for this minimum runtime version, preventing obscure startup errors.
 
----
+#### **4. Enriched Verbose Logging**
+A redesigned diagnostic system for easier debugging of complex workflows.
+- **Branded & Traceable**: Every log line now includes the `+++[NetWebView2Lib]` prefix and the instance-specific `[HANDLE:0x...]`.
+- **Comprehensive Event Tracing**: Detailed logs for Navigation, Resource Requests (with HTTP codes), Focus changes, and Web Messages.
+- **Default Folder Sync**: Renamed the default crash folder to `FailureReportFolder` for better parity with internal WebView2 parameters.
 
-## 🚀 What's New in v2.0.0-beta.2 - COM Versioning & Handle Alignment
+####  **4. High-Performance IFrame Scraping**
+Bulk extraction methods (`GetFrameUrls`, `GetFrameNames`) allow for high-speed metadata retrieval from complex multi-frame layouts, essential for advanced web scraping.
 
-This update introduces the ability to query the DLL version directly and aligns window handles with AutoIt's native format.
+--- 
+#### 🖼️ IFrame HTML Extraction 
 
-### ⚡ Key Features & Enhancements
+We implemented a robust system to track and extract HTML from iframes, including cross-origin ones.
+
+##### 1. Frame Tracking System
+
+A dynamic registration system was added to 
+
+WebView2Manager.cs to track the lifecycle of all iframes.
+
+- **Initialization**: Automatically subscribes to `CoreWebView2.FrameCreated`.
+- **Lifecycle Management**: Tracks `CoreWebView2Frame` objects in a thread-safe list and automatically removes them on `Destroyed`.
+
+##### 2. New IFrame API
+
+Six new COM methods were added to the 
+
+IWebViewActions interface (Standardized & Compatibility Layers):
+
+|Method|Description|
+|---|---|
+|GetFrameCount()|Returns the number of tracked iframes.|
+|GetFrameUrl(index)|Returns the URL of a specific iframe.|
+|GetFrameName(index)|Returns the Name of a specific iframe.|
+|GetFrameUrls()|Returns the **entire array** of frame URLs as a pipe-separated string.|
+|GetFrameNames()|Returns the **entire array** of frame names as a pipe-separated string.|
+|GetFrameHtmlSource(index)|Asynchronously initiates HTML extraction for a frame.|
+
+#### 🩺Verbose Diagnostic Mode
+
+A new `Verbose` property was added to allow real-time diagnostic logging to the SciTE console (or any stdout listener).
+The diagnostic logs use a distinctive prefix and include the instance handle for easier filtering in multi-window applications.
+
+```autoit
+$oWebV2M.Verbose = True ; Enable diagnostic logging
+```
 
-#### **1. Advanced Handle Formatting (`[HANDLE:0x...]`)**
-All window handles returned by the library (via properties or events) are now formatted as strings compatible with AutoIt's Advanced Window Descriptions.
-- **Direct Compatibility**: Handles like `[HANDLE:0x00010203]` can be passed directly to `WinExists`, `WinSetTitle`, etc., without `HWnd()` conversion.
+When enabled, the console will show entries like: 
+`+++[NetWebView2Lib][HANDLE:0x...][HH:mm:ss.fff] Message`
+
+`+++[NetWebView2Lib][HANDLE:0x004F1128][14:20:33.456] Initialize request: parent=[HANDLE:0x...], x=0, y=0, w=1024, h=768` 
+`+++[NetWebView2Lib][HANDLE:0x004F1128][14:20:34.123] WebView2 Initialized successfully.` 
+`+++[NetWebView2Lib][HANDLE:0x004F1128][14:20:35.789] Navigate: https://www.google.com`
+
+#### 🔄 Backward Compatibility (Legacy ProgIDs)
+
+To ensure stability for existing scripts not using the UDF, the following legacy ProgIDs are still supported through a compatibility layer:
+
+| Legacy Object    | Legacy ProgID                  | v2.0 Standardized ProgID         |
+| :--------------- | :----------------------------- | :------------------------------- |
+| `WebViewManager` | `NetWebView2.Manager`          | `NetWebView2Lib.WebView2Manager` |
+| `WebViewBridge`  | `NetWebView2Lib.WebViewBridge` | `NetWebView2Lib.WebView2Bridge`  |
+| `JsonParser`     | `NetJson.Parser`               | `NetWebView2Lib.WebView2Parser`  |
+
+> [!NOTE]
+> Objects created with legacy ProgIDs will function exactly the same but will report their legacy class names via `ObjName()`.
 
-#### **2. COM Version Exposure**
-You can now access the `.version` property on all primary COM objects.
-- **`Manager.version`**, **`Bridge.version`**, **`Parser.version`**.
 
-#### **3. Stabilized Infrastructure**
-- **GUID Collision Resolution**: Fixed internal interface IDs that caused registration issues in v2.0.0-beta.1.
-- **`ParentWindowHandle`**: New property to retrieve the handle passed during initialization.
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%">
 </p>
 
-## 📖 NetWebView2Lib Version 2.0.0-beta.3 (2026-02-11) (Quick Reference)
+## 📖 NetWebView2Lib Version 2.0.0-stable (Quick Reference)
 
-### NetWebView2Lib (ProgId: NetWebView2.Manager)
+### WebView2Manager (ProgId: NetWebView2Lib.WebView2Manager)
 
 #### ===Properties===
 
@@ -181,6 +232,10 @@ Enables or disables the `OnWebResourceResponseReceived` event entirely.
 Determines whether `OnWebResourceResponseReceived` triggers for all resources (False) or only for the main document (True). Essential for preventing GUI deadlocks in AutoIt.
 `object.HttpStatusCodeDocumentOnly = Value`
 
+##### Verbose
+Enable diagnostic logging to console.  (before `$object.Initialize()`)
+`object.Verbose = Value`
+
 ##### IsDownloadHandled
 Determines whether the download is handled by the application. If set to **True** during `OnDownloadStarting`, the internal Edge download is cancelled.
 `object.IsDownloadHandled = Value`
@@ -211,14 +266,14 @@ A comma-separated list of Virtual Key codes to be blocked synchronously (e.g., "
 
 ##### FailureReportFolderPath
 Sets or gets the path where the WebView2 browser stores crash reports (dump files).
-- **Default**: If NOT set by the user, the system automatically uses the `Crashes` subfolder within the `UserDataFolder` (assigned during `.Initialize`).
+- **Default**: If NOT set by the user, the system automatically uses the `FailureReportFolderPath` subfolder within the `UserDataFolder` (assigned during `.Initialize`).
 - **Manual Override**: You can set a custom path **before** calling `.Initialize`.
 - **Example (Custom Path)**: `object.FailureReportFolderPath = "C:\MyCustomCrashDumps"`
 - **Example (Read current)**: `$sPath = object.FailureReportFolderPath`
 
 ##### Version
- Allows AutoIt to verify the DLL version at runtime for compatibility checks.
-`object.version
+Allows AutoIt to verify the DLL version at runtime for compatibility checks.
+`object.Version`
 
 #### ===Method===
 
@@ -316,6 +371,30 @@ Clears all active ad block rules.
 Asynchronously retrieves the full HTML source (sent via OnMessageReceived with 'HTML_SOURCE|').
 `object.GetHtmlSource()`
 
+##### GetFrameCount
+Returns the number of currently tracked iframes.
+`object.GetFrameCount()`
+
+##### GetFrameUrl
+Returns the URL of the specified frame index.
+`object.GetFrameUrl(Index As Integer)`
+
+##### GetFrameName
+Returns the Name attribute of the specified frame index.
+`object.GetFrameName(Index As Integer)`
+
+##### GetFrameUrls
+Returns a pipe-separated string of all tracked iframe URLs.
+`object.GetFrameUrls()`
+
+##### GetFrameNames
+Returns a pipe-separated string of all tracked iframe names.
+`object.GetFrameNames()`
+
+##### GetFrameHtmlSource
+Asynchronously retrieves the HTML of the frame at the specified index (sent via OnMessageReceived with 'FRAME_HTML_SOURCE|Index|').
+`object.GetFrameHtmlSource(Index As Integer)`
+
 ##### GetSelectedText
 Asynchronously retrieves the currently selected text (sent via OnMessageReceived with 'SELECTED_TEXT|').
 `object.GetSelectedText()`
@@ -622,12 +701,12 @@ Fired when the browser requires basic authentication credentials for a URI.
 
 ---
 
-### JsonParser (ProgId: NetJson.Parser)
+### WebView2Parser (ProgId: NetWebView2Lib.WebView2Parser)
 
 #### ===Properties===
 ##### Version
- Allows AutoIt to verify the DLL version at runtime for compatibility checks.
-`object.version
+Allows AutoIt to verify the DLL version at runtime for compatibility checks.
+`object.Version`
 
 #### ===Methods===
 
@@ -751,3 +830,4 @@ Sorts a JSON array by a specific key.
 Removes duplicate objects from a JSON array based on a key's value.
 `bool SelectUnique(ArrayPath As String, Key As String)`
 
+---

examples/014-pdfJS-Static_PDF_Viewer.au3

@@ -52,7 +52,7 @@ Func _Example()
 	#EndRegion ; GUI CREATION
 
 	; Adds a JavaScript library to be executed before any other script when a new page is loaded.
-	Local $sScriptId = New_NetWebView2_AddInitializationScript($oWeb, @ScriptDir & "\JS_Lib\NetWebView2Lib_pdfjs_Tools.js")
+	Local $sScriptId = _NetWebView2_AddInitializationScript($oWeb, @ScriptDir & "\JS_Lib\NetWebView2Lib_pdfjs_Tools.js")
 	ConsoleWrite("$sScriptId=" & $sScriptId & @CRLF)
 
 	; navigate to the page
@@ -306,15 +306,3 @@ Func __SetupStaticPDF(ByRef $oWeb, $s_PDF_Path, $sExpectedTitle, $bBlockLinks =
 	$oWeb.DisableBrowserFeatures()
 	$oWeb.LockWebView()
 EndFunc   ;==>__SetupStaticPDF
-
-; New to replace _NetWebView2_AddInitializationScript in UDF
-Func New_NetWebView2_AddInitializationScript($oWebV2M, $vScript)
-	If (Not IsObj($oWebV2M)) Or ObjName($oWebV2M, $OBJ_PROGID) <> 'NetWebView2.Manager' Then Return SetError(1, 0, "ERROR: Invalid Object")
-
-	; Smart Detection
-	If FileExists($vScript) Then $vScript = FileRead($vScript)
-
-	Local $sScriptId = $oWebV2M.AddInitializationScript($vScript)
-	If StringInStr($sScriptId, "ERROR:") Then Return SetError(2, 0, $sScriptId)
-	Return SetError(0, 0, $sScriptId)
-EndFunc   ;==>New_NetWebView2_AddInitializationScript

examples/017-MappedFolder.au3

@@ -0,0 +1,61 @@
+#AutoIt3Wrapper_UseX64=y
+#AutoIt3Wrapper_Run_AU3Check=Y
+#AutoIt3Wrapper_AU3Check_Stop_OnWarning=y
+#AutoIt3Wrapper_AU3Check_Parameters=-d -w 1 -w 2 -w 3 -w 4 -w 5 -w 6 -w 7
+
+; 017-MappedFolder.au3
+
+#include <GUIConstantsEx.au3>
+#include <WindowsConstants.au3>
+
+#include "..\NetWebView2Lib.au3"
+
+_Example()
+
+Func _Example()
+	Local $oMyError = ObjEvent("AutoIt.Error", __NetWebView2_COMErrFunc)
+	#forceref $oMyError
+
+	#Region ; GUI CREATION
+
+	; Create the GUI
+	Local $hGUI = GUICreate("WebView2 .NET Manager - MappedFolder Demo", 1000, 800, -1, -1, BitOR($WS_OVERLAPPEDWINDOW, $WS_CLIPCHILDREN))
+	GUISetBkColor(0x1A1A1A, $hGUI)
+
+	; Initialize WebView2 Manager and register events
+	Local $oWebV2M = _NetWebView2_CreateManager()
+	If @error Then Return SetError(@error, @extended, $oWebV2M)
+
+	; initialize browser - put it on the GUI
+	Local $sProfileDirectory = @ScriptDir & "\NetWebView2Lib-UserDataFolder"
+	_NetWebView2_Initialize($oWebV2M, $hGUI, $sProfileDirectory, 0, 0, 0, 0, True, True, 1.2, "0x2B2B2B")
+
+	; Now that it is Ready, we define Mapping & Scripts
+    Local $sLocalFolder = @ScriptDir & "\MappedFolder"
+	_NetWebView2_SetVirtualHostNameToFolderMapping($oWebV2M, "myapp.local", $sLocalFolder, 0)
+
+    ; Finish Navigate
+	_NetWebView2_Navigate($oWebV2M, "https://myapp.local/index.html")
+
+	; show the GUI after browser was fully initialized
+	GUISetState(@SW_SHOW)
+
+	#EndRegion ; GUI CREATION
+
+
+	#Region ; GUI Loop
+	; Main Loop
+	While 1
+		Switch GUIGetMsg()
+			Case $GUI_EVENT_CLOSE
+				ExitLoop
+		EndSwitch
+	WEnd
+
+	Local $oJSBridge
+	_NetWebView2_CleanUp($oWebV2M, $oJSBridge)
+	GUIDelete($hGUI)
+	#EndRegion ; GUI Loop
+
+EndFunc   ;==>_Example
+

examples/MappedFolder/index.html

@@ -0,0 +1,24 @@
+<!DOCTYPE html>
+<html>
+<head>
+	<meta charset="UTF-8">
+    <title>1.5.1 Virtual Host Demo</title>
+    <style>
+        body { background: #1a1a1a; color: #00ff00; font-family: 'Courier New', Courier, monospace; text-align: center; padding-top: 50px; }
+        .box { border: 2px solid #00ff00; display: inline-block; padding: 20px; border-radius: 10px; }
+    </style>
+</head>
+<body>
+    <div class="box">
+        <h1>🏠 Virtual Host Mapping OK!</h1>
+        <p>This file is served from a local folder via <b>https://myapp.local</b></p>
+        <p id="script-status">Initialization Script Status: Waiting...</p>
+    </div>
+    <script>
+        // This will be updated by the initialization script if it wasn't removed too fast
+        window.setScriptStatus = function(status) {
+            document.getElementById('script-status').innerText = "Initialization Script Status: " + status;
+        };
+    </script>
+</body>
+</html>