Updated CHANGELOG, Added Create method to FileSystemWritableFileStream and applied Code Cleanup.

Author: KristofferStrube

CHANGELOG.md

@@ -5,6 +5,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+### Added
+- Added `FileSystemAccessOptions` class that can customize the helper script path. By [@datvm](https://github.com/datvm).
+- Added overloads for `FileSystemAccessService` and `FileSystemAccessServiceInProcess` methods that takes a `FileSystemAccessOptions`. By [@datvm](https://github.com/datvm).
+- Added overloads for creator methods on `FileSystemHandle`, `FileSystemFileHandle`, and `FileSystemDirectoryHandle`  that takes a `FileSystemAccessOptions`. By [@datvm](https://github.com/datvm).
+- Added `Create` method to `FileSystemWritableFileStream`.
 
 ## [2.0.0] - 2022-11-10
 ### Added

src/KristofferStrube.Blazor.FileSystemAccess/BaseFileSystemAccessService.cs

@@ -24,53 +24,68 @@ public BaseFileSystemAccessService(IJSRuntime jSRuntime)
     /// <param name="openFilePickerOptions"></param>
     /// <returns></returns>
     public async Task<TFsFileHandle[]> ShowOpenFilePickerAsync(OpenFilePickerOptionsStartInWellKnownDirectory? openFilePickerOptions)
-        => await this.InternalShowOpenFilePickerAsync(openFilePickerOptions?.Serializable());
+    {
+        return await this.InternalShowOpenFilePickerAsync(openFilePickerOptions?.Serializable());
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#api-showopenfilepicker">showOpenFilePicker() browser specs</see>
     /// </summary>
     /// <param name="openFilePickerOptions"></param>
     /// <returns></returns>
     public async Task<TFsFileHandle[]> ShowOpenFilePickerAsync(OpenFilePickerOptionsStartInWellKnownDirectory? openFilePickerOptions, FileSystemAccessOptions fsaOptions)
-        => await InternalShowOpenFilePickerAsync(openFilePickerOptions?.Serializable(), fsaOptions);
+    {
+        return await InternalShowOpenFilePickerAsync(openFilePickerOptions?.Serializable(), fsaOptions);
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#api-showopenfilepicker">showOpenFilePicker() browser specs</see>
     /// </summary>
     /// <param name="openFilePickerOptions"></param>
     /// <returns></returns>
     public async Task<TFsFileHandle[]> ShowOpenFilePickerAsync(OpenFilePickerOptionsStartInFileSystemHandle? openFilePickerOptions)
-        => await this.InternalShowOpenFilePickerAsync(openFilePickerOptions?.Serializable());
+    {
+        return await this.InternalShowOpenFilePickerAsync(openFilePickerOptions?.Serializable());
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#api-showopenfilepicker">showOpenFilePicker() browser specs</see>
     /// </summary>
     /// <param name="openFilePickerOptions"></param>
     /// <returns></returns>
     public async Task<TFsFileHandle[]> ShowOpenFilePickerAsync(OpenFilePickerOptionsStartInFileSystemHandle? openFilePickerOptions, FileSystemAccessOptions fsaOptions)
-        => await this.InternalShowOpenFilePickerAsync(openFilePickerOptions?.Serializable(), fsaOptions);
+    {
+        return await this.InternalShowOpenFilePickerAsync(openFilePickerOptions?.Serializable(), fsaOptions);
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#api-showopenfilepicker">showOpenFilePicker() browser specs</see>
     /// </summary>
     /// <returns></returns>
     public async Task<TFsFileHandle[]> ShowOpenFilePickerAsync()
-        => await InternalShowOpenFilePickerAsync(null);
+    {
+        return await InternalShowOpenFilePickerAsync(null);
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#api-showopenfilepicker">showOpenFilePicker() browser specs</see>
     /// </summary>
     /// <returns></returns>
     public async Task<TFsFileHandle[]> ShowOpenFilePickerAsync(FileSystemAccessOptions fsaOptions)
-        => await InternalShowOpenFilePickerAsync(null, fsaOptions);
+    {
+        return await InternalShowOpenFilePickerAsync(null, fsaOptions);
+    }
 
     protected async Task<TFsFileHandle[]> InternalShowOpenFilePickerAsync(object? options)
-        => await InternalShowOpenFilePickerAsync(options, FileSystemAccessOptions.DefaultInstance);
+    {
+        return await InternalShowOpenFilePickerAsync(options, FileSystemAccessOptions.DefaultInstance);
+    }
+
     protected async Task<TFsFileHandle[]> InternalShowOpenFilePickerAsync(object? options, FileSystemAccessOptions fsaOptions)
     {
-        var helper = await helperTask.Value;
-        var jSFileHandles = await jSRuntime.InvokeAsync<TObjReference>("window.showOpenFilePicker", options);
-        var length = await helper.InvokeAsync<int>("size", jSFileHandles);
+        IJSObjectReference helper = await helperTask.Value;
+        TObjReference jSFileHandles = await jSRuntime.InvokeAsync<TObjReference>("window.showOpenFilePicker", options);
+        int length = await helper.InvokeAsync<int>("size", jSFileHandles);
 
         return await Task.WhenAll(
             Enumerable
@@ -95,52 +110,66 @@ await jSFileHandles.InvokeAsync<TObjReference>("at", i),
     /// <param name="saveFilePickerOptions"></param>
     /// <returns></returns>
     public async Task<TFsFileHandle> ShowSaveFilePickerAsync(SaveFilePickerOptionsStartInWellKnownDirectory? saveFilePickerOptions)
-        => await InternalShowSaveFilePickerAsync(saveFilePickerOptions?.Serializable());
+    {
+        return await InternalShowSaveFilePickerAsync(saveFilePickerOptions?.Serializable());
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#api-showsavefilepicker">showSaveFilePicker() browser specs</see>
     /// </summary>
     /// <param name="saveFilePickerOptions"></param>
     /// <returns></returns>
     public async Task<TFsFileHandle> ShowSaveFilePickerAsync(SaveFilePickerOptionsStartInWellKnownDirectory? saveFilePickerOptions, FileSystemAccessOptions fsaOptions)
-        => await InternalShowSaveFilePickerAsync(saveFilePickerOptions?.Serializable(), fsaOptions);
+    {
+        return await InternalShowSaveFilePickerAsync(saveFilePickerOptions?.Serializable(), fsaOptions);
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#api-showsavefilepicker">showSaveFilePicker() browser specs</see>
     /// </summary>
     /// <param name="saveFilePickerOptions"></param>
     /// <returns></returns>
     public async Task<TFsFileHandle> ShowSaveFilePickerAsync(SaveFilePickerOptionsStartInFileSystemHandle? saveFilePickerOptions)
-        => await InternalShowSaveFilePickerAsync(saveFilePickerOptions?.Serializable());
+    {
+        return await InternalShowSaveFilePickerAsync(saveFilePickerOptions?.Serializable());
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#api-showsavefilepicker">showSaveFilePicker() browser specs</see>
     /// </summary>
     /// <param name="saveFilePickerOptions"></param>
     /// <returns></returns>
     public async Task<TFsFileHandle> ShowSaveFilePickerAsync(SaveFilePickerOptionsStartInFileSystemHandle? saveFilePickerOptions, FileSystemAccessOptions fsaOptions)
-        => await InternalShowSaveFilePickerAsync(saveFilePickerOptions?.Serializable(), fsaOptions);
+    {
+        return await InternalShowSaveFilePickerAsync(saveFilePickerOptions?.Serializable(), fsaOptions);
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#api-showsavefilepicker">showSaveFilePicker() browser specs</see>
     /// </summary>
     /// <returns></returns>
     public async Task<TFsFileHandle> ShowSaveFilePickerAsync()
-        => await InternalShowSaveFilePickerAsync(null);
+    {
+        return await InternalShowSaveFilePickerAsync(null);
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#api-showsavefilepicker">showSaveFilePicker() browser specs</see>
     /// </summary>
     /// <returns></returns>
     public async Task<TFsFileHandle> ShowSaveFilePickerAsync(FileSystemAccessOptions options)
-        => await InternalShowSaveFilePickerAsync(null, options);
+    {
+        return await InternalShowSaveFilePickerAsync(null, options);
+    }
 
     protected async Task<TFsFileHandle> InternalShowSaveFilePickerAsync(object? options)
-        => await this.InternalShowSaveFilePickerAsync(options, FileSystemAccessOptions.DefaultInstance);
+    {
+        return await this.InternalShowSaveFilePickerAsync(options, FileSystemAccessOptions.DefaultInstance);
+    }
 
     protected async Task<TFsFileHandle> InternalShowSaveFilePickerAsync(object? options, FileSystemAccessOptions fsaOptions)
     {
-        var jSFileHandle = await jSRuntime.InvokeAsync<TObjReference>("window.showSaveFilePicker", options);
+        TObjReference jSFileHandle = await jSRuntime.InvokeAsync<TObjReference>("window.showSaveFilePicker", options);
         return await this.CreateFileHandleAsync(jSRuntime, jSFileHandle, fsaOptions);
     }
 
@@ -154,54 +183,68 @@ protected async Task<TFsFileHandle> InternalShowSaveFilePickerAsync(object? opti
     /// <param name="directoryPickerOptions"></param>
     /// <returns></returns>
     public async Task<TFsDirectoryHandle> ShowDirectoryPickerAsync(DirectoryPickerOptionsStartInWellKnownDirectory? directoryPickerOptions)
-        => await InternalShowDirectoryPickerAsync(directoryPickerOptions?.Serializable());
+    {
+        return await InternalShowDirectoryPickerAsync(directoryPickerOptions?.Serializable());
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#api-showdirectorypicker">showDirectoryPicker() browser specs</see>
     /// </summary>
     /// <param name="directoryPickerOptions"></param>
     /// <returns></returns>
     public async Task<TFsDirectoryHandle> ShowDirectoryPickerAsync(DirectoryPickerOptionsStartInWellKnownDirectory? directoryPickerOptions, FileSystemAccessOptions fasOptions)
-        => await InternalShowDirectoryPickerAsync(directoryPickerOptions?.Serializable(), fasOptions);
+    {
+        return await InternalShowDirectoryPickerAsync(directoryPickerOptions?.Serializable(), fasOptions);
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#api-showdirectorypicker">showDirectoryPicker() browser specs</see>
     /// </summary>
     /// <param name="directoryPickerOptions"></param>
     /// <returns></returns>
     public async Task<TFsDirectoryHandle> ShowDirectoryPickerAsync(DirectoryPickerOptionsStartInFileSystemHandle? directoryPickerOptions)
-        => await InternalShowDirectoryPickerAsync(directoryPickerOptions?.Serializable());
+    {
+        return await InternalShowDirectoryPickerAsync(directoryPickerOptions?.Serializable());
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#api-showdirectorypicker">showDirectoryPicker() browser specs</see>
     /// </summary>
     /// <param name="directoryPickerOptions"></param>
     /// <returns></returns>
     public async Task<TFsDirectoryHandle> ShowDirectoryPickerAsync(DirectoryPickerOptionsStartInFileSystemHandle? directoryPickerOptions, FileSystemAccessOptions fasOptions)
-        => await InternalShowDirectoryPickerAsync(directoryPickerOptions?.Serializable(), fasOptions);
+    {
+        return await InternalShowDirectoryPickerAsync(directoryPickerOptions?.Serializable(), fasOptions);
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#api-showdirectorypicker">showDirectoryPicker() browser specs</see>
     /// </summary>
     /// <param name="directoryPickerOptions"></param>
     /// <returns></returns>
     public async Task<TFsDirectoryHandle> ShowDirectoryPickerAsync()
-        => await InternalShowDirectoryPickerAsync(null);
+    {
+        return await InternalShowDirectoryPickerAsync(null);
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#api-showdirectorypicker">showDirectoryPicker() browser specs</see>
     /// </summary>
     /// <param name="directoryPickerOptions"></param>
     /// <returns></returns>
     public async Task<TFsDirectoryHandle> ShowDirectoryPickerAsync(FileSystemAccessOptions fasOptions)
-        => await InternalShowDirectoryPickerAsync(null, fasOptions);
+    {
+        return await InternalShowDirectoryPickerAsync(null, fasOptions);
+    }
 
     protected async Task<TFsDirectoryHandle> InternalShowDirectoryPickerAsync(object? options)
-        => await InternalShowDirectoryPickerAsync(options, FileSystemAccessOptions.DefaultInstance);
+    {
+        return await InternalShowDirectoryPickerAsync(options, FileSystemAccessOptions.DefaultInstance);
+    }
 
     protected async Task<TFsDirectoryHandle> InternalShowDirectoryPickerAsync(object? options, FileSystemAccessOptions fasOptions)
     {
-        var jSFileHandle = await jSRuntime.InvokeAsync<TObjReference>("window.showDirectoryPicker", options);
+        TObjReference jSFileHandle = await jSRuntime.InvokeAsync<TObjReference>("window.showDirectoryPicker", options);
         return await this.CreateDirectoryHandleAsync(jSRuntime, jSFileHandle, fasOptions);
     }
 
@@ -214,15 +257,17 @@ protected async Task<TFsDirectoryHandle> InternalShowDirectoryPickerAsync(object
     /// </summary>
     /// <returns></returns>
     public async Task<TFsDirectoryHandle> GetOriginPrivateDirectoryAsync()
-        => await this.GetOriginPrivateDirectoryAsync(FileSystemAccessOptions.DefaultInstance);
+    {
+        return await this.GetOriginPrivateDirectoryAsync(FileSystemAccessOptions.DefaultInstance);
+    }
 
     /// <summary>
     /// <see href="https://wicg.github.io/file-system-access/#dom-storagemanager-getdirectory">getDirectory() for StorageManager browser specs</see>
     /// </summary>
     /// <returns></returns>
     public async Task<TFsDirectoryHandle> GetOriginPrivateDirectoryAsync(FileSystemAccessOptions fasOptions)
     {
-        var jSFileHandle = await jSRuntime.InvokeAsync<TObjReference>("navigator.storage.getDirectory");
+        TObjReference jSFileHandle = await jSRuntime.InvokeAsync<TObjReference>("navigator.storage.getDirectory");
         return await CreateDirectoryHandleAsync(jSRuntime, jSFileHandle, fasOptions);
     }
 

src/KristofferStrube.Blazor.FileSystemAccess/Extensions/IJSRuntimeExtensions.cs

@@ -5,13 +5,22 @@ namespace KristofferStrube.Blazor.FileSystemAccess.Extensions;
 internal static class IJSRuntimeExtensions
 {
     internal static async Task<IJSObjectReference> GetHelperAsync(this IJSRuntime jSRuntime, FileSystemAccessOptions options)
-        => await GetHelperAsync<IJSObjectReference>(jSRuntime, options);
+    {
+        return await GetHelperAsync<IJSObjectReference>(jSRuntime, options);
+    }
 
-    internal static async Task<IJSInProcessObjectReference> GetInProcessHelperAsync(this IJSRuntime jSRuntime, FileSystemAccessOptions options) =>
-        await GetHelperAsync<IJSInProcessObjectReference>(jSRuntime, options);
+    internal static async Task<IJSInProcessObjectReference> GetInProcessHelperAsync(this IJSRuntime jSRuntime, FileSystemAccessOptions options)
+    {
+        return await GetHelperAsync<IJSInProcessObjectReference>(jSRuntime, options);
+    }
 
-    static async Task<T> GetHelperAsync<T>(IJSRuntime jSRuntime, FileSystemAccessOptions options) =>
-        await jSRuntime.InvokeAsync<T>("import", GetScriptPath(options));
+    private static async Task<T> GetHelperAsync<T>(IJSRuntime jSRuntime, FileSystemAccessOptions options)
+    {
+        return await jSRuntime.InvokeAsync<T>("import", GetScriptPath(options));
+    }
 
-    static string GetScriptPath(FileSystemAccessOptions options) => options.FullScriptPath;
+    private static string GetScriptPath(FileSystemAccessOptions options)
+    {
+        return options.FullScriptPath;
+    }
 }

src/KristofferStrube.Blazor.FileSystemAccess/Extensions/IServiceCollectionExtensions.cs

@@ -1,6 +1,4 @@
 using Microsoft.Extensions.DependencyInjection;
-using Microsoft.JSInterop;
-using System.Diagnostics;
 
 namespace KristofferStrube.Blazor.FileSystemAccess;
 
@@ -31,12 +29,12 @@ public static IServiceCollection AddFileSystemAccessServiceInProcess(this IServi
             .AddScoped<IFileSystemAccessServiceInProcess, FileSystemAccessServiceInProcess>()
             .AddScoped(sp =>
             {
-                var service = sp.GetRequiredService<IFileSystemAccessServiceInProcess>();
+                IFileSystemAccessServiceInProcess service = sp.GetRequiredService<IFileSystemAccessServiceInProcess>();
                 return (IFileSystemAccessService)service;
             });
     }
 
-    static void ConfigureFsaOptions(IServiceCollection services, Action<FileSystemAccessOptions>? configure)
+    private static void ConfigureFsaOptions(IServiceCollection services, Action<FileSystemAccessOptions>? configure)
     {
         if (configure is null) { return; }