From 562371b97334e016d6c752fe84bbd19ebd8bd4b2 Mon Sep 17 00:00:00 2001
From: Steve Nessen <stnessen@microsoft.com>
Date: Fri, 9 May 2025 15:06:10 +0200
Subject: [PATCH] Add demo scenario for Additional Objects passed using the
 WebMessageObjects API

---
 ...View2_WinUI3_Sample (Package).assets.cache | Bin 0 -> 1669 bytes
 .../WebView2_WinUI3_Sample (Package).wapproj  |   4 +-
 ...View2_WinUI3_Sample (Package).wapproj.user |   4 +
 .../WebView2_WinUI3_Sample/MainWindow.xaml    |  16 ++-
 .../WebView2_WinUI3_Sample/MainWindow.xaml.cs |   5 +
 .../Scenario_FileHandle.cs                    |  74 +++++++++++++
 .../WebView2_WinUI3_Sample.csproj             |   8 +-
 .../assets/ScenarioFileHandle.html            |  98 ++++++++++++++++++
 8 files changed, 200 insertions(+), 9 deletions(-)
 create mode 100644 SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample (Package)/WebView2_WinUI3_Sample (Package).assets.cache
 create mode 100644 SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample (Package)/WebView2_WinUI3_Sample (Package).wapproj.user
 create mode 100644 SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/Scenario_FileHandle.cs
 create mode 100644 SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/assets/ScenarioFileHandle.html

