Actions, Auto-waiting và Web-first Assertions

// Click
await page.getByRole('button', { name: 'Lưu' }).click();
await page.getByText('Menu').dblclick();
await page.getByRole('button').click({ button: 'right' }); // chuột phải

// Nhập liệu
await page.getByLabel('Email').fill('a@b.com');     // set thẳng giá trị (nhanh)
await page.getByLabel('Tìm').pressSequentially('abc'); // gõ từng phím (mô phỏng thật)
await page.getByLabel('Mô tả').clear();

// Checkbox / radio
await page.getByLabel('Đồng ý').check();
await page.getByLabel('Đồng ý').uncheck();

// Dropdown <select>
await page.getByLabel('Quốc gia').selectOption('VN');
await page.getByLabel('Quốc gia').selectOption({ label: 'Việt Nam' });

// Bàn phím
await page.getByLabel('Tìm').press('Enter');
await page.keyboard.press('Control+A');

// Hover, focus
await page.getByText('Thông tin').hover();

// Bạn KHÔNG cần viết thế này:
// await page.waitForTimeout(1000);
// Playwright tự chờ nút enabled + visible + stable rồi mới click:
await page.getByRole('button', { name: 'Gửi' }).click();

// ❌ Tệ: chờ cứng 3 giây — chậm nếu app nhanh, fail nếu app chậm hơn
await page.waitForTimeout(3000);

// ✅ Tốt: chờ đúng điều kiện cần
await expect(page.getByText('Tải xong')).toBeVisible();

// Chờ phần tử đạt một trạng thái cụ thể
await page.getByText('Đang tải').waitFor({ state: 'hidden' });
await page.getByRole('dialog').waitFor({ state: 'visible' });

// Chờ điều hướng / URL
await page.waitForURL('**/dashboard');

// Chờ một response mạng cụ thể
await page.waitForResponse(resp =>
  resp.url().includes('/api/orders') && resp.status() === 200
);

// Chờ một sự kiện load
await page.waitForLoadState('networkidle');

// ✅ Đăng ký chờ response TRƯỚC khi click, rồi await cả hai
const responsePromise = page.waitForResponse('**/api/login');
await page.getByRole('button', { name: 'Đăng nhập' }).click();
const response = await responsePromise;
expect(response.status()).toBe(200);

// Timeout cho một action cụ thể
await page.getByRole('button').click({ timeout: 10000 });

// Timeout mặc định cho mọi action (trong config)
use: { actionTimeout: 15000 },

// Timeout của cả test
test.setTimeout(60000);

// Bỏ điều kiện actionability (hiếm khi cần — dùng khi phần tử cố tình bị che)
await page.getByRole('button').click({ force: true });

await page.getByRole('button', { name: 'Thanh toán' }).click();
// Không cần wait — expect tự retry tới khi thông báo hiện ra
await expect(page.getByText('Đặt hàng thành công')).toBeVisible();
await expect(page).toHaveURL(/\/orders\/\d+/);