Puppeteer Sharp 技术文档

Puppeteer Sharp 技术文档

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

安装指南

系统要求

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

安装步骤

1. 通过NuGet安装： 打开命令行工具，运行以下命令安装Puppeteer Sharp：

   dotnet add package PuppeteerSharp
   

2. 手动下载： 访问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");
    }
}

项目API使用文档

主要API

• Puppeteer.LaunchAsync：启动浏览器实例。
• Browser.NewPageAsync：创建新页面。
• Page.GoToAsync：导航到指定URL。
• Page.ScreenshotAsync：截取页面截图。
• Page.PdfAsync：生成PDF文件。
• Page.SetContentAsync：注入HTML内容。
• Page.EvaluateExpressionAsync：执行JavaScript表达式。
• Page.WaitForSelectorAsync：等待指定选择器。
• Page.WaitForFunctionAsync：等待指定JavaScript函数执行。

详细API文档

请参考API Documentation获取更详细的API使用说明。

项目安装方式

通过NuGet安装

dotnet add package PuppeteerSharp

手动下载

访问NuGet官网下载并安装Puppeteer Sharp包。

通过以上步骤，您可以顺利安装并使用Puppeteer Sharp进行网页自动化操作。

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