diff --git a/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample (Package)/WebView2_WinUI3_Sample (Package).assets.cache b/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample (Package)/WebView2_WinUI3_Sample (Package).assets.cache
new file mode 100644
index 0000000000000000000000000000000000000000..998560a3ca6194077412871e486ca2237143bbd1
GIT binary patch
literal 1669
zcmcIkU2hUW6h)<_SZS@*QtL;Fkr$)OF2xm$FRj>yv^E4PCT3n1=0Yc3cGjI)D2Wfg
z`-k)o=&R4hqz_H}7be~*EUsXKH9E-&yUd+)&)z%dmbbUoFGV7e?{|-mi(hu?AKtus
zwfnK~twf)FqN~RT#*?=jN0HC(zh1zg2}^}6J!cJ%3*MC4OQ<W<7<9AhWGb}99Ll>w
zs}{Gl4WHR`k8@k7pyXK4y6a+?+B=WX$M#1^GKQ|{TGljlU0W*{=9D^#>l{K6D3MWw
z`hOY`L(CxJi1ZkFKY7N`9%<Q!dQL}HBVfFUCluo>;&+UytZM(x)5qk608bDhp#wH=
z5Y6#hAc<==4y+akf>Dtz3@dxQ<yr02CbL1L(%JlB-b`l;WT-1uW5T!WR8{(vaZ=s4
zJfLLP-vU`4kSVV4QXl+!vV``qZ(ZygqNDmo3@qkaHm7U39PxZdvNp=?GUtKiwapxH
zEXg`Rf;R7Pi-M<7+g7DbAm$MBh|7ot#1+IM;ws`AVhNE%EF<{8S9$n18n2_4u*Q{v
z#vA`hW8OS_9dC|kyfx5x8-IhfiVx9Us|^#K7pvj*WZan_G0$R2l-jP%8cf=~A~cx;
zbZXPG1<X`HaJvIEy65>2En9NGa;EkTCV-#^T3t;5sU`p!$$#23Nc>_*<(vry3*GL1
zV#{?gHD2$KvFE}*D$!F$*<v_qP`BBTO%kdWC1+sA`+;dPL(^pXrpb((CcZ8N$i1Em
z)BTua5rkywnLAa#USu9LB=>qN0qeLG7b<<1mMEZGn+&}8F!R0O*oheQ#_3X)gV2)<
XAsfXM8@`Wl<;_3l`gz^^TzT^c5b@x$

literal 0
HcmV?d00001

diff --git a/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample (Package)/WebView2_WinUI3_Sample (Package).wapproj b/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample (Package)/WebView2_WinUI3_Sample (Package).wapproj
index 02d3c31c..b5a398db 100644
--- a/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample (Package)/WebView2_WinUI3_Sample (Package).wapproj	
+++ b/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample (Package)/WebView2_WinUI3_Sample (Package).wapproj	
@@ -67,8 +67,8 @@
     </ProjectReference>
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="Microsoft.Windows.SDK.BuildTools" Version="10.0.22621.1" />
-    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.3.230602002">
+    <PackageReference Include="Microsoft.Windows.SDK.BuildTools" Version="10.0.26100.3916" />
+    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.7.250401001">
       <IncludeAssets>build</IncludeAssets>
     </PackageReference>
   </ItemGroup>
diff --git a/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample (Package)/WebView2_WinUI3_Sample (Package).wapproj.user b/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample (Package)/WebView2_WinUI3_Sample (Package).wapproj.user
new file mode 100644
index 00000000..88a55094
--- /dev/null
+++ b/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample (Package)/WebView2_WinUI3_Sample (Package).wapproj.user	
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="Current" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <PropertyGroup />
+</Project>
\ No newline at end of file
diff --git a/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/MainWindow.xaml b/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/MainWindow.xaml
index e139d329..68e1c174 100644
--- a/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/MainWindow.xaml
+++ b/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/MainWindow.xaml
@@ -9,14 +9,20 @@
     
     mc:Ignorable="d">
 
+
     <Grid>
         <Grid.RowDefinitions>
+            <RowDefinition Height="Auto"/>
             <RowDefinition Height="50"/>
             <RowDefinition Height="*"/>
             <RowDefinition Height="50"/>
         </Grid.RowDefinitions>
-
-        <Grid Grid.Row="0" Background="LightGray">
+        <MenuBar Grid.Row="0">
+            <MenuBarItem Title="Scenarios">
+                <MenuFlyoutItem Text="Share File Handles" Click="MenuFlyoutItem_Click"/>
+            </MenuBarItem>
+        </MenuBar>
+        <Grid Grid.Row="1" Background="LightGray">
             <Grid.ColumnDefinitions>
                 <ColumnDefinition Width="*"/>
                 <ColumnDefinition Width="50"/>
@@ -25,9 +31,9 @@
             <Button Grid.Column="1" x:Name="Go" Content="Go" Click="Go_OnClick" VerticalAlignment="Center" HorizontalAlignment="Center"/>
         </Grid>
 
-        <WebView2 x:Name="WebView2" Grid.Row="1"/>
+        <WebView2 x:Name="WebView2" Grid.Row="2"/>
 
-        <Rectangle Grid.Row="2" Fill="LightGray"/>
-        <TextBlock x:Name="StatusBar" Text="WebView2" VerticalAlignment="Center" Grid.Row="2" Margin="10,0,10,0"/>
+        <Rectangle Grid.Row="3" Fill="LightGray"/>
+        <TextBlock x:Name="StatusBar" Text="WebView2" VerticalAlignment="Center" Grid.Row="3" Margin="10,0,10,0"/>
     </Grid>
 </Window>
diff --git a/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/MainWindow.xaml.cs b/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/MainWindow.xaml.cs
index c9d8ada5..d9185d35 100644
--- a/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/MainWindow.xaml.cs
+++ b/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/MainWindow.xaml.cs
@@ -158,5 +158,10 @@ private string GetWebView2Version(WebView2 webView2)
 
             return $"{runtimeVersion}; {sdkVersion}";
         }
+
+        private void MenuFlyoutItem_Click(object sender, RoutedEventArgs e)
+        {
+            new Scenario_FileHandle().Execute(WebView2);
+        }
     }
 }
