Playwright for .NET 使用教程

1. 项目的目录结构及介绍

Playwright for .NET 项目的目录结构如下：

playwright-dotnet/
├── src/
│   ├── Playwright/
│   └── Playwright.Tests/
├── docs/
├── .github/
├── .gitignore
├── LICENSE
├── README.md
├── global.json
├── nuget.config
└── Playwright.sln

目录结构介绍

• src/: 包含项目的主要源代码。
  • Playwright/: Playwright for .NET 的核心库。
  • Playwright.Tests/: 测试代码。
• docs/: 包含项目的文档文件。
• .github/: GitHub 相关的配置文件。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证（MIT 许可证）。
• README.md: 项目介绍和使用说明。
• global.json: 项目全局配置文件。
• nuget.config: NuGet 配置文件。
• Playwright.sln: 项目解决方案文件。

2. 项目的启动文件介绍

Playwright for .NET 的启动文件主要位于 src/Playwright/ 目录下。以下是一些关键的启动文件：

• Playwright.cs: 主启动类，包含 Playwright 实例的创建和浏览器启动方法。
• BrowserType.cs: 浏览器类型定义，支持 Chromium、Firefox 和 WebKit。
• Page.cs: 页面操作类，包含页面导航、截图等方法。

示例代码

using System.Threading.Tasks;
using Microsoft.Playwright;

class Program
{
    public static async Task Main(string[] args)
    {
        using var playwright = await Playwright.CreateAsync();
        await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions
        {
            Headless = false
        });
        var page = await browser.NewPageAsync();
        await page.GotoAsync("https://playwright.dev/dotnet");
        await page.ScreenshotAsync(new PageScreenshotOptions
        {
            Path = "screenshot.png"
        });
    }
}

3. 项目的配置文件介绍

Playwright for .NET 的配置文件主要包括以下几个：

• global.json: 项目全局配置文件，定义了 SDK 版本等信息。
• nuget.config: NuGet 配置文件，定义了 NuGet 源和其他配置。
• Playwright.sln: 项目解决方案文件，包含了项目的所有项目文件和配置。

global.json

{
  "sdk": {
    "version": "5.0.100"
  }
}

nuget.config

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  </packageSources>
</configuration>

Playwright.sln

解决方案文件包含了项目的所有项目文件和配置，可以通过 Visual Studio 或其他 IDE 打开和编辑。

Microsoft Visual Studio Solution File, Format Version 12.00
# Visual Studio Version 16
VisualStudioVersion = 16.0.30114.105
MinimumVisualStudioVersion = 10.0.40219.1
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Playwright", "src\Playwright\Playwright.csproj", "{GUID}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Playwright.Tests", "src\Playwright.Tests\Playwright.Tests.csproj", "{GUID}"
EndProject
Global
    GlobalSection(SolutionConfigurationPlatforms) = preSolution
        Debug|Any CPU = Debug|Any CPU
        Release|Any CPU = Release|Any CPU
    EndGlobalSection
    GlobalSection(ProjectConfigurationPlatforms) = postSolution
        {GUID}.Debug|Any CPU.