Як зберегти тести спільних ресурсів у безпеці, водночас використовуючи паралелізм Playwright
1. Чому «паралельний» не завжди є «безпечним»
Стандартний тестовий раннер Playwright виконує файли паралельними робочими системами і всередині кожного файлу виконує тести одночасно, коли fullyParallel увімкнено. Це дає значне прискорення CI, але також передбачає, що кожен тест є ізольованим — тобто не залежить від змінного зовнішнього стану, який може торкнутися іншого тесту одночасно.
Типові неізольовані сценарії включають:
| Спільний ресурс | Типовий конфлікт |
|---|---|
| Один тестовий акаунт на зовнішньому SaaS-сервісі | Одночасна зміна пароля, очищення даних |
| Середовище пісочниці з обмеженням швидкості | Перевищення квот запитів |
| Глобальні конфігураційні файли, написані тестами | Перезаписує, що пошкоджені пізніше запускаються |
| Тестові дані, що зберігаються у спільній базі даних | Одночасні вставки/оновлення спричиняють нестабільні читання |
Коли такі ресурси отримують без координації, тести стають нестабільними, і CI-конвеєри втрачають надійність. Історично обхідним шляхом було позначати весь набір (або цілий файл) як serial, що гарантує, що жоден тест не запускається одночасно. Недоліком є те, що весь набір втрачає паралелізм, збільшуючи час виконання.
Playwright 1.63 вводить іменовані тестові блокування для усунення цієї прогалини. Блокування дозволяє оголосити іменний ресурс, який має бути ексклюзивним, тоді як усі інші тести продовжують виконувати паралельно. Ця функція працює між файлами, робочими процесами та проєктами — саме на межах, де раніше виникали проблеми з конкурентністю.
> Офіційна поведінка — Playwright отримує всі блокування тесту до його запуску та звільняє їх після завершення. У стандартному та послідовному режимах блокування, оголошене для будь-якого тесту, утримується протягом виконання всього файлу; за повністю паралельного запуску воно стосується окремого тесту. (Документація Playwright про Test Locks)
У решті цієї статті пояснюється, як правильно використовувати замки, як вони взаємодіють із працівниками та проєктами, а також як розробити прагматичну стратегію контролю якості (QA), яка дозволяє уникнути глухих кутів, зберігаючи більшість паралельного прискорення.
2. Три базові підходи
| Підхід | Паралелізм | Гарантія ізоляції | Типовий випадок використання |
|---|---|---|---|
| Ізольовані тести (без спільного стану) | Повна паралель між працівниками, файлами та проєктами | Кожен тест виконується незалежно; координація не потрібна | Чисто одиничні UI-тести |
Повністю серіальна сьюта (test.describe.configure({ mode: 'serial' })) | Немає паралелізму всередині файлу; файли все одно працюють паралельно у робочих точках | Гарантує, що будь-які два тести у файлі ніколи не перекриватимуться | Застарілі пакети, які базуються на глобальному браузері або спільній базі даних |
| Вузькодіапазонні замки (нові у версії 1.63) | Паралелізм зберігається для всіх тестів, які не мають однакове ім'я замка | Серіалізовані лише тести, які оголошують однакове ім'я замків; інші виконуються одночасно; | Тести, які потребують одного тестового акаунта, пісочниці з обмеженням швидкості або глобального конфігураційного файлу |
Підхід із блокуванням — це золота середина для більшості команд: ви зберігаєте швидкий стандартний паралелізм і серіалізуєте лише мінімальний набір тестів, які справді конфліктують.
3. Оголошення замків – синтаксис і сфера застосування
3.1 На рівні тесту
import { test, expect } from '@playwright/test';
test('create user in shared sandbox', { lock: 'sandbox-A' }, async ({ page }) => {
// The lock name "sandbox‑A" is acquired before the test starts.
// No other test that also asks for "sandbox‑A" will run concurrently.
await page.goto('https://example.com/signup');
// …
});Ім’я блокування задається в об’єкті параметрів тесту:
test('update shared account', { lock: 'shared-account' }, async ({ page }) => {
// Тест запускається лише після звільнення іменованого блокування.
// …
});Коли fullyParallel off (за замовчуванням), блокування утримується для всього файлу, оскільки тестовий раннер розглядає файл як єдину одиницю. Коли fullyParallel on, блокування утримується лише протягом індивідуального тесту.
3.2 На рівні test.describe
Якщо ціла група тестів потребує одного й того ж ексклюзивного ресурсу, ви можете оголосити блокування один раз:
test.describe('Operations on shared sandbox A', () => {
test.describe.configure({ lock: 'sandbox‑A' });
test('reset sandbox', async ({ page }) => {
// lock already acquired
// …
});
test('run migration script', async ({ page }) => {
// same lock, same exclusivity guarantee
// …
});
});Усі тести всередині describe успадковують ім'я замка, що спрощує обслуговування.
3.3 Множинні замки
Тест може запросити більше ніж одне блокування, передаючи масив:
test('reset the database', { lock: ['sandbox-A', 'shared-account'] }, async () => {
// …
});Playwright отримує всі запитані блокування до запуску тесту та звільняє їх після завершення. Документація не визначає порядок отримання або справедливість черги, тому тести й QA-політика не повинні від них залежати.
4. Правила найменування – збереження керованого простору замків
Оскільки імена замків є глобальними протягом усього тестового запуску, дисциплінована схема іменування запобігає випадковим зіткненням:
| Рекомендація | Приклад |
|---|---|
| Префікс до типу ресурсу | account‑admin, sandbox‑us‑east |
| Використовуйте кебабний футляр (Playwright розглядає імена як струнки) | sandbox‑a |
| Тримайте імена короткими, але описовими | rate‑limit‑api |
| Документуйте карту замків у спільному README | (див. план міграції) |
Чітка карта дозволяє новим учасникам легко зрозуміти, які тести не повинні працювати разом.
5. Взаємодія з воркерами, проєктами та шардингом CI
5.1 Воркери
Playwright виконує тести в налаштовуваній кількості робочих процесів. Блокування діють між робочими процесами: якщо процес 1 утримує sandbox‑A, процес 2 очікує перед запуском іншого тесту з тим самим блокуванням. Ця гарантія забезпечує безпечний паралелізм.
5.2 Проєкти
Проєкти — це окремі конфігурації (наприклад, Chrome проти Firefox). Блокування також є глобальним у різних проєктах. Тест у chromium проєкті, який блокує shared‑account, блокує однойменний тест у проєкті firefox до моменту звільнення блокування. Це запобігає одночасному мутації двома браузерами одного й того ж зовнішнього акаунта.
5.3 Шардинг CI
CI-системи часто розбивають тестовий набір на шарди, які працюють на різних агентах. Реалізація блокування Playwright є process-local; вона не координується між окремими CI-машинами. Отже, блокування гарантує ексклюзивність всередині одного CI-завдання. Якщо спільний ресурс дійсно не може бути одночасно доступний між агентами, ви повинні або:
- Виділяти окремі ресурси на кожен шард (наприклад, окремі тестові облікові записи), або
- Використовуйте власний зовнішній сервіс замків (поза межами вбудованої функції Playwright).
У статті не стверджується розподілене блокування між CI-машинами, оскільки офіційна документація цього не гарантує.
6. Практичні питання
6.1 Тайм‑аут
Playwright не виявляє тайм-аут, специфічний для блокування. Якщо тест не може отримати свій блок через застряг іншого тесту, тест очікування просто залишиться в черзі до моменту зняття блокування. На практиці це може призвести до того, що загальний набір може перевищити тайм-аут CI. Стратегії пом'якшення:
- Тримайте критичний розділ (код, який потребує замка) якомога коротшим.
- Додайте явну
testInfo.setTimeout()до самого тесту, щоб зафіксований блок призведе до провалу тесту, а не затягування протягом усього запуску.
6.2 Відновлення після відмови
Playwright звільняє блокування після завершення тесту та завершує робочий процес після помилки тесту. Водночас зовнішній стан може залишитися пошкодженим (наприклад, частково оновлений обліковий запис), тому наступні тести все одно можуть завершитися помилкою. Рекомендовано:
- Використовуйте
test.afterEachабоtest.afterAllгачки, щоб очистити спільний ресурс навіть якщо тест провалився. - Розглянемо тест «скидання», який виконується на початку кожного завдання CI, щоб повернути ресурс до відомого базового рівня.
6.3 Спостережуваність
Офіційна документація описує поведінку блокувань, але не надає телеметрію їх отримання. Тому часові дані слід збирати як власну командну інструменталізацію:
- записувати ідентифікатор тесту та заявлений спільний ресурс;
- фіксувати час початку й завершення в CI-журналах або власному репортері;
- порівнювати тести з однаковим блокуванням із незалежними тестами.
Такі дані допомагають виявити зайве очікування без тверджень про недокументовану внутрішню реалізацію раннера.
6.4 Запобігання глухому куту
Playwright очікує доступності всіх запитаних блокувань до запуску тесту. Тому наступна командна політика призначена для обмеження конкуренції та зручності перевірки:
- Правило 1 — за можливості не більше двох блокувань на тест; винятки документуються та проходять рев’ю.
- Правило 2 — блокування, які часто використовуються разом, документуються як одна перевірена група.
- Правило 3 — використовуйте канонічні імена ресурсів і не створюйте псевдоніми для одного спільного ресурсу.
Ці правила зберігають реєстр блокувань компактним і зрозумілим.
7. Вигляд архітектури та потоків даних
Тестові файли → параметри блокувань → координація раннера → робочий процес → результат тесту
- Входи — тестові файли, параметри
{ lock: … }, конфігурація Playwright (fullyParallel,projects). - Вихідні – Результати тестів (пройшов/провал), необов'язкові журнали блокування та будь-які побічні ефекти для спільного ресурсу.
Схема концептуально показує документований контракт: Playwright координує іменовані блокування між робочими процесами та проєктами до запуску тесту.
8. Контрольний список розробки тестів
| Категорія | Що перевірити |
|---|---|
| Позитивно | Тест, який оголошує блокування sandbox‑A успішно виконується, коли жоден інший тест не має такого блокування. |
| Негативно | Два тести, які обидва запитують sandbox‑A ніколи не перетинаються; другий тест починається лише після завершення першого. |
| Паралельність | Тести з різними іменами блокування (sandbox‑A проти sandbox‑B) виконуються паралельно, навіть якщо виконуються на одному й тому ж пулі працівників. |
| Тайм-аут | Для навмисно повільного тесту задається явний тайм-аут; очищення та відновлення зовнішнього стану перевіряються окремо. |
| CI шардинг | Коли пакет розділяється на два шарди, кожен шард використовує унікальне ім'я блокування (або зовнішню ізоляцію), щоб уникнути конфліктів між агентами. |
Автоматизована верифікація може бути додана до тест-пакету «блокування розуму», який виконується у спеціалізованій CI-задачі.
9. План міграції – від повністю послідовного до паралелізму на основі замків
- Ідентифікація спільних ресурсів – Перелік зовнішніх облікових записів, пісочниць, конфігураційних файлів, баз даних, які мутують тестами.
- Додати імена блокувань — додайте
{ lock: 'resource-name' }як аргумент параметрів кожного тесту, що працює зі спільним ресурсом. - Проведіть базовий рівень – Виконайте комплекс з
fullyParallel: trueі підтверджіть, що тести на розсудливість блокування (розділ 8) пройшли. - Поступово розширюйте – Якщо новий тест потребує того ж ресурсу, додайте ту саму назву замка.
- Вимірювання – Порівняйте загальну тривалість набору до та після впровадження замків. Не пов'язані тести мають проходити паралельно; зменшення часу роботи настінного годинника є основним KPI.
- Шлюз, що належить людині – Перед тим, як об'єднати PR, який вводить новий замок, вимагайте від рецензента перевірити, що назва замка задокументована і що жоден існуючий тест ще не використовує його ненавмисно. Ці ворота запобігають випадковому розмноженню замків.
Міграція може здійснюватися поступово; не потрібно перемикати весь пакет у послідовний режим.
10. Вимірювані докази того, що непов'язані тести залишаються паралельними
Для перевірки паралельності використовуйте явні позначки початку й завершення тестів із CI-логів або власного репортера. Після міграції дані мають показувати:
- Перекриваючі планки для тестів без спільного замка.
- Прогалини виникають лише там, де два тести з однаковою назвою замка серіалізовані.
За цими позначками розрахуйте спостережуваний коефіцієнт паралелізму:
коефіцієнт паралелізму = сума тривалостей тестів / тривалість усього запускуСпіввідношення, близьке до кількості працівників, свідчить про те, що замки не стримують комплекс.
11. Де допомагає автоматизація
| Область | Можливість автоматизації |
|---|---|
| Перевірка карти замків | Правило lint, яке сканує тестові файли на lock: використання та позначає дублювання або відсутню документацію. |
| Виявлення глухого кута | Скрипт, який створює граф залежностей від блокування з тестового набору і попереджає, якщо будь-який вузол має ступінь > 2 (залежно від політики). |
| Регресія продуктивності | Завдання CI, яке фіксує тривалість набору і не виконується, якщо коефіцієнт паралелізму падає нижче порогу. |
| Перевірка здоров'я ресурсів | Попередній тестовий гачок, який перевіряє, що зовнішня пісочниця доступна; якщо ні — пакет припиняє роботу раніше. |
| Звільнити контроль воріт | Перевірка запит на злиття, яка гарантує, що будь-яке нове ім'я блокування додається до спільного файлу реєстру блокування. |
Ці автоматизовані охоронці підтримують стратегію замків у міру зростання тестової бази.
12. Рекомендована стратегія контролю якості (наша думка)
- Віддаю перевагу ізоляції – Пишіть тести, які не потребують блокування, коли це можливо.
- Введіть блокування лише для справді спільних ресурсів – Використовуйте наведені вище правила іменування та політики.
- Тримайте критичні секції маленькими – Перенесіть усю несуттєву роботу за межі заблокованої зони (наприклад, навігація по сторінці може відбуватися до отримання блокування, якщо це не впливає на спільний стан).
- Контролювати конкуренцію за блокування — аналізуйте часові дані або власний журнал блокувань, щоб конкуренція залишалася низькою.
- Документувати та переглядати – Розглядати назви замків як спільний контракт; будь-яка зміна має проходити через клапан звільнення, що належить людині.
Дотримуючись цього підходу, ви зберігаєте більшу частину паралельної швидкості Playwright, усуваючи нестабільність через одночасний доступ до зовнішніх ресурсів.
13. Питання для огляду
- У чому різниця між поведінкою замка в режимі за замовчуванням і
fullyParallelрежимі? - Як Playwright забезпечує ексклюзивність блокування між працівниками та проєктами?
- Перелічіть дві практичні політики, які знижують ризик глухих кутів при використанні кількох замків.
- Чому команда має розглядати блокування імен як спільний контракт і вимагати перегляду на релізі?
- Яку частину тестового набору варто зберігати повністю послідовною, якщо взагалі є, після впровадження тестових блокувань?
14. Висновок
Іменовані тестові блокування в Playwright 1.63 дають командам QA точний інструмент для серіалізації лише тих тестів, які дійсно потребують ексклюзивного доступу до зовнішнього ресурсу. Розуміючи обсяг блокування, послідовно називаючи їх і застосовуючи політику легкого контролю для уникнення глухих кутів, ви зможете зберегти більшість вашого набору в паралельній роботі, усуваючи при цьому нестабільні збої, спричинені конфліктом спільного стану. Поєднайте вбудований механізм блокування з автоматизованим підкладанням, моніторингом продуктивності та власним людським release gate — і отримаєте надійний, масштабований конвеєр тестування, який поважає як швидкість, так і надійність.
Залишити коментар
Поділіться думкою про статтю. Реєстрація не потрібна.
Коментарі
Завантаження коментарів…