Added implicit converters for BlobPart and fixed saturating creator for FileReader to register event handlers.

Author: KristofferStrube

README.md

@@ -44,8 +44,8 @@ An example could be to create an instance of a `Blob` that contains the text `"H
 Blob blob = await Blob.CreateAsync(
     JSRuntime,
     blobParts: new BlobPart[] {
-        new("Hello "),
-        new(new byte[] { 0X57, 0X6f, 0X72, 0X6c, 0X64, 0X21 })
+        "Hello ",
+        new byte[] { 0X57, 0X6f, 0X72, 0X6c, 0X64, 0X21 }
     },
     options: new() { Type = "text/plain" }
 );
@@ -60,8 +60,8 @@ All creator methods take an `IJSRuntime` instance as the first parameter. The ab
 BlobInProcess blob = await BlobInProcess.CreateAsync(
     JSRuntime,
     blobParts: new BlobPart[] {
-        new("Hello "),
-        new(new byte[] { 0X57, 0X6f, 0X72, 0X6c, 0X64, 0X21 })
+        "Hello ",
+        new byte[] { 0X57, 0X6f, 0X72, 0X6c, 0X64, 0X21 }
     },
     options: new() { Type = "text/plain" }
 );

samples/KristofferStrube.Blazor.FileAPI.WasmExample/Pages/FileReaderSample.razor

@@ -25,14 +25,14 @@ We then use the methods of the <code>FileReader</code> interface to read the <co
 @code {
     string log = "";
     private string imageUrl = "";
-    private Blob blob;
+    private Blob? blob;
 
     protected override async Task OnInitializedAsync()
     {
         var imageBytes = await HttpClient.GetByteArrayAsync($"images/mountain.jpg");
         blob = await Blob.CreateAsync(
             JSRuntime,
-            blobParts: new BlobPart[] { new(imageBytes) },
+            blobParts: new BlobPart[] { imageBytes },
             options: new() { Type = "image/png" }
         );
     }
@@ -66,7 +66,7 @@ We then use the methods of the <code>FileReader</code> interface to read the <co
             imageUrl = "data:image/png;base64," + Convert.ToBase64String(await fileReader.GetResultAsByteArrayAsync() ?? new byte[0]);
             await GetProgressAsync(e, "OnLoadEnd");
         };
-        await fileReader.ReadAsArrayBufferAsync(blob);
+        await fileReader.ReadAsArrayBufferAsync(blob!);
     }
 
     public async Task ReadAsArrayBufferInProcessAsync()
@@ -83,7 +83,7 @@ We then use the methods of the <code>FileReader</code> interface to read the <co
             imageUrl = "data:image/png;base64," + Convert.ToBase64String(fileReader.ResultAsByteArray ?? new byte[0]);
             GetProgress(e, "OnLoadEnd");
         };
-        fileReader.ReadAsArrayBuffer(blob);
+        fileReader.ReadAsArrayBuffer(blob!);
     }
 
     public async Task ReadAsBinaryStringAsync()
@@ -101,7 +101,7 @@ We then use the methods of the <code>FileReader</code> interface to read the <co
             imageUrl = "data:image/png;base64," + Convert.ToBase64String(bytes);
             await GetProgressAsync(e, "OnLoadEnd");
         };
-        await fileReader.ReadAsBinaryStringAsync(blob);
+        await fileReader.ReadAsBinaryStringAsync(blob!);
     }
 
     public void ReadAsText()
@@ -125,6 +125,6 @@ We then use the methods of the <code>FileReader</code> interface to read the <co
             imageUrl = await fileReader.GetResultAsStringAsync() ?? "";
             await GetProgressAsync(e, "OnLoadEnd");
         };
-        await fileReader.ReadAsDataURLAsync(blob);
+        await fileReader.ReadAsDataURLAsync(blob!);
     }
 }

samples/KristofferStrube.Blazor.FileAPI.WasmExample/Pages/Index.razor

@@ -31,7 +31,7 @@ content type: @file?.Type
         var imageBytes = await HttpClient.GetByteArrayAsync($"images/{imageName}");
         file = await FileInProcess.CreateAsync(
             JSRuntime,
-            fileBits: new BlobPart[] { new(imageBytes) },
+            fileBits: new BlobPart[] { imageBytes },
             fileName: imageName,
             options: new() { Type = "image/png", LastModified = DateTime.Now }
         );

samples/KristofferStrube.Blazor.FileAPI.WasmExample/Pages/Slice.razor

@@ -30,7 +30,7 @@ Here we can see how we can slice a <code>Blob</code>. We construct a <code>Blob<
     {
         var blob = await BlobInProcess.CreateAsync(
             JSRuntime,
-            blobParts: new BlobPart[] { new(Enumerable.Range(0, 50).Select(i => (byte)i).ToArray()) },
+            blobParts: new BlobPart[] { Enumerable.Range(0, 50).Select(i => (byte)i).ToArray() },
             options: new() { Type = "text/plain" }
         );
 

src/KristofferStrube.Blazor.FileAPI/Blob.InProcess.cs

@@ -33,11 +33,11 @@ public static async Task<BlobInProcess> CreateAsync(IJSRuntime jSRuntime, IJSInP
     public static new async Task<BlobInProcess> CreateAsync(IJSRuntime jSRuntime, IList<BlobPart>? blobParts = null, BlobPropertyBag? options = null)
     {
         IJSInProcessObjectReference inProcessHelper = await jSRuntime.GetInProcessHelperAsync();
-        object?[]? jsBlobParts = blobParts?.Select<BlobPart, object?>(blobPart => blobPart.type switch
+        object?[]? jsBlobParts = blobParts?.Select<BlobPart, object?>(blobPart => blobPart.Part switch
             {
-                BlobPartType.BufferSource => blobPart.byteArrayPart,
-                BlobPartType.Blob => blobPart.blobPart?.JSReference,
-                _ => blobPart.stringPart
+                byte[] part => part,
+                Blob part => part.JSReference,
+                _ => blobPart.Part
             })
             .ToArray();
         IJSInProcessObjectReference jSInstance = await inProcessHelper.InvokeAsync<IJSInProcessObjectReference>("constructBlob", jsBlobParts, options);

src/KristofferStrube.Blazor.FileAPI/Blob.cs

@@ -29,11 +29,11 @@ public static Blob Create(IJSRuntime jSRuntime, IJSObjectReference jSReference)
     public static async Task<Blob> CreateAsync(IJSRuntime jSRuntime, IList<BlobPart>? blobParts = null, BlobPropertyBag? options = null)
     {
         IJSObjectReference helper = await jSRuntime.GetHelperAsync();
-        object?[]? jsBlobParts = blobParts?.Select<BlobPart, object?>(blobPart => blobPart.type switch
+        object?[]? jsBlobParts = blobParts?.Select<BlobPart, object?>(blobPart => blobPart.Part switch
             {
-                BlobPartType.BufferSource => blobPart.byteArrayPart,
-                BlobPartType.Blob => blobPart.blobPart?.JSReference,
-                _ => blobPart.stringPart
+                byte[] part => part,
+                Blob part => part.JSReference,
+                _ => blobPart.Part
             })
             .ToArray();
         IJSObjectReference jSInstance = await helper.InvokeAsync<IJSObjectReference>("constructBlob", jsBlobParts, options);

src/KristofferStrube.Blazor.FileAPI/File.InProcess.cs

@@ -34,11 +34,11 @@ public static async Task<FileInProcess> CreateAsync(IJSRuntime jSRuntime, IJSInP
     public static new async Task<FileInProcess> CreateAsync(IJSRuntime jSRuntime, IList<BlobPart> fileBits, string fileName, FilePropertyBag? options = null)
     {
         IJSInProcessObjectReference inProcessHelper = await jSRuntime.GetInProcessHelperAsync();
-        object?[]? jsFileBits = fileBits.Select<BlobPart, object?>(blobPart => blobPart.type switch
+        object?[]? jsFileBits = fileBits.Select<BlobPart, object?>(blobPart => blobPart.Part switch
             {
-                BlobPartType.BufferSource => blobPart.byteArrayPart,
-                BlobPartType.Blob => blobPart.stringPart,
-                _ => blobPart.blobPart?.JSReference
+                byte[] part => part,
+                Blob part => part.JSReference,
+                _ => blobPart.Part
             })
             .ToArray();
         IJSInProcessObjectReference jSInstance = await inProcessHelper.InvokeAsync<IJSInProcessObjectReference>("constructFile", jsFileBits, fileName, options);

src/KristofferStrube.Blazor.FileAPI/File.cs

@@ -29,11 +29,11 @@ public class File : Blob
     public static async Task<File> CreateAsync(IJSRuntime jSRuntime, IList<BlobPart> fileBits, string fileName, FilePropertyBag? options = null)
     {
         IJSObjectReference helper = await jSRuntime.GetHelperAsync();
-        object?[]? jsFileBits = fileBits.Select<BlobPart, object?>(blobPart => blobPart.type switch
+        object?[]? jsFileBits = fileBits.Select<BlobPart, object?>(blobPart => blobPart.Part switch
             {
-                BlobPartType.BufferSource => blobPart.byteArrayPart,
-                BlobPartType.Blob => blobPart.stringPart,
-                _ => blobPart.blobPart?.JSReference
+                byte[] part => part,
+                Blob part => part.JSReference,
+                _ => blobPart.Part
             })
             .ToArray();
         IJSObjectReference jSInstance = await helper.InvokeAsync<IJSObjectReference>("constructFile", jsFileBits, fileName, options);

src/KristofferStrube.Blazor.FileAPI/FileReader.cs

@@ -14,9 +14,12 @@ public class FileReader : BaseJSWrapper
     /// <param name="jSRuntime">An <see cref="IJSRuntime"/> instance.</param>
     /// <param name="jSReference">A JS reference to an existing <see cref="FileReader"/>.</param>
     /// <returns>A wrapper instance for a <see cref="FileReader"/>.</returns>
-    public static FileReader Create(IJSRuntime jSRuntime, IJSObjectReference jSReference)
+    public static async Task<FileReader> CreateAsync(IJSRuntime jSRuntime, IJSObjectReference jSReference)
     {
-        return new FileReader(jSRuntime, jSReference);
+        IJSObjectReference helper = await jSRuntime.GetHelperAsync();
+        FileReader fileReader = new(jSRuntime, jSReference);
+        await helper.InvokeVoidAsync("registerEventHandlersAsync", DotNetObjectReference.Create(fileReader), jSReference);
+        return fileReader;
     }
 
     /// <summary>
@@ -28,7 +31,7 @@ public static async Task<FileReader> CreateAsync(IJSRuntime jSRuntime)
     {
         IJSObjectReference helper = await jSRuntime.GetHelperAsync();
         IJSObjectReference jSInstance = await helper.InvokeAsync<IJSObjectReference>("constructFileReader");
-        FileReader fileReader = new FileReader(jSRuntime, jSInstance);
+        FileReader fileReader = new(jSRuntime, jSInstance);
         await helper.InvokeVoidAsync("registerEventHandlersAsync", DotNetObjectReference.Create(fileReader), jSInstance);
         return fileReader;
     }

src/KristofferStrube.Blazor.FileAPI/Options/BlobPart.cs

@@ -1,37 +1,45 @@
-namespace KristofferStrube.Blazor.FileAPI;
+using System.Runtime.Serialization;
+
+namespace KristofferStrube.Blazor.FileAPI;
 
 /// <summary>
 /// <see href="https://www.w3.org/TR/FileAPI/#typedefdef-blobpart">BlobPart browser specs</see>
 /// </summary>
 public class BlobPart
 {
-    internal readonly byte[]? byteArrayPart;
-    internal readonly Blob? blobPart;
-    internal readonly string? stringPart;
-    internal readonly BlobPartType type;
+    internal readonly object Part;
 
+    internal BlobPart(object part)
+    {
+        Part = part;
+    }
+    [Obsolete("We added implicit converters from byte[] to BlobPart so you can parse it directly without using this constructor first.")]
     public BlobPart(byte[] part)
     {
-        byteArrayPart = part;
-        type = BlobPartType.BufferSource;
+        Part = part;
     }
-
+    [Obsolete("We added implicit converters from Blob to BlobPart so you can parse it directly without using this constructor first.")]
     public BlobPart(Blob part)
     {
-        blobPart = part;
-        type = BlobPartType.Blob;
+        Part = part;
     }
-
+    [Obsolete("We added implicit converters from string to BlobPart so you can parse it directly without using this constructor first.")]
     public BlobPart(string part)
     {
-        stringPart = part;
-        type = BlobPartType.String;
+        Part = part;
     }
-}
 
-internal enum BlobPartType
-{
-    BufferSource,
-    Blob,
-    String
+
+    public static implicit operator BlobPart(byte[] part)
+    {
+        return new((object)part);
+    }
+    public static implicit operator BlobPart(Blob part)
+    {
+        return new((object)part);
+    }
+    public static implicit operator BlobPart(string part)
+    {
+        return new((object)part);
+    }
 }