Playwright Test Runner: test, expect, hooks và annotations

import { test, expect } from '@playwright/test';

test('hiển thị tiêu đề trang chủ', async ({ page }) => {
  await page.goto('/');
  await expect(page).toHaveTitle(/My App/);
});

test.describe('Trang đăng nhập', () => {
  test('đăng nhập thành công', async ({ page }) => { /* ... */ });
  test('báo lỗi khi sai mật khẩu', async ({ page }) => { /* ... */ });
});

test.describe('Giỏ hàng', () => {
  test.beforeAll(async () => {
    // chạy một lần trước tất cả test trong nhóm — seed dữ liệu chung
  });

  test.beforeEach(async ({ page }) => {
    // chạy trước MỖI test — ví dụ điều hướng tới trang
    await page.goto('/cart');
  });

  test.afterEach(async ({ page }, testInfo) => {
    // dọn dẹp sau mỗi test; testInfo cho biết kết quả
    if (testInfo.status !== testInfo.expectedStatus) {
      console.log(`Test thất bại: ${testInfo.title}`);
    }
  });

  test.afterAll(async () => {
    // dọn dẹp một lần sau cùng
  });
});

// Tự đợi phần tử hiện ra rồi mới kiểm tra — không cần wait riêng
await expect(page.getByRole('alert')).toBeVisible();
await expect(page.getByTestId('total')).toHaveText('1.250.000đ');
await expect(page.getByRole('listitem')).toHaveCount(3);

// ❌ Chụp giá trị NGAY lập tức — dễ fail nếu UI chưa cập nhật
const count = await page.getByRole('listitem').count();
expect(count).toBe(3);

// ✅ Tự retry tới khi đủ 3 phần tử hoặc timeout
await expect(page.getByRole('listitem')).toHaveCount(3);

await expect.soft(page.getByTestId('name')).toHaveText('Chung');
await expect.soft(page.getByTestId('email')).toHaveText('a@b.com');
await expect.soft(page.getByTestId('role')).toHaveText('Admin');
// Test vẫn chạy hết; cuối cùng đánh dấu fail nếu có soft assertion sai

await expect(page.getByText('Đang xử lý...')).toBeHidden({ timeout: 15000 });

test.skip('tính năng chưa làm', async ({ page }) => {});
test.fixme('đang lỗi, sẽ sửa sau', async ({ page }) => {});

// Có điều kiện
test('chỉ chạy trên chromium', async ({ page, browserName }) => {
  test.skip(browserName !== 'chromium', 'Chỉ áp dụng cho Chromium');
  // ...
});

// Báo cho runner biết test này vốn chậm → nhân đôi timeout
test('upload file lớn', async ({ page }) => {
  test.slow();
  // ...
});

// test.fail: test này ĐANG được kỳ vọng sẽ fail (bug đã biết)
test('bug #123 chưa fix', async ({ page }) => {
  test.fail();
  // ...
});

test.only('chỉ chạy test này', async ({ page }) => {});

test('thanh toán @smoke @critical', async ({ page }) => {});

test.describe('Báo cáo', { tag: '@slow' }, () => {
  test('xuất Excel', async ({ page }) => {});
});

npx playwright test --grep @smoke
npx playwright test --grep-invert @slow   # bỏ qua test gắn @slow

const users = [
  { role: 'admin', canDelete: true },
  { role: 'editor', canDelete: false },
];

for (const u of users) {
  test(`quyền xóa của ${u.role}`, async ({ page }) => {
    // ... kiểm tra theo u.canDelete
  });
}