【亲测免费】 Puppeteer Sharp 技术文档

2026-01-25 04:51:35作者：劳婵绚Shirley

**Puppeteer Sharp**是针对.NET开发者量身打造的浏览器自动化神器，它完美移植了Node.js版Puppeteer的强大功能。通过这款工具，你能够轻松操控Chromium或Chrome浏览器，实现网页截图、生成PDF、注入HTML、执行JavaScript代码等丰富操作。无论是进行网页测试、内容抓取还是自动化报告生成，Puppeteer Sharp都是你的得力助手。支持.NET Standard 2.0及以上的框架，兼容多种平台，让.NET开发者也能畅享无界web自动化魅力。立即加入，解锁前端测试与自动化的新境界！

项目地址：https://gitcode.com/gh_mirrors/pup/puppeteer-sharp

安装指南

系统要求

.NET Framework 4.6.1 或更高版本
.NET Core 2.0 或更高版本
在Linux系统上运行Chrome时，可能需要X-server支持。

安装步骤

通过NuGet安装：打开命令行工具，运行以下命令安装Puppeteer Sharp：
```
dotnet add package PuppeteerSharp
```
手动下载：访问NuGet官网下载并安装Puppeteer Sharp包。

项目使用说明

启动浏览器

var browserFetcher = new BrowserFetcher();
await browserFetcher.DownloadAsync();
await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions { Headless = true });

创建新页面

await using var page = await browser.NewPageAsync();

导航到指定URL

await page.GoToAsync("http://www.google.com");

截图

await page.ScreenshotAsync(outputFile);

生成PDF

await page.PdfAsync(outputFile);

注入HTML

await page.SetContentAsync("<div>My Receipt</div>");
var result = await page.GetContentAsync();

执行JavaScript

var seven = await page.EvaluateExpressionAsync<int>("4 + 3");
var someObject = await page.EvaluateFunctionAsync<dynamic>("(value) => ({a: value})", 5);
Console.WriteLine(someObject.a);

等待选择器

await page.WaitForSelectorAsync("div.main-content");

等待函数

var watchDog = page.WaitForFunctionAsync("()=> window.innerWidth < 100");
await page.SetViewportAsync(new ViewPortOptions { Width = 50, Height = 50 });
await watchDog;

连接到远程浏览器

var options = new ConnectOptions()
{
    BrowserWSEndpoint = $"wss://www.externalbrowser.io?token={apikey}"
};
using (var browser = await PuppeteerSharp.Puppeteer.ConnectAsync(options))
{
    using (var page = await browser.NewPageAsync())
    {
        await page.GoToAsync(url);
        await page.PdfAsync("wot.pdf");
    }
}