E2E là tầng kiểm thử duy nhất trả lời được câu hỏi “người dùng có hoàn tất được việc này không”. Nhưng phần lớn bộ E2E không fail vì sản phẩm hỏng — chúng fail vì Task.Delay(3000), selector dựa vào CSS class, và dữ liệu dùng chung giữa các test. Playwright giải quyết được cả ba, với điều kiện bạn dùng nó đúng cách.
Mục lục
Cập nhật 2026
- Microsoft.Playwright 1.64.1 là bản hiện tại; driver và browser binary được version hóa cùng package, không cần quản lý WebDriver riêng.
- Playwright .NET có tích hợp chính thức cho xUnit, NUnit, MSTest. Với xUnit 2.9.3 dùng
Microsoft.Playwright.Xunit; xUnit v3 là dòng package khác, kiểm tra gói tương ứng trước khi trộn. - Cypress vẫn là runner JavaScript. Với .NET, nó nghĩa là bạn phải viết test bằng JS/TS và không gọi được code C# trong test. Playwright .NET cho bạn cùng ngôn ngữ với ứng dụng.
- .NET 8/9 hết hỗ trợ 2026-11-10; E2E thường là project bị bỏ quên cuối cùng khi nâng cấp.
Cài đặt: package, browser, project
Dùng một project test riêng, tách khỏi unit test. E2E chạy chậm, cần browser và cần ứng dụng đang chạy; trộn vào project unit sẽ khiến vòng lặp phát triển hàng ngày chậm đi.
dotnet new classlib -n Shop.E2ETests -f net10.0
cd Shop.E2ETests
dotnet add package Microsoft.Playwright.Xunit --version 1.64.1
dotnet add package xunit --version 2.9.3
dotnet add package xunit.runner.visualstudio
dotnet add package Microsoft.NET.Test.Sdk
# Sau khi build, script playwright.ps1 được sinh trong thư mục output
dotnet build
pwsh bin/Debug/net10.0/playwright.ps1 install --with-deps
Trên Linux CI, --with-deps cài thêm thư viện hệ thống mà Chromium cần; trên Windows bỏ cờ này. Browser được tải vào ~/.cache/ms-playwright (Linux) hoặc thư mục cache tương ứng — cache thư mục đó theo version Playwright trong pipeline, đừng cài lại mỗi job.
Không cần khai báo playwright.json cho project .NET. Cấu hình chạy (headless, timeout, base URL) đi qua biến môi trường và option của từng lần gọi, nên nó nằm ngay trong code review được.
Test đầu tiên: PageTest và Expect
PageTest tạo một browser context và một page mới cho mỗi test, rồi dọn sạch sau đó. Đây là mức cô lập mặc định, rẻ hơn nhiều so với mở browser mới cho từng test.
// File: Shop.E2ETests/CheckoutTests.cs
using Microsoft.Playwright;
using Microsoft.Playwright.Xunit;
namespace Shop.E2ETests;
public sealed class CheckoutTests : PageTest
{
private static string BaseUrl =>
Environment.GetEnvironmentVariable("E2E_BASE_URL") ?? "http://127.0.0.1:5080";
[Fact]
public async Task Checkout_WithItemInCart_ShowsConfirmation()
{
await Page.GotoAsync($"{BaseUrl}/cart");
await Page.GetByRole(AriaRole.Button, new() { Name = "Thanh toán" })
.ClickAsync();
await Expect(Page).ToHaveURLAsync($"{BaseUrl}/checkout/confirm");
await Expect(Page.GetByTestId("order-status")).ToHaveTextAsync("Đã xác nhận");
}
}
Expect(...) không phải assert một lần. Nó retry cho tới khi điều kiện đúng hoặc hết timeout, và đó là toàn bộ khác biệt giữa một suite ổn định và một suite flaky. Vì vậy đừng viết Assert.Equal("Đã xác nhận", await locator.TextContentAsync()) — bạn vừa tự tay bỏ đi cơ chế chờ mạnh nhất của Playwright.
Auto-waiting: nó chờ cái gì
Trước khi click, Playwright kiểm tra phần tử đã visible, stable (không còn animation), nhận được event (không bị phần tử khác che), enabled và editable nếu là input. Nếu một điều kiện chưa đạt, nó chờ và thử lại thay vì fail ngay. Đó là lý do các lệnh như ClickAsync() không cần sleep.
Nhưng auto-wait không biết nghiệp vụ. Nếu màn hình hiển thị “Đang xử lý…” trong khi dữ liệu còn đang tải, hãy chờ đúng trạng thái cuối:
await Expect(Page.GetByTestId("order-status"))
.ToHaveTextAsync("Đã xác nhận", new() { Timeout = 15_000 });
Dùng timeout theo từng assertion cho trường hợp đã biết là chậm (upload file, gọi dịch vụ ngoài). Đừng nâng timeout toàn cục để che vấn đề hiệu năng — nếu một luồng cần hơn 30 giây, đó là thông tin về sản phẩm, không phải về test.
Chọn selector theo thứ tự ưu tiên
GetByRole đứng đầu vì nó bám vào thứ người dùng thấy và đồng thời kiểm tra accessibility: nếu test không tìm thấy nút theo role, screen reader cũng có thể không thấy. Sau đó là GetByLabel và GetByPlaceholder cho form, rồi GetByTestId khi không có role hay label ổn định. Tránh Locator("div.cart > button.primary"): nó gắn test với cấu trúc DOM, và một lần đổi layout là cả suite đỏ dù hành vi không đổi.
Nếu team dùng data-testid, hãy coi đó là hợp đồng giữa UI và test: thống nhất tiền tố, không đổi tên tùy tiện, và không dùng test id để che một UI thực sự không có label. Một test id tốt là thứ không bao giờ xuất hiện trong giao diện người dùng.
Tái sử dụng trạng thái đăng nhập
Đăng nhập qua UI trong mỗi test là cách nhanh nhất để có một suite chậm và flaky. Đăng nhập một lần, lưu storageState (cookie + localStorage), rồi tạo context mới với state đó. File state phải nằm trong .gitignore — nó chứa token thật.
// File: Shop.E2ETests/AuthState.cs
public static class AuthState
{
public const string FilePath = "auth.json";
public static async Task EnsureAsync(IPlaywright playwright, string baseUrl)
{
if (File.Exists(FilePath)) return;
await using var browser = await playwright.Chromium.LaunchAsync();
await using var context = await browser.NewContextAsync(new() { BaseURL = baseUrl });
var page = await context.NewPageAsync();
await page.GotoAsync("/login");
await page.GetByLabel("Email").FillAsync("buyer@example.com");
await page.GetByLabel("Mật khẩu").FillAsync("Test123!");
await page.GetByRole(AriaRole.Button, new() { Name = "Đăng nhập" }).ClickAsync();
await page.WaitForURLAsync("**/account");
await context.StorageStateAsync(new() { Path = FilePath });
}
}
Trong test, tạo context với StorageStatePath = AuthState.FilePath. Mỗi context vẫn độc lập: cookie của test A không sang test B, dù cùng xuất phát từ một state. Đó chính là thứ bạn muốn — cùng danh tính, khác phiên.
Cô lập dữ liệu, không chỉ cô lập browser
Browser context sạch không cứu được test nếu hai test cùng tạo đơn hàng cho một tài khoản và cùng đọc “đơn hàng mới nhất”. Ba quy tắc thực dụng:
- Dữ liệu riêng cho mỗi test. Sinh email/số đơn bằng GUID trong Arrange, không dùng tài khoản demo dùng chung.
- Seed qua API, không qua UI. Gọi endpoint test-only hoặc API thật để tạo dữ liệu nền; UI chỉ dùng cho hành vi đang kiểm thử.
- Không phụ thuộc thứ tự. Mỗi test phải chạy được một mình. Nếu chỉ pass khi chạy cả suite, test đang đọc state của test khác.
Với dữ liệu lớn, chạy mỗi test class trên một database riêng (container) hoặc một schema riêng; đừng chia sẻ một database staging cho toàn bộ suite song song.
Trace khi fail
Trace là công cụ debug hiệu quả nhất của Playwright: nó ghi snapshot DOM, network, console và từng action. Bật trace theo từng test và chỉ giữ file khi fail — nếu bật cho mọi test và giữ tất cả, artifact CI sẽ phình rất nhanh.
await Context.Tracing.StartAsync(new()
{
Screenshots = true,
Snapshots = true,
Sources = true
});
try
{
// thân test
}
finally
{
await Context.Tracing.StopAsync(new() { Path = "trace.zip" });
}
Mở bằng playwright show-trace trace.zip (CLI Node hoặc Microsoft.Playwright.CLI). Trong CI, upload trace.zip làm artifact khi job fail; giữ 7–14 ngày là đủ.
CI: browser, sharding, retry
Ba điều dễ sai trong pipeline .NET:
- Cài browser sau build, không trước. Script
playwright.ps1chỉ tồn tại sau khi project được build. - Sharding không có sẵn.
--shardlà cờ của Playwright test runner bản Node, không phải củadotnet test. Với .NET, chia bằng trait và nhiều job ma trận:dotnet test --filter "Category=Checkout", job khácCategory=Account. Mỗi job cần database riêng. - Retry không có sẵn. Cấu hình
retriescủa Playwright thuộc runner JS. Với .NET, retry đến từ framework test (NUnit có[Retry], MSTest có cơ chế tương tự) hoặc từ việc chạy lại job. Retry che flakiness, nên chỉ dùng như biện pháp tạm và phải log lại test nào đã retry.
- uses: actions/checkout@v4
- uses: actions/setup-dotnet@v4
with:
dotnet-version: "10.0.x"
- run: dotnet build -c Release
- run: pwsh Shop.E2ETests/bin/Release/net10.0/playwright.ps1 install --with-deps
- run: dotnet test Shop.E2ETests -c Release --filter "Category=Checkout"
Nguyên nhân flaky thật sự
| Triệu chứng | Nguyên nhân | Cách sửa |
|---|---|---|
| Pass local, fail CI | Màn hình nhỏ hơn, font khác, múi giờ khác | Cố định viewport, locale, timezone trong context |
| Fail ở test thứ 5 | Dữ liệu dùng chung, thứ tự test | Dữ liệu theo GUID, seed qua API |
| Fail 1/20 lần | Animation hoặc request chậm | Assert trạng thái cuối, không sleep |
| Fail sau khi đổi CSS | Selector bám cấu trúc DOM | GetByRole, GetByLabel, GetByTestId |
| Fail khi chạy song song | Tranh chấp tài nguyên, cùng bản ghi | Database/schema riêng theo worker |
Một nguyên tắc: nếu bạn phải tăng timeout để test pass, hãy tìm hiểu cái gì chậm trước. Timeout chỉ là thuốc giảm đau, và nó làm suite chậm hơn khi fail.
Playwright hay Cypress cho .NET
| Tiêu chí | Playwright .NET | Cypress |
|---|---|---|
| Viết test bằng C# | Có, API async tự nhiên | Không, chỉ JS/TS |
| Đa trình duyệt | Chromium, Firefox, WebKit | Chromium, Firefox, Edge; không có WebKit/Safari |
| Debug | Trace Viewer, snapshot từng action | Time-travel, DX rất tốt cho front-end |
| Chạy song song | Context nhẹ, song song theo test | Cần cấu hình riêng, tốn tài nguyên hơn |
Cypress không yếu — nó có UX debug tốt và cộng đồng front-end lớn. Nhưng nếu team của bạn là .NET và muốn test gọi vào code C#, Playwright là lựa chọn duy nhất trong hai đáp án này.
Chạy trên ứng dụng ASP.NET Core thật
Playwright cần một URL thật. Cách đơn giản và đáng tin nhất: chạy ứng dụng như một process riêng, rồi trỏ test vào đó bằng biến môi trường.
dotnet run --project src/Shop.Web --urls http://127.0.0.1:5080 &
E2E_BASE_URL=http://127.0.0.1:5080 dotnet test Shop.E2ETests
WebApplicationFactory mặc định dựng TestServer in-memory — Playwright không kết nối được vì không có socket. Nếu bạn muốn giữ một lệnh dotnet test duy nhất, có thể override CreateHost để dựng thêm một host Kestrel thật trên cổng ngẫu nhiên:
public sealed class PlaywrightFactory : WebApplicationFactory<Program>
{
public string BaseUrl { get; private set; } = "";
protected override IHost CreateHost(IHostBuilder builder)
{
var testHost = builder.Build(); // host cho TestServer
builder.ConfigureWebHost(webHost =>
{
webHost.UseKestrel();
webHost.UseUrls("http://127.0.0.1:0");
});
var host = builder.Build(); // host thật cho browser
host.Start();
var server = host.Services.GetRequiredService<IServer>();
BaseUrl = server.Features.Get<IServerAddressesFeature>()!.Addresses.First();
testHost.Start();
return testHost;
}
}
Cách này dựng ứng dụng hai lần và tạo hai DI container, nên chỉ dùng khi ứng dụng không giữ state trong bộ nhớ. Với hầu hết dự án, chạy process riêng rõ ràng hơn và ít bất ngờ hơn.
Nhìn sang 2027
.NET 11 dự kiến GA trong tháng 11/2026 (STS); production vẫn nên ở .NET 10 LTS. Với E2E, hướng đang đi là chia test theo rủi ro nghiệp vụ thay vì chạy toàn bộ mọi lần commit: smoke trên mỗi PR, full suite theo lịch hoặc trước release. AI hỗ trợ sinh selector và test từ recording cũng đang phổ biến, nhưng test sinh tự động vẫn cần người viết lại assertion — máy không biết điều gì là quan trọng với nghiệp vụ.
Checklist
- Project E2E riêng, pin
Microsoft.Playwright.Xunit1.64.1 vàxunit2.9.3. - Cài browser trong CI bằng
playwright.ps1 install --with-deps, cache thư mục browser. - Dùng
ExpectvàGetByRole/GetByTestId; không sleep, không selector CSS dài. - Lưu và tái sử dụng
storageStatecho luồng đã đăng nhập. - Mỗi test có dữ liệu riêng; seed qua API; không phụ thuộc thứ tự.
- Bật trace, upload artifact khi fail; chia shard bằng trait nếu suite dài.
Nếu bạn chưa có tầng bên dưới, đọc Kiểm thử tích hợp với WebApplicationFactory và chọn framework unit test cho .NET. Nếu luồng của bạn cần mô tả bằng ngôn ngữ nghiệp vụ trước, xem BDD với Reqnroll; dữ liệu cho E2E có thể lấy từ AutoFixture và Bogus.