diff --git a/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/Scenario_FileHandle.cs b/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/Scenario_FileHandle.cs
new file mode 100644
index 00000000..efdb9342
--- /dev/null
+++ b/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/Scenario_FileHandle.cs
@@ -0,0 +1,74 @@
+using Microsoft.UI.Xaml.Controls;
+using Microsoft.Web.WebView2.Core;
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.IO;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Windows.ApplicationModel;
+using Windows.Storage;
+using Windows.UI.Popups;
+
+namespace WebView2_WinUI3_Sample
+{
+    internal class Scenario_FileHandle
+    {
+        private WebView2 _webView;
+
+        public void Execute(WebView2 webView)
+        {
+            _webView = webView;
+            webView.CoreWebView2.Settings.IsWebMessageEnabled = true;
+            webView.CoreWebView2.PermissionRequested += CoreWebView2_PermissionRequested;
+            webView.CoreWebView2.WebMessageReceived += CoreWebView2_WebMessageReceived;
+            webView.CoreWebView2.SetVirtualHostNameToFolderMapping("content.app",
+                Path.Combine(Package.Current.InstalledLocation.Path, "assets"),
+                CoreWebView2HostResourceAccessKind.Allow);
+            webView.Source = new Uri("https://content.app/ScenarioFileHandle.html");
+        }
+
+        private void SendDirAndFileHandleFromNativeToJS()
+        {
+            var dirHandle = _webView.CoreWebView2.Environment.CreateWebFileSystemDirectoryHandle(
+                Path.Combine(Package.Current.InstalledLocation.Path, "assets"),
+                CoreWebView2FileSystemHandlePermission.ReadWrite);
+            var fileHandle = _webView.CoreWebView2.Environment.CreateWebFileSystemFileHandle(
+                Path.Combine(Package.Current.InstalledLocation.Path, "assets", "ScenarioFileHandle.html"),
+                CoreWebView2FileSystemHandlePermission.ReadOnly);
+            _webView.CoreWebView2.PostWebMessageAsJson("{}", new List<object> { dirHandle, fileHandle });
+        }
+
+        private void CoreWebView2_PermissionRequested(CoreWebView2 sender, CoreWebView2PermissionRequestedEventArgs args)
+        {
+            //allow all permission requests for demo purpose
+            args.State = CoreWebView2PermissionState.Allow;
+        }
+
+        private async void CoreWebView2_WebMessageReceived(CoreWebView2 sender, CoreWebView2WebMessageReceivedEventArgs args)
+        {
+            if (args.WebMessageAsJson == "\"requestWorkingDir\"")
+            {
+                SendDirAndFileHandleFromNativeToJS();
+            }
+
+            foreach (var item in args.AdditionalObjects)
+            {
+                if (item == null)
+                {
+                    var messageDialog = new ContentDialog()
+                    {
+                        Title = "Error",
+                        Content = "Received additional object is <null>, Expected: CoreWebView2FileSystemHandle",
+                        CloseButtonText = "Ok"
+                    };
+                    messageDialog.XamlRoot = _webView.XamlRoot;
+                    await messageDialog.ShowAsync();
+                }
+                Debug.Assert(item is CoreWebView2FileSystemHandle);
+                Debug.Assert(item != null);
+            }
+        }
+    }
+}
diff --git a/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample.csproj b/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample.csproj
index a5148732..c2799425 100644
--- a/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample.csproj
+++ b/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample.csproj
@@ -10,10 +10,14 @@
     <UseWinUI>true</UseWinUI>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
   </PropertyGroup>
+  <ItemGroup>
+    <None Remove="assets\ScenarioFileHandle.html" />
+  </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.3.230602002" />
-    <PackageReference Include="Microsoft.Windows.SDK.BuildTools" Version="10.0.22621.755" />
+    <PackageReference Include="Microsoft.Web.WebView2" Version="1.0.3240.44" />
+    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.7.250401001" />
+    <PackageReference Include="Microsoft.Windows.SDK.BuildTools" Version="10.0.26100.3916" />
     <Manifest Include="$(ApplicationManifest)" />
   </ItemGroup>
 </Project>
