Як зберегти тести спільних ресурсів у безпеці, водночас використовуючи паралелізм 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-завдання. Якщо спільний ресурс дійсно не може бути одночасно доступний між агентами, ви повинні або:

У статті не стверджується розподілене блокування між CI-машинами, оскільки офіційна документація цього не гарантує.


6. Практичні питання

6.1 Тайм‑аут

Playwright не виявляє тайм-аут, специфічний для блокування. Якщо тест не може отримати свій блок через застряг іншого тесту, тест очікування просто залишиться в черзі до моменту зняття блокування. На практиці це може призвести до того, що загальний набір може перевищити тайм-аут CI. Стратегії пом'якшення:

6.2 Відновлення після відмови

Playwright звільняє блокування після завершення тесту та завершує робочий процес після помилки тесту. Водночас зовнішній стан може залишитися пошкодженим (наприклад, частково оновлений обліковий запис), тому наступні тести все одно можуть завершитися помилкою. Рекомендовано:

6.3 Спостережуваність

Офіційна документація описує поведінку блокувань, але не надає телеметрію їх отримання. Тому часові дані слід збирати як власну командну інструменталізацію:

Такі дані допомагають виявити зайве очікування без тверджень про недокументовану внутрішню реалізацію раннера.

6.4 Запобігання глухому куту

Playwright очікує доступності всіх запитаних блокувань до запуску тесту. Тому наступна командна політика призначена для обмеження конкуренції та зручності перевірки:

Ці правила зберігають реєстр блокувань компактним і зрозумілим.


7. Вигляд архітектури та потоків даних

Тестові файли → параметри блокувань → координація раннера → робочий процес → результат тесту

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


8. Контрольний список розробки тестів

КатегоріяЩо перевірити
ПозитивноТест, який оголошує блокування sandbox‑A успішно виконується, коли жоден інший тест не має такого блокування.
НегативноДва тести, які обидва запитують sandbox‑A ніколи не перетинаються; другий тест починається лише після завершення першого.
ПаралельністьТести з різними іменами блокування (sandbox‑A проти sandbox‑B) виконуються паралельно, навіть якщо виконуються на одному й тому ж пулі працівників.
Тайм-аутДля навмисно повільного тесту задається явний тайм-аут; очищення та відновлення зовнішнього стану перевіряються окремо.
CI шардингКоли пакет розділяється на два шарди, кожен шард використовує унікальне ім'я блокування (або зовнішню ізоляцію), щоб уникнути конфліктів між агентами.

Автоматизована верифікація може бути додана до тест-пакету «блокування розуму», який виконується у спеціалізованій CI-задачі.


9. План міграції – від повністю послідовного до паралелізму на основі замків

  1. Ідентифікація спільних ресурсів – Перелік зовнішніх облікових записів, пісочниць, конфігураційних файлів, баз даних, які мутують тестами.
  2. Додати імена блокувань — додайте { lock: 'resource-name' } як аргумент параметрів кожного тесту, що працює зі спільним ресурсом.
  3. Проведіть базовий рівень – Виконайте комплекс з fullyParallel: true і підтверджіть, що тести на розсудливість блокування (розділ 8) пройшли.
  4. Поступово розширюйте – Якщо новий тест потребує того ж ресурсу, додайте ту саму назву замка.
  5. Вимірювання – Порівняйте загальну тривалість набору до та після впровадження замків. Не пов'язані тести мають проходити паралельно; зменшення часу роботи настінного годинника є основним KPI.
  6. Шлюз, що належить людині – Перед тим, як об'єднати PR, який вводить новий замок, вимагайте від рецензента перевірити, що назва замка задокументована і що жоден існуючий тест ще не використовує його ненавмисно. Ці ворота запобігають випадковому розмноженню замків.

Міграція може здійснюватися поступово; не потрібно перемикати весь пакет у послідовний режим.


10. Вимірювані докази того, що непов'язані тести залишаються паралельними

Для перевірки паралельності використовуйте явні позначки початку й завершення тестів із CI-логів або власного репортера. Після міграції дані мають показувати:

За цими позначками розрахуйте спостережуваний коефіцієнт паралелізму:

коефіцієнт паралелізму = сума тривалостей тестів / тривалість усього запуску

Співвідношення, близьке до кількості працівників, свідчить про те, що замки не стримують комплекс.


11. Де допомагає автоматизація

ОбластьМожливість автоматизації
Перевірка карти замківПравило lint, яке сканує тестові файли на lock: використання та позначає дублювання або відсутню документацію.
Виявлення глухого кутаСкрипт, який створює граф залежностей від блокування з тестового набору і попереджає, якщо будь-який вузол має ступінь > 2 (залежно від політики).
Регресія продуктивностіЗавдання CI, яке фіксує тривалість набору і не виконується, якщо коефіцієнт паралелізму падає нижче порогу.
Перевірка здоров'я ресурсівПопередній тестовий гачок, який перевіряє, що зовнішня пісочниця доступна; якщо ні — пакет припиняє роботу раніше.
Звільнити контроль ворітПеревірка запит на злиття, яка гарантує, що будь-яке нове ім'я блокування додається до спільного файлу реєстру блокування.

Ці автоматизовані охоронці підтримують стратегію замків у міру зростання тестової бази.


12. Рекомендована стратегія контролю якості (наша думка)

  1. Віддаю перевагу ізоляції – Пишіть тести, які не потребують блокування, коли це можливо.
  2. Введіть блокування лише для справді спільних ресурсів – Використовуйте наведені вище правила іменування та політики.
  3. Тримайте критичні секції маленькими – Перенесіть усю несуттєву роботу за межі заблокованої зони (наприклад, навігація по сторінці може відбуватися до отримання блокування, якщо це не впливає на спільний стан).
  4. Контролювати конкуренцію за блокування — аналізуйте часові дані або власний журнал блокувань, щоб конкуренція залишалася низькою.
  5. Документувати та переглядати – Розглядати назви замків як спільний контракт; будь-яка зміна має проходити через клапан звільнення, що належить людині.

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


13. Питання для огляду

  1. У чому різниця між поведінкою замка в режимі за замовчуванням і fullyParallel режимі?
  2. Як Playwright забезпечує ексклюзивність блокування між працівниками та проєктами?
  3. Перелічіть дві практичні політики, які знижують ризик глухих кутів при використанні кількох замків.
  4. Чому команда має розглядати блокування імен як спільний контракт і вимагати перегляду на релізі?
  5. Яку частину тестового набору варто зберігати повністю послідовною, якщо взагалі є, після впровадження тестових блокувань?

14. Висновок

Іменовані тестові блокування в Playwright 1.63 дають командам QA точний інструмент для серіалізації лише тих тестів, які дійсно потребують ексклюзивного доступу до зовнішнього ресурсу. Розуміючи обсяг блокування, послідовно називаючи їх і застосовуючи політику легкого контролю для уникнення глухих кутів, ви зможете зберегти більшість вашого набору в паралельній роботі, усуваючи при цьому нестабільні збої, спричинені конфліктом спільного стану. Поєднайте вбудований механізм блокування з автоматизованим підкладанням, моніторингом продуктивності та власним людським release gate — і отримаєте надійний, масштабований конвеєр тестування, який поважає як швидкість, так і надійність.


Джерела