# Завершити тестування з PuppeteerSharp - Правильною альтернативою Selenium

<datetime class="hidden">2025-11-27T12:00</datetime>

<!--category-- PuppeteerSharp, E2E Testing, xUnit, Testing -->
Сучасний E2E M SK1End-ToMSC3End+, використовуючи ваш сайт так, як це роблять użytkownicy, тестування не обов 'язково буде болісним.. Цей цілковитий інструкт показує вам, як використовувати PuppeteerSharp для швидкого тестування. , надійна автоматизація браузера в МSK9 NETМSK10 об' єднання всього від базового тестування до генерації PDF і веб-шкрапування. [Рухівник драматурга](/blog/playwright-e2e-testing) замість.

## Введение

Якщо ви колись працювали з [Селен](https://www.selenium.dev/) для закінчення-~-завершення тестуванняM SK2 ви' знаєте, що це може бути справжньою болемою на спині . Між боротьбою з версіями драйверів МSK5 справлячись з нестабільними тестами, які працюють на вашому машині, але ніде інше MSC6 і загальною невпертістю протоколу WebDriver M SK7 це ' достатньо для того, щоб ви хотіли все закинути і перевірити вручну, замість цього

Ввести [Шарп ляльок](https://www.puppeteersharp.com/) - порт МSK1NET GoogleM SK2s [Ляльковий театр](https://pptr.dev/) bibliotekа. Це ' схоже на Selenium' молодшийM SK3 швидший двоюрідний брат, який справді намагається з 'являтися вчасно і не вимагає, щоб ви завантажували сімнадцять різних драйверів браузеруMSC5

В цьому artykule я розповім вам про те, як я втілив PuppeteerSharp для E , а також про тестування на цьому самому blogu. Я наведу приклади реального коду з репо.

[TOC]

## Що це за ляльковий трюк тоді?

[Шарп ляльок](https://www.puppeteersharp.com/) це bibliotekа .NET, що надає високу API - для управління браузерами Chrome або Chromium, використовуючи [Протокол DevTools Chrome](https://chromedevtools.github.io/devtools-protocol/). На відміну від [Селен](https://www.selenium.dev/),, що використовує [Протокол WebDriver](https://www.w3.org/TR/webdriver/) ( досить заплутаний HTTP -забудований JSON дротий протокол M SK2 PuppeteerSharp спілкується безпосередньо з браузером через DevTools .

Подумайте ось так.

- **Селен**: Як надсилати листи по почті, щоб спілкуватися з вашим браузером
- **Шарп ляльок**: Як мати прямий телефонний зв 'язок з браузером

```mermaid
graph LR
    A[Test Code] -->|WebDriver Protocol| B[Selenium]
    B -->|JSON Wire Protocol| C[Browser Driver]
    C -->|Commands| D[Browser]

    E[Test Code] -->|DevTools Protocol| F[PuppeteerSharp]
    F -->|Direct Connection| G[Chrome/Chromium]

    style A stroke:#333,stroke-width:2px
    style E stroke:#333,stroke-width:2px
    style F stroke:#0066cc,stroke-width:3px
    style G stroke:#0066cc,stroke-width:3px
```

### Де тестування E2E вписується у вашу стратегію тестування

Перед тим, як зануритися глибше, давайте поговоримо про те, де тестування на E співпадає з великою системою речей. Ви, мабуть, чули про піраміду тестування. Тут – 5, тут – 6, ось як воно насправді працює в практиці.

```mermaid
graph TB
    subgraph "Testing Pyramid"
        E2E[E2E Tests<br/>Few, Slow, High Confidence<br/>Test full user journeys]
        INT[Integration Tests<br/>Medium number, Medium speed<br/>Test component interactions]
        UNIT[Unit Tests<br/>Many, Fast, Low Cost<br/>Test individual functions]
    end

    subgraph "Trade-offs"
        SPEED[Speed]
        CONF[Confidence]
        COST[Cost]
    end

    subgraph "When to Use E2E"
        W1[Critical user journeys<br/>e.g. checkout, login]
        W2[Cross-browser compatibility]
        W3[JavaScript-heavy UIs]
        W4[Complex user interactions]
    end

    E2E -.->|Slow but high confidence| CONF
    INT -.->|Balanced| SPEED
    UNIT -.->|Fast and cheap| SPEED

    E2E -.->|Expensive to run| COST
    UNIT -.->|Cheap to run| COST

    style E2E stroke:#cc0000,stroke-width:3px
    style INT stroke:#ff9900,stroke-width:2px
    style UNIT stroke:#00aa00,stroke-width:2px
    style CONF stroke:#0066cc,stroke-width:2px
    style SPEED stroke:#00aa00,stroke-width:2px
    style COST stroke:#cc0000,stroke-width:2px
```

**Перевірка реальності:**

- **Тести на одиниці** (80% з ваших тестів ): швидкий МSK2 дешевий M SK3 перевіряє окремі функції . Але вони не скажуть вам, чи система насправді працює як ціла
- **Тести інтеграції** (15% з ваших тестів ): Проверка того, як різні частини працюють разом МSK2 Краще, ніж E
- **E2E тести** (5% з ваших тестів ): Повільний M SK2 дорогий МSK3 але перевіряйте систему точно так, як її сприймають użytkownicy . Ось тут світиться PuppeteerSharp

**Коли вам потрібне E2E тести**

1. **Критичні подорожі користувача** - НавігаціяM SK1 Виписок, Обробка платежів . Якщо ці перешкоди закінчуютьсяMSC4 Ваша діяльність припинитьсяМSK5
2. **JavaScript-важкі інтерфейси** - Современні SPA МSK1[Відреагувати](https://react.dev/), [Ву](https://vuejs.org/), [У куті](https://angular.dev/)) там, де інтерфейс інтерфейсу відтворюється - klient -замість МSK2
3. **Проблеми браузера Cross-** - Різні браузери відображають речі по-різному  хоча з PuppeteerSharp ви МSK2 маєте Chrome МСК3 тільки МСК4
4. **Складні взаємодія** - Мультибайкальні МSK1штовпівні маги МSK2 перетягування - і \ - викидування \ МSK5 \ завантаження файлів

**Коли вам потрібні E2E тести**

1. **Прості операції CRUD** - Тестів на інтеграцію достатньо
2. **Чиста логіка** - Те, що МSK1 це те, що одиниця тестів для МSK2
3. **Кожний край** - EM SK1E тести надто повільні і дорогі для виснажливого тестування

### Чому PuppeteerSharp над Selenium?

Дозвольте мені порахувати шляхи

1. **Немає faff управління драйвером**: PuppeteerSharp завантажує та управляє браузером Chrome для вас . Ніхто більше не думає про версії ChromeDriver, які не співпадають з вашим zainstalowanим Chrome МSK2

2. **Швидше виконання**: Протокол DevTools значно швидший, ніж WebDriver

3. **кращий інтерфейс**: Програмний інтерфейс більш сучасний і інтуїтивний . Це МSK2 асинк M SK3 чекати аж донизу , який прекрасно підходить до сучасного МСК5 NET розвитку М СК6

4. **Збудований - на екрані МSK1 генерація PDF**: Хочете скриншот, коли тест зазнає невдачі

5. **Захопити запити мережі**: Ви можете легко перехопитиM SK1 змінити, або блокувати мережі запити - блискуче для тестування бездротових сценаріїв чи викидання API відповідей МSK4

6. **Правильне виконання JavaScript**: Виконуйте JavaScript у контексті сторінки і отримаєте результати таким чином, що не змусить вас плакати

## Налагодження ляльок

Спочатку, додайте [Шарп ляльок](https://www.nuget.org/packages/PuppeteerSharp) NuGet пакет:

```bash
dotnet add package PuppeteerSharp
```

Ось моя конфігурація тестового проекту (`Mostlylucid.Test/Mostlylucid.Test.csproj:23`):

```xml
<PackageReference Include="PuppeteerSharp" Version="20.2.4" />
<PackageReference Include="xunit" Version="2.9.3" />
<PackageReference Include="xunit.runner.visualstudio" Version="3.1.4">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
</PackageReference>
```

I' я використовую [xUnit](https://xunit.net/) (ASP.NET Core's defaultM SK3 але PuppeteerSharp працює так само добре з [NUnit](https://nunit.org/) або [Тест на MS](https://learn.microsoft.com/en-us/dotnet/core/testing/unit-testing-with-mstest).

## Створити клас базового тесту

Замість того, щоб повторювати встановлення/teardown код у кожному тесті , IM SK2 я створив базову класи (`Mostlylucid.Test/E2E/E2ETestBase.cs:12`), що відповідає за управління життєвим циклом браузера

### Структура класу

```csharp
using PuppeteerSharp;
using Xunit.Abstractions;

namespace Mostlylucid.Test.E2E;

public abstract class E2ETestBase : IAsyncLifetime
{
    protected readonly ITestOutputHelper Output;
    protected IBrowser Browser = null!;
    protected IPage Page = null!;

    protected const string BaseUrl = "http://localhost:8080";
    protected const int DefaultTimeout = 30000;

    protected E2ETestBase(ITestOutputHelper output)
    {
        Output = output;
    }
```

Ми реалізуємо [IAsyncLifetime](https://xunit.net/docs/shared-context#async-lifetime) з xUnit, що надає асинкову налаштуванняM SK1teardown. На відміну від традиційних конструйторів , це дає нам змогу правильно чекати інициалізації браузераMSC4

### Початкування браузера

```csharp
    public async Task InitializeAsync()
    {
        // Download Chromium on first run
        var browserFetcher = new BrowserFetcher();
        await browserFetcher.DownloadAsync();

        // Launch browser with sensible defaults
        Browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true, // Set false for debugging
            DefaultViewport = new ViewPortOptions
            {
                Width = 1400,
                Height = 900
            },
            Args = new[]
            {
                "--no-sandbox",
                "--disable-setuid-sandbox"
            }
        });

        Page = await Browser.NewPageAsync();
        Page.DefaultTimeout = DefaultTimeout;
    }
```

І `BrowserFetcher` автоматично завантажує kompaтиbilну версію хрому на першому запускі - не потрібно вручного управління драйверами `--no-sandbox` Флаги необхідні для Docker/CI середовищ.

### Чиszczenie

```csharp
    public async Task DisposeAsync()
    {
        if (Page != null) await Page.CloseAsync();
        if (Browser != null) await Browser.CloseAsync();
    }
}
```

Правильне знищення є вирішальним, щоб уникнути витіку пам 'яті. Кожна instance браузера використовує 100-200MB оперативної пам' яті .

## Допоміжні методи

Базовая клас includes helper methods to reduce boilerplate (`Mostlylucid.Test/E2E/E2ETestBase.cs:72-172`):

```csharp
// Navigation with automatic network idle waiting
protected async Task NavigateAsync(string path)
{
    var url = path.StartsWith("http") ? path : $"{BaseUrl}{path}";
    await Page.GoToAsync(url, new NavigationOptions
    {
        WaitUntil = new[] { WaitUntilNavigation.Networkidle2 }
    });
}

// Safe element waiting with timeout handling
protected async Task<IElementHandle?> WaitForSelectorAsync(string selector, int timeout = 5000)
{
    try
    {
        return await Page.WaitForSelectorAsync(selector, new WaitForSelectorOptions
        {
            Timeout = timeout,
            Visible = true
        });
    }
    catch (WaitTaskTimeoutException)
    {
        return null; // Graceful degradation
    }
}

// Common element operations
protected async Task<bool> ElementExistsAsync(string selector) =>
    await Page.QuerySelectorAsync(selector) != null;

protected async Task<string?> GetTextContentAsync(string selector)
{
    var element = await Page.QuerySelectorAsync(selector);
    return element == null ? null :
        await Page.EvaluateFunctionAsync<string>("el => el.textContent", element);
}

protected async Task TypeAsync(string selector, string text, int delay = 50)
{
    await Page.WaitForSelectorAsync(selector);
    await Page.TypeAsync(selector, text, new TypeOptions { Delay = delay });
}

protected async Task ClickAsync(string selector)
{
    await Page.WaitForSelectorAsync(selector);
    await Page.ClickAsync(selector);
}
```

Вони обробляють нудні біти -, очікуючи на існування елементів , граційне тайм-аутування МSK2 і автоматичне записування, коли тести провалюються в CI

## Пишання справжних тестів

Гаразд, дозвольтеМSK1 дістатись до хороших речей M SK2 писати справжні тести. ось тутMSC4 це справжній тест з мого блогу МSK5 функція панелі фильтра (`Mostlylucid.Test/E2E/FilterBarTests.cs:20-50`):

```csharp
[Fact(Skip = "Local E2E test - requires site to be running on localhost:8080")]
public async Task FilterBar_LanguageDropdown_ShowsLanguages()
{
    // Arrange
    await NavigateAsync("/blog");

    // Act - Click the language dropdown button
    var dropdownButton = await WaitForSelectorAsync("#LanguageDropDown button");
    Assert.NotNull(dropdownButton);

    await ClickAsync("#LanguageDropDown button");
    await WaitAsync(300);

    // Assert - Dropdown menu should be visible with language options
    var dropdownOpen = await EvaluateFunctionAsync<bool>(@"() => {
        const dropdown = document.querySelector('#LanguageDropDown div[x-show]');
        if (!dropdown) return false;
        const style = window.getComputedStyle(dropdown);
        return style.display !== 'none';
    }");

    Assert.True(dropdownOpen, "Language dropdown should be open");

    // Check that English option exists
    var hasEnglish = await EvaluateFunctionAsync<bool>(@"() => {
        const options = document.querySelectorAll('#LanguageDropDown li a');
        return Array.from(options).some(opt => opt.textContent.toLowerCase().includes('english'));
    }");

    Assert.True(hasEnglish, "Language dropdown should contain English option");
    Output.WriteLine("✅ Language dropdown shows languages correctly");
}
```

Цей тест перевіряє, чи мій language dropdown працює правильно.

### Приналежність  រំលង 

```csharp
[Fact(Skip = "Local E2E test - requires site to be running on localhost:8080")]
```

I' я пропустив цей тест по замовчуванню, тому що він вимагає локального запуску сайту. . Для тестів на EM SK2E, ви зазвичай хочете, щоб вони працювали на żądaнні, а не з кожною будівлею.

### Використовуючи JavaScript

```csharp
var dropdownOpen = await EvaluateFunctionAsync<bool>(@"() => {
    const dropdown = document.querySelector('#LanguageDropDown div[x-show]');
    if (!dropdown) return false;
    const style = window.getComputedStyle(dropdown);
    return style.display !== 'none';
}");
```

Це одна з областей, де PuppeteerSharp абсолютно світиться. `EvaluateFunctionAsync` метод дозволяє запустити JavaScript у контексті браузера і отримати результат як правильний . NET тип. В цьому випадкуM SK2 I 'm перевіряє, чи Dropdown дійсно помітний МSK4 не лише присутній в DOM

Порівняйте це з Selenium, де вам потрібно

1. Найти елемент
2. Візьміть свою властивість дисплею
3. Розглянемо результат стрічки
4. Сподіваюсь, що ' не застарів, коли ви його перевірите

### Тестування взаємодії HTMX

Мій блог використовує [HTMX](https://htmx.org/) здебільшого (сервер`Mostlylucid.Test/E2E/FilterBarTests.cs:98-126`):

```csharp
[Fact(Skip = "Local E2E test - requires site to be running on localhost:8080")]
public async Task FilterBar_SortOrder_ChangesPostOrder()
{
    // Arrange
    await NavigateAsync("/blog");

    // Get the first post title before sorting
    var firstPostBefore = await EvaluateFunctionAsync<string>(@"() => {
        const postLink = document.querySelector('.post-title, article h2 a, #contentcontainer article a');
        return postLink?.textContent?.trim() || '';
    }");
    Output.WriteLine($"First post before sort: {firstPostBefore}");

    // Act - Change sort order to "Oldest first"
    await Page.SelectAsync("#orderSelect", "date_asc");
    await WaitAsync(1000); // Wait for HTMX to update

    // Assert - Post order should have changed
    var firstPostAfter = await EvaluateFunctionAsync<string>(@"() => {
        const postLink = document.querySelector('.post-title, article h2 a, #contentcontainer article a');
        return postLink?.textContent?.trim() || '';
    }");
    Output.WriteLine($"First post after sort: {firstPostAfter}");

    var selectValue = await EvaluateFunctionAsync<string>("() => document.querySelector('#orderSelect')?.value");
    Assert.Equal("date_asc", selectValue);
    Output.WriteLine("✅ Sort order selection works correctly");
}
```

Ключом тут є `await WaitAsync(1000)` після зміни виборної величини. HTMX потребує хвилини, щоб зробити свою просьбу і обновити DOM. У ідеальнему світіMSC2 миM SK3 чекали, поки завершиться окрема мережева просьбаМSK4 але для простих речей МSK5 коротка затримка непоганаMスク6

### Testing Responsive Design

Тут ' є химерним тестом, який перевіряє, чи мою панель фильтров правильно прихований на мобільних пристроях (`Mostlylucid.Test/E2E/FilterBarTests.cs:216-245`):

```csharp
[Fact(Skip = "Local E2E test - requires site to be running on localhost:8080")]
public async Task FilterBar_ResponsiveDesign_HiddenOnMobile()
{
    // Arrange - Set mobile viewport
    await Page.SetViewportAsync(new ViewPortOptions
    {
        Width = 375,
        Height = 667
    });

    await NavigateAsync("/blog");
    await WaitAsync(500);

    // Assert - Filter bar should be hidden on mobile
    var filterBarVisible = await EvaluateFunctionAsync<bool>(@"() => {
        const filterBar = document.querySelector('.hidden.lg\\:flex');
        if (!filterBar) return true;
        const rect = filterBar.getBoundingClientRect();
        return rect.width > 0 && rect.height > 0;
    }");

    Assert.False(filterBarVisible, "Filter bar should be hidden on mobile viewport");
    Output.WriteLine("✅ Filter bar correctly hidden on mobile");

    // Reset viewport
    await Page.SetViewportAsync(new ViewPortOptions
    {
        Width = 1400,
        Height = 900
    });
}
```

Ви можете в будь-який момент змінити порт перегляду,, що чудово підходить для тестування реакційних макетівM SK1 значно легше, ніж звичайне перебільшення вікна браузера

## Заawansовані характеристики PuppeteerSharp

### Перехоплення мережі

Однією з моїх улюблених характеристик є здатність перехоплювати та змінювати мережі запити. Це неоцінюва для тестування станів помилок або офлайн сценаріївM SK1

```csharp
await Page.SetRequestInterceptionAsync(true);

Page.Request += async (sender, e) =>
{
    // Block all image requests to speed up tests
    if (e.Request.ResourceType == ResourceType.Image)
    {
        await e.Request.AbortAsync();
    }
    // Mock API responses
    else if (e.Request.Url.Contains("/api/posts"))
    {
        await e.Request.RespondAsync(new ResponseData
        {
            Status = HttpStatusCode.OK,
            ContentType = "application/json",
            Body = "{\"posts\": []}"
        });
    }
    else
    {
        await e.Request.ContinueAsync();
    }
};
```

### Зйомка кадрів

Коли тест зазнає невдачі, скриншот вартий тисячі повідомлень

```csharp
try
{
    // Your test code here
    await Page.ClickAsync("#someButton");
}
catch (Exception)
{
    // Take a screenshot on failure
    await Page.ScreenshotAsync("test-failure.png");
    throw; // Re-throw to fail the test
}
```

### генерація PDF

Ви можете навіть генерувати PDF сторінок,, що є корисною для тестування сервераM SK1 сторонне відображання чи друкування таблиць стилю:

```csharp
await Page.PdfAsync("page.pdf", new PdfOptions
{
    Format = PaperFormat.A4,
    PrintBackground = true
});
```

### Кодування

PuppeteerSharp навіть може зібрати дані про кодування JavaScript:

```csharp
await Page.Coverage.StartJSCoverageAsync();
await Page.GoToAsync("http://localhost:8080");

var coverage = await Page.Coverage.StopJSCoverageAsync();
var totalBytes = coverage.Sum(c => c.Text.Length);
var usedBytes = coverage.Sum(c => c.Ranges.Sum(r => r.End - r.Start));
var percentUsed = usedBytes / (double)totalBytes * 100;

Output.WriteLine($"JavaScript coverage: {percentUsed:F2}%");
```

## PuppeteerSharp vs The Competition

Давайте поглянемо на те, як PuppeteerSharp накладається на інші інструменти тестування.

```mermaid
graph TD
    A[E2E Testing Tools] --> B[Selenium WebDriver]
    A --> C[PuppeteerSharp]
    A --> D[Playwright]
    A --> E[Cypress]

    B --> B1[❌ Slow WebDriver protocol]
    B --> B2[❌ Driver management hassle]
    B --> B3[✅ Multi-browser support]
    B --> B4[✅ Mature ecosystem]

    C --> C1[✅ Fast DevTools protocol]
    C --> C2[✅ Auto browser management]
    C --> C3[❌ Chrome/Chromium only]
    C --> C4[✅ Great .NET integration]

    D --> D1[✅ Fast DevTools protocol]
    D --> D2[✅ Auto browser management]
    D --> D3[✅ Multi-browser support]
    D --> D4[⚠️ Newer to .NET ecosystem]

    E --> E1[✅ Great developer experience]
    E --> E2[❌ JavaScript only]
    E --> E3[❌ Not for .NET]
    E --> E4[✅ Excellent documentation]

    style C stroke:#0066cc,stroke-width:3px
    style C1 stroke:#00aa00,stroke-width:2px
    style C2 stroke:#00aa00,stroke-width:2px
    style C4 stroke:#00aa00,stroke-width:2px
```

### Веб-драйвер Selenium

**Стара гвардія**

Selenium існує з 2004 і показує МSK1 Він МSK2 дорослій , добре мSK4 документований , і підтримує кожен браузер під сонцем एमSK6 Але він МіСК7 також показує свій вік МиСК8

**Прос:**

- Obsługовує всі браузери (Chrome, FirefoxM SK2 Safari , Edge МSK4 IE, якщо ви
- Массивна екосистема інструментів та розширень
- Well-відомі та широко пристосовані
- Хороший для тестування браузера cross-

**Згоди:**

- Протокол WebDriver повільний
- Менеджмент драйверів болить ( хоча WebDriverManager допомагає )
- API відчуває себе застарілою порівняно з сучасними альтернативами
- Нестачі тестів є поширеними через проблеми часу
- Немає вбудованого-захоплення мережі

**Коли його використовувати:** Коли вам обов 'язково потрібно перевірити кілька браузерів, або коли виM SK1 вже інвестували в екосистему Selenium.

### Гравця

**Нова дитина у кварталі**

[Гравця](https://playwright.dev/) Microsoft' відповість на Puppeteer, з [.NET](https://playwright.dev/dotnet/) запечено з самого початку. Це ' по суті PuppeteerSharp, але з мультиплікатором

**Прос:**

- Obsługа Chrome, Firefox, Safari M SK2WebKitMSC3
- Совремельне API схоже на Puppeteer
- Auto- завантажує браузери
- Вбудована-захоплення мережіM SK1 скриншотиМSK2 і т.д.
- Чудова підтримка .NET

**Згоди:**

- Нова ",", так менша екосистема
- Може бути надмірним, якщо вам потрібна лише Chrome
- Трохи складніше встановлення завдяки підтримці браузера multi-

**Коли його використовувати:** Коли ви потребуєте мультиплікової-справки браузером, але хочете мати сучасний API. Якщо виM SK2запускаєте новий проект і потребуєте тестування браузера на кшталтMSC3Playwright, мабуть, найкращий варіант для вас

### Cypress

**Розробник JavaScript's Darling**

Cypress чудовий, якщо ви працюєте в JavaScript.

**Прос:**

- Фантастичний досвід розробника
- Час-розладнання подорожей
- Автоматичне очікування
- Чудова документація

**Згоди:**

- JavaScript/Только шрифт
- Немає підтримки .NET
- Можемо' перевірити багато вкладок або вікон
- Ограничений на тестування вашої власної додатки (без тестування по всіх доменах )

**Коли його використовувати:** Don'tM SK1 ти' ти пишеш . NET код МSK4 Stick to something that integrates with your tech stack

### Отже, що ви повинні використовувати?

Ось що я маю на увазі

```mermaid
graph TD
    A[What E2E tool?] --> B{Need multi-browser testing?}
    B -->|Yes| C{Starting new project?}
    B -->|No| D[PuppeteerSharp]

    C -->|Yes| E[Playwright]
    C -->|No| F{Invested in Selenium?}

    F -->|Yes| G[Stick with Selenium]
    F -->|No| E

    D --> H[✅ Fast, simple, reliable]
    E --> I[✅ Modern, flexible]
    G --> J[⚠️ Consider migrating]

    style D stroke:#0066cc,stroke-width:3px
    style H stroke:#00aa00,stroke-width:2px
```

Для більшості . NET програмістів, які будують сучасні веб-приложения

- **Chrome-випробовування тільки** → Шарп ляльок
- **Мільйозий-випробування браузераM SK1** → Playwright
- **Ви вже користуєтесь Selenium?** → Подумайте про міграцію до Playwright ,, але не стривайте

## Випробування в CI/CD

E2E тести всі добре і добре на вашому локальному комп 'ютері , але вони мають бути проведені в каналах CI МSK2 ЦД, також. [Акція GitHub](https://github.com/features/actions):

```yaml
name: E2E Tests

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  e2e-tests:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v3

    - name: Setup .NET
      uses: actions/setup-dotnet@v3
      with:
        dotnet-version: '9.0.x'

    - name: Install dependencies
      run: dotnet restore

    - name: Build
      run: dotnet build --no-restore

    - name: Start application
      run: |
        dotnet run --project Mostlylucid/Mostlylucid.csproj &
        echo $! > app.pid

    - name: Wait for application to start
      run: |
        timeout 60 bash -c 'until curl -f http://localhost:8080/health; do sleep 2; done'

    - name: Run E2E tests
      run: |
        dotnet test Mostlylucid.Test/Mostlylucid.Test.csproj \
          --filter "Category=E2E" \
          --logger "console;verbosity=detailed"

    - name: Upload screenshots on failure
      if: failure()
      uses: actions/upload-artifact@v3
      with:
        name: test-screenshots
        path: '**/test-failure-*.png'

    - name: Stop application
      if: always()
      run: |
        kill $(cat app.pid) || true
```

Ключові біти:

1. Почати програму в фоні
2. Подивіться, чи вона здорова. (за допомогою кінцевого пункту проверки здоров 'я.
3. Пройти тести E2E
4. завантажити скриншоти, якщо будь-які тести провалюються
5. І завжди зупиняйте додаток, навіть якщо тести провалюються

## Поширені прогалини і як їх уникнути

### Тести на фляки

E2E тести можуть бути схвильованими - вони іноді проходять, а інші - провалюються.

**Поганий:**

```csharp
await Page.ClickAsync("#button");
var text = await GetTextContentAsync("#result");
Assert.Equal("Success", text);
```

**Добре:**

```csharp
await Page.ClickAsync("#button");
await Page.WaitForSelectorAsync("#result");
var text = await GetTextContentAsync("#result");
Assert.Equal("Success", text);
```

Всегда чекати на те, щоб елемент, з яким ви будете взаємодіяти, існував і був видимим.

### Тест ізоляції

Кожен тест повинен бути повністю незалежним.

**Поганий:**

```csharp
[Fact]
public async Task Test1_Login()
{
    await LoginAsync("user", "password");
    // User is now logged in for subsequent tests
}

[Fact]
public async Task Test2_ViewDashboard()
{
    // Assumes user is still logged in from Test1
    await NavigateAsync("/dashboard");
}
```

**Добре:**

```csharp
[Fact]
public async Task Test1_Login()
{
    await LoginAsync("user", "password");
    await LogoutAsync(); // Clean up
}

[Fact]
public async Task Test2_ViewDashboard()
{
    await LoginAsync("user", "password"); // Set up needed state
    await NavigateAsync("/dashboard");
    await LogoutAsync(); // Clean up
}
```

### Патерн об 'єктів сторінки

Для складних сторінок, використовуйте шаблон Об 'єкту сторінки для підтримки тестів

```csharp
public class BlogPageObject
{
    private readonly IPage _page;

    public BlogPageObject(IPage page)
    {
        _page = page;
    }

    public async Task SelectLanguageAsync(string language)
    {
        await _page.ClickAsync("#LanguageDropDown button");
        await _page.WaitAsync(300);
        await _page.ClickAsync($"#LanguageDropDown a:has-text('{language}')");
    }

    public async Task<string[]> GetPostTitlesAsync()
    {
        return await _page.EvaluateFunctionAsync<string[]>(@"() => {
            return Array.from(document.querySelectorAll('.post-title'))
                        .map(el => el.textContent.trim());
        }");
    }
}

// Usage in tests
[Fact]
public async Task Can_Filter_By_Language()
{
    var blogPage = new BlogPageObject(Page);
    await NavigateAsync("/blog");

    await blogPage.SelectLanguageAsync("Spanish");
    var titles = await blogPage.GetPostTitlesAsync();

    Assert.All(titles, title => Assert.NotEmpty(title));
}
```

## Рівень ефективності

E2E тести повільніші, ніж одиниці тестів , там МSK2 не справляються з цим M SK3 Але ви можете зробити їх швидшими

### Пройти тести паралельно

xUnit запускає тести паралельно по замовчуванню,, але вам потрібно бути обережним щодо спільного стануM SK1

```csharp
[Collection("E2E Tests")] // Tests in same collection run sequentially
public class FilterBarTests : E2ETestBase
{
    // Tests here share resources
}

[Collection("Blog Tests")] // Different collection runs in parallel
public class BlogTests : E2ETestBase
{
    // Tests here run in parallel with FilterBarTests
}
```

### Виключити необов 'язкове

Пошвидшити тести, виключивши непотрібні funkcje

```csharp
Browser = await Puppeteer.LaunchAsync(new LaunchOptions
{
    Headless = true,
    Args = new[]
    {
        "--no-sandbox",
        "--disable-setuid-sandbox",
        "--disable-dev-shm-usage", // Overcome limited resource problems
        "--disable-accelerated-2d-canvas",
        "--disable-gpu", // Not needed for headless
        "--disable-images", // Don't load images if you don't need them
        "--disable-javascript", // Only if testing static content
    }
});
```

### Використовуйте Network Interception Wisely

Заблокувати непотрібні ресурси, щоб пришвидшити ситуацію:

```csharp
await Page.SetRequestInterceptionAsync(true);
Page.Request += async (sender, e) =>
{
    var blockedResourceTypes = new[]
    {
        ResourceType.Image,
        ResourceType.Media,
        ResourceType.Font,
        ResourceType.StyleSheet // If you don't need to test styling
    };

    if (blockedResourceTypes.Contains(e.Request.ResourceType))
    {
        await e.Request.AbortAsync();
    }
    else
    {
        await e.Request.ContinueAsync();
    }
};
```

## Розладнання тестів E2E

Коли тести зазнають невдачі, ( і вони будуть зламані ), вам потрібно їх розв 'язати

### Працювати в trybie безHeadless

Встановити `Headless = false` для перегляду браузера в дії:

```csharp
Browser = await Puppeteer.LaunchAsync(new LaunchOptions
{
    Headless = false,
    SlowMo = 100, // Slow down by 100ms to see what's happening
});
```

### Використовуйте DevTools

Ви можете насправді відкрити DevTools за програмою:

```csharp
Browser = await Puppeteer.LaunchAsync(new LaunchOptions
{
    Headless = false,
    Devtools = true, // Auto-open DevTools
});
```

### Запис konsolі

Захопити повідомлення з консолі від браузера:

```csharp
Page.Console += (sender, e) =>
{
    Output.WriteLine($"Browser console: {e.Message.Text}");
};
```

### Запроси запису

Зареєструвати всі запити на мережу:

```csharp
Page.Request += (sender, e) =>
{
    Output.WriteLine($"Request: {e.Request.Method} {e.Request.Url}");
};

Page.Response += (sender, e) =>
{
    Output.WriteLine($"Response: {e.Response.Status} {e.Response.Url}");
};
```

## Моделі тесту Real-World

Ось деякі шаблони, які я регулярно використовую в тестах на E2E

### Видання тестуючих форм

```csharp
[Fact]
public async Task Can_Submit_Comment()
{
    await NavigateAsync("/blog/some-post");

    // Fill in the comment form
    await TypeAsync("#comment-name", "Test User");
    await TypeAsync("#comment-email", "test@example.com");
    await TypeAsync("#comment-content", "This is a test comment");

    // Submit the form
    await ClickAsync("#comment-submit");

    // Wait for success message
    await WaitForSelectorAsync(".comment-success");

    // Verify the comment appears
    var commentText = await GetTextContentAsync(".comment-list .comment:last-child .comment-content");
    Assert.Contains("test comment", commentText.ToLower());
}
```

### Випробовуємо інтерактиви клавіатури

```csharp
[Fact]
public async Task Can_Navigate_With_Keyboard()
{
    await NavigateAsync("/blog");

    // Focus the search box
    await Page.FocusAsync("#search");

    // Type a search query
    await Page.Keyboard.TypeAsync("testing");

    // Press arrow down to select first result
    await Page.Keyboard.PressAsync("ArrowDown");

    // Press enter to navigate
    await Page.Keyboard.PressAsync("Enter");

    // Verify we navigated to the right page
    await WaitAsync(1000);
    Assert.Contains("/blog/", Page.Url);
}
```

### Випробовуємо завантаження файлів

```csharp
[Fact]
public async Task Can_Upload_Image()
{
    await NavigateAsync("/admin/upload");

    // Create a test file
    var testFilePath = Path.Combine(Path.GetTempPath(), "test-image.jpg");
    File.WriteAllBytes(testFilePath, new byte[] { 0xFF, 0xD8, 0xFF }); // JPEG header

    // Upload the file
    var fileInput = await Page.QuerySelectorAsync("input[type=file]");
    await fileInput.UploadFileAsync(testFilePath);

    await ClickAsync("#upload-submit");

    // Verify upload succeeded
    await WaitForSelectorAsync(".upload-success");

    // Clean up
    File.Delete(testFilePath);
}
```

### Випробовування Drag and Drop

```csharp
[Fact]
public async Task Can_Reorder_Items()
{
    await NavigateAsync("/admin/posts");

    var dragSource = await Page.QuerySelectorAsync(".post-item[data-id='1']");
    var dropTarget = await Page.QuerySelectorAsync(".post-item[data-id='3']");

    var sourceBox = await dragSource.BoundingBoxAsync();
    var targetBox = await dropTarget.BoundingBoxAsync();

    // Perform drag and drop
    await Page.Mouse.MoveAsync(sourceBox.X + sourceBox.Width / 2, sourceBox.Y + sourceBox.Height / 2);
    await Page.Mouse.DownAsync();
    await Page.Mouse.MoveAsync(targetBox.X + targetBox.Width / 2, targetBox.Y + targetBox.Height / 2);
    await Page.Mouse.UpAsync();

    await WaitAsync(500);

    // Verify new order
    var firstItemId = await Page.EvaluateFunctionAsync<string>(
        "() => document.querySelector('.post-item').dataset.id"
    );
    Assert.Equal("1", firstItemId);
}
```

## Інтеграція з ядром ASP.NET

Ви можете інтегрувати PuppeteerSharp з [ASP.NET Core's WebApplicationFactory](https://learn.microsoft.com/en-us/aspnet/core/test/integration-tests) для більш інтегрованого тестування:

```csharp
public class E2EWebApplicationFactory : WebApplicationFactory<Program>
{
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        builder.UseUrls("http://localhost:5050");

        builder.ConfigureServices(services =>
        {
            // Override services for testing
            // For example, use in-memory database
            services.RemoveAll<DbContextOptions<MostlylucidDbContext>>();
            services.AddDbContext<MostlylucidDbContext>(options =>
            {
                options.UseInMemoryDatabase("TestDb");
            });
        });
    }
}

public abstract class IntegratedE2ETestBase : E2ETestBase, IClassFixture<E2EWebApplicationFactory>
{
    protected E2EWebApplicationFactory Factory { get; }

    protected IntegratedE2ETestBase(E2EWebApplicationFactory factory, ITestOutputHelper output)
        : base(output)
    {
        Factory = factory;
    }

    public override async Task InitializeAsync()
    {
        await base.InitializeAsync();

        // Application is automatically started by WebApplicationFactory
        // Override BaseUrl to use the factory's address
        BaseUrl = "http://localhost:5050";
    }
}
```

## Крім тестування - PuppeteerSharp для генерації та автоматизації PDF

В той час, як E2E тестування блискуче , PuppeteerSharp є швейцарським армейським ножом, який може робити набагато більше МSK2 Однією з його найпопулярніших застосувань є генерація PDF з веб-контенту МСК3 це MСК4 неймовірно корисний для цього М СК5 хоча і не без його купівок M СК6 Якщо ви М סК7 будуєте fakturи М S К 8 звіти M S К 9 або будь-яку систему генерації документів М С К 10 ця частина заощадить вам години від деbugування М Ш К 11

### генерування PDF - Обіцяння і біль

Ідея проста: відтворити веб-сторінку в Chrome і заspeicherти її як PDFM SK1 Чудово для генерації fakturМSK2 звітів МSK3 сертифікатів , або будь-якого динамічного контенту, який треба розповсюджувати у форматі PDF

Ось базовий підхід:

```csharp
public class PdfGeneratorService
{
    public async Task<byte[]> GeneratePdfFromUrlAsync(string url)
    {
        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true,
            Args = new[] { "--no-sandbox", "--disable-setuid-sandbox" }
        });

        await using var page = await browser.NewPageAsync();
        await page.GoToAsync(url, new NavigationOptions
        {
            WaitUntil = new[] { WaitUntilNavigation.Networkidle0 }
        });

        var pdfData = await page.PdfDataAsync(new PdfOptions
        {
            Format = PaperFormat.A4,
            PrintBackground = true,
            MarginOptions = new MarginOptions
            {
                Top = "20mm",
                Right = "20mm",
                Bottom = "20mm",
                Left = "20mm"
            }
        });

        return pdfData;
    }
}
```

Здається дуже простим. МСК0, так, МСК1, добре, МSK2, так і є. МSK3, допоки не стане таким.

### Винайти PDF Generation Gotchas - Що ніхто вам не скаже

#### 1. Font Embedding Nightmares

**Проблема:** Ваші красиві шрифти не з 'являються в PDF.

**Чому це відбувається:** Chrome має доступ до шрифтових файлів під час генерації PDF. Якщо ваші шрифти завантажені за допомогою зовнішнього CDN, і Chrome не може ' дістатися до них M SK2firewallM SK3 проблеми з мережею , налаштування часу MST5 ви M ST6 заповнені МST7

**Рішення:**

```csharp
await page.GoToAsync(url, new NavigationOptions
{
    WaitUntil = new[]
    {
        WaitUntilNavigation.Networkidle0,  // Wait for network to be idle
        WaitUntilNavigation.Load           // Wait for fonts to load
    },
    Timeout = 60000  // Give it time to load fonts
});

// Extra insurance - wait for fonts to actually load
await page.EvaluateFunctionAsync(@"async () => {
    await document.fonts.ready;
}");

var pdfData = await page.PdfDataAsync(new PdfOptions
{
    Format = PaperFormat.A4,
    PrintBackground = true  // CRUCIAL for @font-face fonts
});
```

Ще краще, локалізувати ваші шрифти або вміщувати їх як основуM SK1 у вашій CSS

#### 2. CSS Print Media Queries

**Проблема:** Ваш PDF нічим не схожий на вашу веб-сторінку, тому що Chrome застосовує друковані media queries.

Це насправді **правильне ставлення** - PDF - це надруковані засоби масової інформації

**Рішення:**

Використовувати `@media print` Правила CSS відповідно:

```css
/* Show on screen, hide in PDF */
.no-print {
    display: block;
}

@media print {
    .no-print {
        display: none !important;
    }

    /* Prevent page breaks inside elements */
    .keep-together {
        page-break-inside: avoid;
        break-inside: avoid;
    }

    /* Force page breaks */
    .page-break {
        page-break-before: always;
    }
}
```

Або, якщо ви хочете, щоб екранна версія була у вашому PDF M SK1потрібна для генерації

```csharp
await page.EmulateMediaTypeAsync(MediaType.Screen);  // Force screen media
var pdfData = await page.PdfDataAsync();
```

#### 3. Перерізання сторінок - Загроза існування

**Проблема:** Ваша інформація незграбно розділяється між сторінками, з заголовками сироти внизу або таблицями, вирізьбленими на половинуM SK1

**Реальність:** Ви боретеся з внутрішнім алгоритмом веб-сторінування Chrome, ' і він виграє більшість часу.

**Що ви можете зробити**

```css
@media print {
    h1, h2, h3, h4, h5, h6 {
        page-break-after: avoid;
        break-after: avoid;
    }

    table, figure, img {
        page-break-inside: avoid;
        break-inside: avoid;
    }

    /* Force specific breaks */
    .new-page {
        page-break-before: always;
    }
}
```

І в коді PuppeteerSharp:

```csharp
var pdfData = await page.PdfDataAsync(new PdfOptions
{
    Format = PaperFormat.A4,
    PrintBackground = true,
    PreferCSSPageSize = true,  // Respect CSS @page rules
    DisplayHeaderFooter = false
});
```

**Допомічник :** Для складних макетів , інколи це МSK1 легше структурувати HTML з чіткими відрізками сторінок, ніж боротися з браузером

```html
<div class="page">
    <!-- First page content -->
</div>
<div class="page-break"></div>
<div class="page">
    <!-- Second page content -->
</div>
```

#### 4. Заголовки та літери МSK1 складніше, ніж ви думаєте

Ви можете додати заголовки та стопки,, але інтерфейс API трохи незграбний

```csharp
var pdfData = await page.PdfDataAsync(new PdfOptions
{
    Format = PaperFormat.A4,
    DisplayHeaderFooter = true,
    HeaderTemplate = @"
        <div style='font-size: 10px; text-align: center; width: 100%;'>
            <span class='title'></span>
        </div>
    ",
    FooterTemplate = @"
        <div style='font-size: 10px; text-align: center; width: 100%;'>
            Page <span class='pageNumber'></span> of <span class='totalPages'></span>
        </div>
    ",
    MarginOptions = new MarginOptions
    {
        Top = "30mm",     // Must be larger to accommodate header
        Bottom = "25mm"   // Must be larger to accommodate footer
    }
});
```

**Gotchas:**

- Header/footer templates must be valid HTML but are extremely limited - no external CSS
- Ви отримуєте тільки певні змінні: `date`, `title`, `url`, `pageNumber`, `totalPages`
- Стійлування є тільки в лінії
- Маргіни повинні бути достатньо великими, щоб вмістити заголовки/footers, інакше вониM SK1 перетинають ваш контент

#### 5. Графіка фону

По замовчуванню, Chrome не друкує зображень та кольорів на тліM SK1 МSK2 це по замовченню браузера для збереження олії ). Ви **повинна** ввімкнути його:

```csharp
var pdfData = await page.PdfDataAsync(new PdfOptions
{
    PrintBackground = true  // Without this, your beautiful backgrounds vanish
});
```

#### 6. Похибка пам 'яті з великими документами

**Проблема:** Коли ви генеруєте багато PDF, ваша програма перетворюється на пам ’ ять в кулю і врешті-решт скасується.

**Чому?** Кожна instance веб-браузера використовує значну пам 'ять (100-200MBM SK1 і якщо ви ' не впорядковуєте її правильно МSK3 вони накладаються

**Рішення:**

Повсякчас `await using` або правильного знищення:

```csharp
// Good - automatic disposal
await using var browser = await Puppeteer.LaunchAsync(options);
await using var page = await browser.NewPageAsync();

// Or manually
IBrowser? browser = null;
try
{
    browser = await Puppeteer.LaunchAsync(options);
    // ... use browser
}
finally
{
    if (browser != null)
    {
        await browser.CloseAsync();
        await browser.DisposeAsync();
    }
}
```

Для високого розміру- генерування PDF об 'ємуМSK1 подумайте про повторне використання instanцій браузераM SK2

```csharp
public class PdfGeneratorService : IDisposable
{
    private IBrowser? _browser;
    private readonly SemaphoreSlim _semaphore = new(1, 1);

    public async Task<byte[]> GeneratePdfAsync(string url)
    {
        await _semaphore.WaitAsync();
        try
        {
            // Reuse browser instance
            _browser ??= await Puppeteer.LaunchAsync(new LaunchOptions
            {
                Headless = true
            });

            await using var page = await _browser.NewPageAsync();
            await page.GoToAsync(url);
            return await page.PdfDataAsync();
        }
        finally
        {
            _semaphore.Release();
        }
    }

    public async ValueTask DisposeAsync()
    {
        if (_browser != null)
        {
            await _browser.CloseAsync();
            await _browser.DisposeAsync();
        }
        _semaphore.Dispose();
    }

    public void Dispose()
    {
        DisposeAsync().AsTask().Wait();
    }
}
```

#### 7. Опція масштабування МSK1 Меньший текстM SK2 Більше змісту

Інколи вам потрібно додати більше контенту до сторінки:

```csharp
var pdfData = await page.PdfDataAsync(new PdfOptions
{
    Format = PaperFormat.A4,
    Scale = 0.8m,  // 80% scale - fits more content
    PrintBackground = true
});
```

Але будьте обережні. - надто маленька, і вона ' нерозбірлива МSK2

### Модель генерації PDF у світі

Ось як я роблю генерацію PDF в процесі виробництва.

```csharp
public class InvoicePdfGenerator
{
    private readonly ILogger<InvoicePdfGenerator> _logger;

    public InvoicePdfGenerator(ILogger<InvoicePdfGenerator> logger)
    {
        _logger = logger;
    }

    public async Task<byte[]> GenerateInvoicePdfAsync(Invoice invoice)
    {
        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true,
            Args = new[]
            {
                "--no-sandbox",
                "--disable-setuid-sandbox",
                "--disable-dev-shm-usage"  // Overcome limited resource problems
            }
        });

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

        // Set up console logging to debug issues
        page.Console += (_, e) =>
        {
            _logger.LogInformation("Browser console: {Message}", e.Message.Text);
        };

        try
        {
            // Generate HTML content (using Razor, or however you do it)
            var htmlContent = await GenerateInvoiceHtmlAsync(invoice);

            // Set content directly rather than navigating to URL
            await page.SetContentAsync(htmlContent, new NavigationOptions
            {
                WaitUntil = new[] { WaitUntilNavigation.Networkidle0 }
            });

            // Wait for fonts to load
            await page.EvaluateFunctionAsync("() => document.fonts.ready");

            // Force screen media type to avoid print media queries changing layout
            await page.EmulateMediaTypeAsync(MediaType.Screen);

            // Generate PDF
            var pdfData = await page.PdfDataAsync(new PdfOptions
            {
                Format = PaperFormat.A4,
                PrintBackground = true,
                MarginOptions = new MarginOptions
                {
                    Top = "10mm",
                    Right = "10mm",
                    Bottom = "10mm",
                    Left = "10mm"
                },
                PreferCSSPageSize = false
            });

            _logger.LogInformation("Generated PDF for invoice {InvoiceId}, size: {Size} bytes",
                invoice.Id, pdfData.Length);

            return pdfData;
        }
        catch (Exception ex)
        {
            _logger.LogError(ex, "Failed to generate PDF for invoice {InvoiceId}", invoice.Id);

            // Take a screenshot for debugging
            try
            {
                var screenshot = await page.ScreenshotDataAsync();
                _logger.LogWarning("Captured screenshot of failed PDF generation: {Size} bytes",
                    screenshot.Length);
                // Could save this to blob storage for debugging
            }
            catch
            {
                // Swallow screenshot errors
            }

            throw;
        }
    }

    private async Task<string> GenerateInvoiceHtmlAsync(Invoice invoice)
    {
        // Your HTML generation logic here
        // Could use Razor views, or any templating engine
        return $@"
<!DOCTYPE html>
<html>
<head>
    <meta charset='utf-8'>
    <style>
        @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;600;700&display=swap');

        body {{
            font-family: 'Inter', sans-serif;
            margin: 0;
            padding: 20px;
            color: #333;
        }}

        @media print {{
            .page-break {{
                page-break-before: always;
            }}

            .no-break {{
                page-break-inside: avoid;
            }}
        }}
    </style>
</head>
<body>
    <div class='no-break'>
        <h1>Invoice #{invoice.Number}</h1>
        <p>Date: {invoice.Date:yyyy-MM-dd}</p>
    </div>

    <!-- Invoice content -->
</body>
</html>";
    }
}
```

### Пейзаж проти портрету

Прості, але часто необхідні:

```csharp
var pdfData = await page.PdfDataAsync(new PdfOptions
{
    Format = PaperFormat.A4,
    Landscape = true,  // Horizontal orientation
    PrintBackground = true
});
```

### За замовчанням розміри сторінок

Не обмежується стандартними форматами:

```csharp
var pdfData = await page.PdfDataAsync(new PdfOptions
{
    Width = "210mm",   // Custom width
    Height = "297mm",  // Custom height (this is A4, but you can use any size)
    PrintBackground = true
});
```

## Інші практичние застосування для PuppeteerSharp

Окрім тестування та генерації PDF, PuppeteerSharp excels at several other automation tasks

### Веб Scraping для видобутку даних

PuppeteerSharp чудовий для відскапування JavaScript-важкі сайти, де не вистачає традиційних алгоритмів аналізу HTMLM SK1

```csharp
public class ProductScraper
{
    public async Task<List<Product>> ScrapeProductsAsync(string url)
    {
        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

        await using var page = await browser.NewPageAsync();
        await page.GoToAsync(url, new NavigationOptions
        {
            WaitUntil = new[] { WaitUntilNavigation.Networkidle2 }
        });

        // Wait for products to render (adjust selector as needed)
        await page.WaitForSelectorAsync(".product-item");

        // Extract product data using JavaScript
        var products = await page.EvaluateFunctionAsync<List<Product>>(@"() => {
            return Array.from(document.querySelectorAll('.product-item')).map(item => ({
                name: item.querySelector('.product-name')?.textContent?.trim(),
                price: parseFloat(item.querySelector('.product-price')?.textContent?.replace('£', '')),
                imageUrl: item.querySelector('img')?.src,
                inStock: !item.querySelector('.out-of-stock')
            }));
        }");

        return products;
    }
}
```

**Коли його використовувати:**

- Шрафтування одиночних-заstosowań для сторінок (React, VueM SK3 AngularMSC4
- Сайти з нескінченним перетягуванням або ліницьким завантаженням
- Коли вам потрібно взаємодіяти з сторінкою (клацання кнопокM SK1 заповнювати бланкиМSK2 перед відрізанням
- Поміща за стінами для входу

**Коли його не використовувати:**

- Проста статична HTML відрізання (используйте [HtmlAgilityPack](https://html-agility-pack.net/) або [Викривлення куту](https://anglesharp.github.io/) замість - набагато швидший і легшийM SK1
- Високо-серверування об 'єму МSK1затрата браузера значніM SK2
- Коли доступний API - МСК0, МСК1 - завжди віддають перевагу офіційним API, а не стиранню

### Автоматичне генерування кадрів

Крім тестування, скриншоти корисні для зображень

```csharp
public class ScreenshotService
{
    public async Task<byte[]> CaptureWebsiteAsync(string url, int width = 1920, int height = 1080)
    {
        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

        await using var page = await browser.NewPageAsync();
        await page.SetViewportAsync(new ViewPortOptions
        {
            Width = width,
            Height = height
        });

        await page.GoToAsync(url, new NavigationOptions
        {
            WaitUntil = new[] { WaitUntilNavigation.Networkidle2 }
        });

        // Full page screenshot
        return await page.ScreenshotDataAsync(new ScreenshotOptions
        {
            FullPage = true,
            Type = ScreenshotType.Png
        });
    }

    public async Task<byte[]> CaptureElementAsync(string url, string selector)
    {
        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

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

        var element = await page.WaitForSelectorAsync(selector);
        if (element == null)
        {
            throw new InvalidOperationException($"Element {selector} not found");
        }

        // Screenshot of specific element
        return await element.ScreenshotDataAsync();
    }
}
```

**Практичні застосування:**

- генерування зображень og: для блогових постів
- Створювати thumbnails для галереїв веб-сайтів
- Архивування веб-сторінок для дотримання
- Виробити зображення для демонстрації для обміну інформацією

### Наслідування ефективності

виміряти ефективність завантаження сторінки:

```csharp
public class PerformanceMonitor
{
    public async Task<PerformanceMetrics> MeasurePagePerformanceAsync(string url)
    {
        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

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

        var stopwatch = Stopwatch.StartNew();
        await page.GoToAsync(url, new NavigationOptions
        {
            WaitUntil = new[] { WaitUntilNavigation.Networkidle2 }
        });
        stopwatch.Stop();

        // Get performance metrics from the browser
        var metrics = await page.MetricsAsync();

        // Get performance timing data
        var performanceTiming = await page.EvaluateExpressionAsync<PerformanceTiming>(@"
            JSON.parse(JSON.stringify(performance.timing))
        ");

        return new PerformanceMetrics
        {
            TotalLoadTime = stopwatch.ElapsedMilliseconds,
            DomContentLoaded = performanceTiming.DomContentLoadedEventEnd - performanceTiming.NavigationStart,
            FirstPaint = metrics["FirstPaint"],
            LayoutCount = (int)metrics["LayoutCount"],
            ScriptDuration = metrics["ScriptDuration"]
        };
    }
}
```

### Автоматичне створення звітів

Об 'єднати шаблони HTML з генерацією PDF для автоматизованого звітування:

```csharp
public class MonthlyReportGenerator
{
    public async Task<byte[]> GenerateMonthlyReportAsync(ReportData data)
    {
        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

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

        // Generate HTML report using your preferred templating engine
        var html = GenerateReportHtml(data);
        await page.SetContentAsync(html);

        // Wait for any charts to render (if using Chart.js, D3.js, etc.)
        await Task.Delay(2000);

        return await page.PdfDataAsync(new PdfOptions
        {
            Format = PaperFormat.A4,
            PrintBackground = true,
            DisplayHeaderFooter = true,
            HeaderTemplate = $@"
                <div style='font-size: 9px; margin: 0 auto; text-align: center;'>
                    Monthly Report - {data.Month:MMMM yyyy}
                </div>
            ",
            FooterTemplate = @"
                <div style='font-size: 9px; margin: 0 auto; text-align: center;'>
                    Page <span class='pageNumber'></span> of <span class='totalPages'></span>
                </div>
            ",
            MarginOptions = new MarginOptions
            {
                Top = "25mm",
                Bottom = "20mm",
                Left = "15mm",
                Right = "15mm"
            }
        });
    }
}
```

### Koszt генерації PDF "Free"

Тепер, МСК0 - ось тут, МSK1 - це справа використання PuppeteerSharp для генерації PDF. МСК2 - це МСК3 - це " - безкоштовний МСК5 - в тому сенсі, що ви не платите за ліцензію на бібліотеку для PDF. **не безкоштовні в плані ресурсів**.

Кожна instance браузера:

- Використовує 100-200MB оперативної пам 'яті
- Потрібний значний процесор для відтворення
- Потрібно 2-5 секунд, щоб генерувати PDF МSK1 залежно від складностіM SK2

Порівняйте це з PDF-книгами, такими як:

- **[iText](https://itextpdf.com/)** (ранеше iTextSharpM SK1 - Потребна комерційна ліцензія МSK3рок), але генерує PDF в мілісекунді з крихітним відбитком пам 'яті
- **[КвестPDF](https://www.questpdf.com/)** - Безкоштовний і відкритий вихідний код під ліцензією Массачусетського технологічного інституту
- **[PdfSharpCore](https://github.com/ststeiger/PdfSharpCore)** - Безкоштовна лицензия MIT, але більш обмежена в можливостях

**Коли використовувати PuppeteerSharp для PDF:**

- Ви вже маєте HTML шаблони і не хочете' переписати в PDF кодレイアウトу
- Вам потрібен піксель-perfect rendering of complex web layouts
- Об 'єм нижчий (< МSK1 PDF за годинуM SK2
- Потрібно генерувати PDF з зовнішніх веб-сайтів, які ви не контролюєте

**Коли використовувати dedykowanі PDF бібліотеки:**

- Виготовлення високого об 'єму (> МSK1 PDF за годинуM SK2
- Прості макети (рахункиM SK1 квитанціїMSC2 звіти)
- Ресурс-конstrовані середовища
- Вам потрібні заawansовані PDF funkcje (формиM SK1 підписиМSK2 шифрування)

### Гібридний підхід

Інколи найкращим рішенням є використання обох:

```csharp
public class PdfService
{
    private readonly ILogger<PdfService> _logger;

    public async Task<byte[]> GeneratePdfAsync(PdfRequest request)
    {
        // Simple documents - use QuestPDF (fast, low resources)
        if (request.IsSimpleLayout)
        {
            return GenerateWithQuestPdf(request);
        }

        // Complex documents with web content - use PuppeteerSharp
        return await GenerateWithPuppeteerAsync(request);
    }

    private byte[] GenerateWithQuestPdf(PdfRequest request)
    {
        // QuestPDF code here - much faster for simple layouts
        return Document.Create(container =>
        {
            container.Page(page =>
            {
                page.Size(PageSizes.A4);
                page.Margin(2, Unit.Centimetre);
                page.Content().Text(request.Content);
            });
        }).GeneratePdf();
    }

    private async Task<byte[]> GenerateWithPuppeteerAsync(PdfRequest request)
    {
        // PuppeteerSharp code for complex layouts
        await using var browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true
        });

        await using var page = await browser.NewPageAsync();
        await page.SetContentAsync(request.HtmlContent);
        return await page.PdfDataAsync();
    }
}
```

## Завершення

PuppeteerSharp - це абсолютна гра. МСК0 - змінювач для тестування на E. МSK1 - тестування для E в моїх проектах . - NET. . - це МСК4 - швидший за Селенію, МSK5 - більш сучасний API і МSK6 - просто робить тестування менш обов 'язковою.

Ось що я вам рекомендую:

1. **Почнемо з PuppeteerSharp** якщо ви лише тестуєте Chrome

2. **Використовувати Playwright** якщо вам потрібен мультипліковий-справка браузеромM SK1 це' має всі переваги PuppeteerSharp плюс Firefox і SafariMSC3

3. **Уникніть Selenium** для нових проектів, якщо у вас немає конкретних причин його використовувати. (подібно до IE

4. **Зрозуміло писати тести**. EM SK1E тести повільні і можуть бути нестабільними . Використовуйте їх для важливих польотів з користувачами МSK3 не для перевірки кожного маленького деталя М SK4 Це те, що МСК5 це те, для чого є одиниця та тести на інтеграцію М СК6

5. **Залишити тести ізольованими**. Кожен тест повинен налаштувати власні дані і очистити після себе

6. **Використовуйте методи помічників** ліберально. Pattern базового класу, який я показав, зберігає чистий справжній код тесту і фокусується на тому, що ви тестуєте.

E2E тестування не обов ’ язково боляче ' з потрібними інструментами та схемами МSK3 насправді може бути досить приємним M SK4 Дайте ляльку вправим ваш наступний проект MSC5 Я думаю, ви ' будете приємно здивовані MST7

Гаразд, ЯМSK1 Я не буду писати більше тестівM SK2 Щасливе тестування!

## Дальне читання

- [Дослідження PuppeteerSharp](https://www.puppeteersharp.com/)
- [API для ляльок](https://pptr.dev/) (JavaScriptM SK1 але більшість концепцій застосовуються
- [Playwright для .NET](https://playwright.dev/dotnet/)
- [Документація xUnit](https://xunit.net/)
- [Тести інтеграції з ядром ASP.NET](https://learn.microsoft.com/en-us/aspnet/core/test/integration-tests)