feat: 增加 Logger 支持

Author: ArgoZhang

src/components/BootstrapBlazor.Html2Pdf/Services/DefaultPdfService.cs

@@ -2,37 +2,61 @@
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 // Website: https://www.blazor.zone or https://argozhang.github.io/
 
+using Microsoft.Extensions.Logging;
 using PuppeteerSharp;
+using System.Net;
 
 namespace BootstrapBlazor.Components;
 
 /// <summary>
 /// 默认 Html to Pdf 实现 
 /// </summary>
-class DefaultPdfService : IHtml2Pdf
+class DefaultPdfService(ILogger<DefaultPdfService> logger) : IHtml2Pdf
 {
+    /// <summary>
+    /// 获得/设置 WebProxy 对象用于网络请求代理
+    /// <para>Get or set the WebProxy object for network request proxy</para>
+    /// </summary>
+    public IWebProxy? WebProxy { get; set; }
+
     /// <summary>
     /// <inheritdoc/>
     /// </summary>
     public async Task<byte[]> PdfDataAsync(string url)
     {
-        await using var browser = await LaunchBrowserAsync();
-        await using var page = await browser.NewPageAsync();
-        await page.GoToAsync(url);
+        try
+        {
+            await using var browser = await LaunchBrowserAsync();
+            await using var page = await browser.NewPageAsync();
 
-        return await page.PdfDataAsync();
+            await page.GoToAsync(url);
+            return await page.PdfDataAsync();
+        }
+        catch (Exception ex)
+        {
+            Log(ex, "Error generating PDF from URL: {Url}", url);
+            throw;
+        }
     }
 
     /// <summary>
     /// <inheritdoc/>
     /// </summary>
     public async Task<Stream> PdfStreamAsync(string url)
     {
-        await using var browser = await LaunchBrowserAsync();
-        await using var page = await browser.NewPageAsync();
-        await page.GoToAsync(url);
+        try
+        {
+            await using var browser = await LaunchBrowserAsync();
+            await using var page = await browser.NewPageAsync();
+            await page.GoToAsync(url);
 
-        return await page.PdfStreamAsync();
+            return await page.PdfStreamAsync();
+        }
+        catch (Exception ex)
+        {
+            Log(ex, "Error generating PDF from URL: {Url}", url);
+            throw;
+        }
     }
 
     /// <summary>
@@ -43,14 +67,22 @@ public async Task<Stream> PdfStreamAsync(string url)
     /// <param name="scripts"></param>
     public async Task<byte[]> PdfDataFromHtmlAsync(string html, IEnumerable<string>? links = null, IEnumerable<string>? scripts = null)
     {
-        await using var browser = await LaunchBrowserAsync();
-        await using var page = await browser.NewPageAsync();
-        await page.SetContentAsync(html);
+        try
+        {
+            await using var browser = await LaunchBrowserAsync();
+            await using var page = await browser.NewPageAsync();
+            await page.SetContentAsync(html);
 
-        await AddStyleTagAsync(page, links);
-        await AddScriptTagAsync(page, scripts);
+            await AddStyleTagAsync(page, links);
+            await AddScriptTagAsync(page, scripts);
 
-        return await page.PdfDataAsync();
+            return await page.PdfDataAsync();
+        }
+        catch (Exception ex)
+        {
+            Log(ex, "Error generating PDF from HTML content");
+            throw;
+        }
     }
 
     /// <summary>
@@ -61,14 +93,22 @@ public async Task<byte[]> PdfDataFromHtmlAsync(string html, IEnumerable<string>?
     /// <param name="scripts"></param>
     public async Task<Stream> PdfStreamFromHtmlAsync(string html, IEnumerable<string>? links = null, IEnumerable<string>? scripts = null)
     {
-        await using var browser = await LaunchBrowserAsync();
-        await using var page = await browser.NewPageAsync();
-        await page.SetContentAsync(html);
+        try
+        {
+            await using var browser = await LaunchBrowserAsync();
+            await using var page = await browser.NewPageAsync();
+            await page.SetContentAsync(html);
 
-        await AddStyleTagAsync(page, links);
-        await AddScriptTagAsync(page, scripts);
+            await AddStyleTagAsync(page, links);
+            await AddScriptTagAsync(page, scripts);
 
-        return await page.PdfStreamAsync();
+            return await page.PdfStreamAsync();
+        }
+        catch (Exception ex)
+        {
+            Log(ex, "Error generating PDF from HTML content");
+            throw;
+        }
     }
 
     private static async Task AddStyleTagAsync(IPage page, IEnumerable<string>? links = null)
@@ -103,11 +143,31 @@ private static async Task AddScriptTagAsync(IPage page, IEnumerable<string>? scr
 
     private static LaunchOptions CreateOptions() => new() { Headless = true, Args = ["--no-sandbox", "--disable-setuid-sandbox", "--disable-web-security"] };
 
-    private static async Task<IBrowser> LaunchBrowserAsync()
+    private async Task<IBrowser> LaunchBrowserAsync()
     {
-        var browserFetcher = new BrowserFetcher();
-        await browserFetcher.DownloadAsync();
+        var browserFetcher = new BrowserFetcher
+        {
+            WebProxy = WebProxy
+        };
+
+        Log(null, "Ready to start downloading browser");
+        var browser = await browserFetcher.DownloadAsync();
+        Log(null, $"Browser downloaded successfully. installed browser {browser.BuildId}");
 
-        return await Puppeteer.LaunchAsync(CreateOptions());
+        var options = CreateOptions();
+        Log(null, "Start your browser", "--no-sandbox", "--disable-setuid-sandbox", "--disable-web-security");
+        return await Puppeteer.LaunchAsync(options);
+    }
+
+    private void Log(Exception? exception, string? message, params object?[] args)
+    {
+        if (args.Length != 0)
+        {
+            logger.LogInformation(exception, "{Message} | Args: {Args}", message, args);
+        }
+        else
+        {
+            logger.LogInformation(exception, "{Message}", message);
+        }
     }
 }