Називайте кроки за питанням, на яке вони відповідають.

Звіт каже Крок 1 успішний, Крок 2 успішний, Крок 3 невдалий. Порядок збережено, сенсу мало. Інший каже Успішно збережено, хоча код лише натиснув кнопку. Назва обіцяє неперевірений висновок.

Посібник використовує API Playwright Test для вигаданої локальної настройки. Немає акаунта чи сервера. Межі звіту мають відповідати питанням коду, не перетворювати слова на докази.

Дайте кожному кроку перевірне питання

test.step групує дії під назвою. Ім'я пояснює намір, а перевірка лишається всередині. Прочитати поточну настройку чесніше, ніж Збережено назавжди при перегляді сторінки.

await test.step('Read the current demo preference', async () => {
  await expect(page.getByRole('status')).toHaveText('Demo preference: off');
});
await test.step('Enable the local demo preference', async () => {
  await page.getByRole('button', { name: 'Enable demo preference' }).click();
  await expect(page.getByRole('status')).toHaveText('Demo preference: on');
});

Потрібні приклад та імпортовані test і expect. Перевіряються локальний початковий і змінений стани, не серверне зберігання. Назва, кроки й знімок мають зберігати межу.

Відділіть підготовку від доказів

Відкриття готує. Читання початкового стану дає доказ. Клік діє, читання нового стану дає інший доказ. Загальне Завершити настройку приховує зміну питання.

Занадто дрібні кроки також заважають. Кожен локатор не потребує окремого кроку. Групуйте за корисним питанням, не рядками чи бажаним числом.

Вкладеність може показувати ієрархію, але не ховайте перевірки за нечіткими назвами. Оглядач має знайти їх без ланцюга Підготувати, Обробити, Завершити.

Повертайте потрібне наступному кроку

API описує повернення результату callback із test.step. Це тримає контрольований ідентифікатор біля джерела. Передавайте потрібне, не створюйте прихований глобальний склад стану.

Перевіряйте значення. Наявний об'єкт не доводить правильність запису. Назвіть походження й перевірки сенсу. Використовуйте дозволені дані без приватних назв у публічних заголовках.

Перевірте звіт локально

Два кроки перевіряють початковий і змінений стани. Контрольований знімок показує локальний результат. Успіх не доводить віддаленого зберігання. Фільм пояснює структуру, не записує клієнтський процес.

При збої назва допомагає знайти питання, не замінює деталі. Читайте перевірку й контекст. Не кожна дія успішного кроку перевірена окремо. Самі кліки можуть пройти без доказу результату.

Перевіряйте назви й код разом

Правило коротке: назва задає питання, тіло містить дію та перевірку, область чесна. Оновлюйте назви при змінах. Старий напис може вводити в оману за правильного, але вужчого коду.

AnyTest описує дослідження й тести для огляду. Запитайте, чи назви відповідають доказам. Формат кроків AnyTest не заявляється. Назви полегшують читання, перевірки несуть доказ.

Походження повернутого ідентифікатора має бути видимим. Сам факт існування об’єкта не встановлює правильність запису. Наступний крок отримує лише потрібне значення та перевіряє його сенс. Це не перетворює межу кроку на прихований склад стану. Якщо тіло містить самі кліки, успішна назва може обіцяти результат, який жодна перевірка не підтвердила.