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

This is a viewer only at the moment see the article on how this works.

To update the preview hit Ctrl-Alt-R (or ⌘-Alt-R on Mac) or Enter to refresh. The Save icon lets you save the markdown file to disk

This is a preview from the server running through my markdig pipeline

E2E Testing PuppeteerSharp Testing xUnit

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

Thursday, 27 November 2025

Сучасний E2E M SK1End-ToMSC3End+, використовуючи ваш сайт так, як це роблять użytkownicy, тестування не обов 'язково буде болісним.. Цей цілковитий інструкт показує вам, як використовувати PuppeteerSharp для швидкого тестування. , надійна автоматизація браузера в МSK9 NETМSK10 об' єднання всього від базового тестування до генерації PDF і веб-шкрапування. Рухівник драматурга замість.

Введение

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

Ввести Шарп ляльок - порт МSK1NET GoogleM SK2s Ляльковий театр bibliotekа. Це ' схоже на Selenium' молодшийM SK3 швидший двоюрідний брат, який справді намагається з 'являтися вчасно і не вимагає, щоб ви завантажували сімнадцять різних драйверів браузеруMSC5

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

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

Шарп ляльок це bibliotekа .NET, що надає високу API - для управління браузерами Chrome або Chromium, використовуючи Протокол DevTools Chrome. На відміну від Селен,, що використовує Протокол WebDriver ( досить заплутаний HTTP -забудований JSON дротий протокол M SK2 PuppeteerSharp спілкується безпосередньо з браузером через DevTools .

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

  • Селен: Як надсилати листи по почті, щоб спілкуватися з вашим браузером
  • Шарп ляльок: Як мати прямий телефонний зв 'язок з браузером
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, ось як воно насправді працює в практиці.

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Відреагувати, Ву, У куті) там, де інтерфейс інтерфейсу відтворюється - 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 у контексті сторінки і отримаєте результати таким чином, що не змусить вас плакати

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

Спочатку, додайте Шарп ляльок NuGet пакет:

dotnet add package PuppeteerSharp

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

<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 (ASP.NET Core's defaultM SK3 але PuppeteerSharp працює так само добре з NUnit або Тест на MS.

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

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

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

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 з xUnit, що надає асинкову налаштуванняM SK1teardown. На відміну від традиційних конструйторів , це дає нам змогу правильно чекати інициалізації браузераMSC4

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

    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

    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):

// 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):

[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 працює правильно.

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

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

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

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

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 здебільшого (серверMostlylucid.Test/E2E/FilterBarTests.cs:98-126):

[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):

[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

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();
    }
};

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

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

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 сторонне відображання чи друкування таблиць стилю:

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

Кодування

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

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 накладається на інші інструменти тестування.

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.

Гравця

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

Гравця Microsoft' відповість на Puppeteer, з .NET запечено з самого початку. Це ' по суті 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

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

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

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:

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 тести можуть бути схвильованими - вони іноді проходять, а інші - провалюються.

Поганий:

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

Добре:

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

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

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

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

Поганий:

[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");
}

Добре:

[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
}

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

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

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

[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

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

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

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 для перегляду браузера в дії:

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

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

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

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

Запис konsolі

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

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

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

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

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

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

[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", "[email protected]");
    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());
}

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

[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);
}

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

[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

[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 для більш інтегрованого тестування:

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

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

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

Рішення:

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 відповідно:

/* 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потрібна для генерації

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

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

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

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

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

@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:

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

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

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

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

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

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 це по замовченню браузера для збереження олії ). Ви повинна ввімкнути його:

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

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

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

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

Рішення:

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

// 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

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 Більше змісту

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

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

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

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

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

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>";
    }
}

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

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

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

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

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

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

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 або Викривлення куту замість - набагато швидший і легшийM SK1
  • Високо-серверування об 'єму МSK1затрата браузера значніM SK2
  • Коли доступний API - МСК0, МСК1 - завжди віддають перевагу офіційним API, а не стиранню

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

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

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 для галереїв веб-сайтів
  • Архивування веб-сторінок для дотримання
  • Виробити зображення для демонстрації для обміну інформацією

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

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

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 для автоматизованого звітування:

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 (ранеше iTextSharpM SK1 - Потребна комерційна ліцензія МSK3рок), але генерує PDF в мілісекунді з крихітним відбитком пам 'яті
  • КвестPDF - Безкоштовний і відкритий вихідний код під ліцензією Массачусетського технологічного інституту
  • 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 шифрування)

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

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

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 Щасливе тестування!

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

logo

© 2026 Scott Galloway — Unlicense — All content and source code on this site is free to use, copy, modify, and sell.