diff --git a/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/assets/ScenarioFileHandle.html b/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/assets/ScenarioFileHandle.html
new file mode 100644
index 00000000..cf3a5eae
--- /dev/null
+++ b/SampleApps/WebView2_WinUI3_Sample/WebView2_WinUI3_Sample/assets/ScenarioFileHandle.html
@@ -0,0 +1,98 @@
+<!DOCTYPE html>
+
+<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
+<head>
+    <meta charset="utf-8" />
+    <title></title>
+</head>
+<body>
+    <h1>Native to web</h1>
+    <div>PWA requires write access to a working directory in the file system. <br /> e.g. to launch installed desktop applications from the native part (like Word for DOCX files)</div>
+    <button onclick="requestDirFromNative()">Request Directory Access</button>
+    <div id="native2webResult"></div>
+    <h1>Web to native</h1>
+    <div>PWA requires write access to user selected directory in the file system. <br /> e.g. to launch installed desktop applications from the native part (like Word for DOCX files)</div>
+    <h2>Directory handle</h2>
+    <div>Sending the handle of the selected directory</div>
+    <button onclick="sendDirHandle()">Open Directory</button>
+    <h2>File handle</h2>
+    <div>Sending the handle of a just created file</div>
+    <button onclick="sendNewFileHandle()">Open Directory</button>
+    <h2>File handle</h2>
+    <div>Sending the handle of an existing file</div>
+    <button onclick="sendExistingFileHandle()">Open Directory</button>
+    <h2>File handle</h2>
+    <div>Sending the File object to the handle of an existing file</div>
+    <button onclick="sendExistingFile()">Open Directory</button>
+
+    <script>
+        async function requestDirFromNative() {
+            window.chrome.webview.postMessage("requestWorkingDir");
+        }
+
+        async function sendDirHandle() {
+            const dirHandle = await window.showDirectoryPicker();
+            let additionalObjects = [dirHandle];
+            try {
+                window.chrome.webview.postMessageWithAdditionalObjects("sendDirHandle", additionalObjects);
+            } catch (e) {
+                alert("Error: " + e);
+            }
+        }
+        async function sendNewFileHandle() {
+            const dirHandle = await window.showDirectoryPicker();
+            const fileHandle = await dirHandle.getFileHandle("temp.bin", { create: true });
+            const writable = await fileHandle.createWritable();
+            await writable.close();
+            const additionalObjects = [fileHandle];
+            try {
+                window.chrome.webview.postMessageWithAdditionalObjects("sendNewFileHandle", additionalObjects);
+            } catch (e) {
+                alert("Error: " + e);
+            }
+        }
+        async function sendExistingFileHandle() {
+            const dirHandle = await window.showDirectoryPicker();
+            const fileHandle = await dirHandle.getFileHandle("temp.bin", { create: true });
+            const writable = await fileHandle.createWritable();
+            await writable.close();
+            const fileHandle2 = await dirHandle.getFileHandle("temp.bin");
+            const file2 = await fileHandle2.getFile();
+            const additionalObjects = [fileHandle2];
+            try {
+                window.chrome.webview.postMessageWithAdditionalObjects("sendExistingFileHandle", additionalObjects);
+            } catch (e) {
+                alert("Error: " + e);
+            }
+        }
+        async function sendExistingFile() {
+            const dirHandle = await window.showDirectoryPicker();
+            const fileHandle = await dirHandle.getFileHandle("temp.bin", { create: true });
+            const writable = await fileHandle.createWritable();
+            await writable.close();
+            const fileHandle2 = await dirHandle.getFileHandle("temp.bin");
+            const file2 = await fileHandle2.getFile();
+            const additionalObjects = [file2];
+            try {
+                window.chrome.webview.postMessageWithAdditionalObjects("sendExistingFileHandle", additionalObjects);
+            } catch (e) {
+                alert("Error: " + e);
+            }
+        }
+
+        window.chrome.webview.addEventListener('message', async (arg) => {
+            console.log(arg);
+            native2webResult.innerHTML = "Expected: 2, Received: " + arg.additionalObjects.length;
+            const dirHandle = arg.additionalObjects[0];
+            const permission = await dirHandle.requestPermission({ mode: "readwrite" });
+            console.log("permission " + permission);
+            console.log("dirHandle " + dirHandle.name);
+
+            //try to write file
+            const fileHandle = await dirHandle.getFileHandle("temp.bin", { create: true });
+            const writable = await fileHandle.createWritable();
+            await writable.close();
+        });
+    </script>
+</body>
+</html>
\ No newline at end of file