{"canonical_url":"https://engineer.company/uk/glossary/playwright/","content_markdown":"# Playwright\n\n## Що це таке\n\nPlaywright — фреймворк з відкритим кодом від Microsoft для автоматизації браузерів з єдиним\nпрограмним інтерфейсом для Chromium, Firefox і WebKit. Playwright Test, опублікований у npm як\n`@playwright/test`, — це тестовий раннер, побудований на ньому, і саме його найчастіше мають на\nувазі, коли вживають цю назву. Той самий проєкт випускає звичайну бібліотеку для скриптів, які не є\nтестами, інструмент командного рядка й MCP-сервер для ШІ-агентів, а також розширення для Visual\nStudio Code, усе за ліцензією Apache License 2.0.\n\nОкрім JavaScript і TypeScript, те саме керування браузером доступне з Python, де проєкт радить свій\nплагін для pytest, з Java разом із будь-яким тестовим фреймворком, як-от JUnit, і з .NET з базовими\nкласами для MSTest, NUnit і xUnit.\n\n`npx playwright install` завантажує власні збірки трьох рушіїв, і оскільки кожен реліз\nоновлює ці версії, після оновлення команду може знадобитися запустити знову. Playwright\nтакож може керувати Google Chrome і Microsoft Edge, якщо вони вже встановлені на машині.\nЗа замовчуванням тести виконуються в режимі headless, без видимого вікна. Приклад у\nпосібнику зі встановлення запускає тести паралельно в усіх трьох рушіях через налаштовані\nбраузерні проєкти; без цих проєктів типовим браузером засобу запуску тестів є Chromium.\nКожен тест отримує свіжий контекст браузера, рівнозначний новому профілю, тож cookie та\nсховище одного тесту не переходять до наступного.\n\nТест читається як кроки, які зробила б людина:\n\n```js\nimport { test, expect } from \"@playwright/test\";\n\ntest(\"після входу відкриваються вхідні\", async ({ page }) =\u003e {\n    await page.goto(\"https://example.com/sign-in\");\n    await page.getByLabel(\"Email\").fill(\"reader@example.com\");\n    await page.getByRole(\"button\", { name: \"Увійти\" }).click();\n    await expect(page.getByRole(\"heading\", { name: \"Вхідні\" })).toBeVisible();\n});\n```\n\nБільшу частину роботи виконують два механізми. Перед дією Playwright робить перевірки готовності\nелемента (actionability) і чекає, доки всі вони пройдуть. Для кліку локатор має вказувати рівно на\nодин елемент, а сам елемент має бути видимим, стабільним, тобто мати ту саму обмежувальну рамку\nщонайменше два кадри анімації поспіль, здатним отримати клік, а не лежати під іншим елементом, і\nактивним. Якщо перевірки не проходять за відведений час, дія завершується помилкою `TimeoutError`.\nТвердження (assertions) у формі `await expect(locator)` поводяться так само: вони знову й знову\nотримують елемент, доки умова не справдиться або не мине тайм-аут твердження, за замовчуванням п'ять\nсекунд.\n\n## Чому це важливо\n\nРішення, якому служить Playwright, стосується того, яку поведінку треба перевіряти в справжньому\nбраузері і як зробити ці перевірки настільки надійними, щоб червоній збірці вірили. Деякі вади\nіснують лише тоді, коли сторінку вже зібрано: діалог, що закриває кнопку, яку мав показати, макет,\nщо ховає поле на певній ширині, скрипт, що працює в одному рушії й падає з помилкою в іншому. Тести,\nякі запускають шматки коду окремо, їх не бачать.\n\nБраузерні тести стають нестабільними (flaky), коли тест і сторінка змагаються наввипередки. Сторінка\nзавантажує дані, анімується й перемальовується, а тест, що клікає тієї миті, коли виконується його\nрядок, іноді клікає зарано. Давнім засобом була фіксована пауза: закоротка на повільній машині й\nмарна трата часу на швидкій. Автоматичне очікування та твердження, що повторюють перевірку,\nзамінюють паузу умовою, від якої тест насправді залежить. Посібник про твердження каже прямо:\nвебсторінки показують інформацію асинхронно, і твердження, які перевіряють лише раз, можуть зробити\nтест нестабільним.\n\nДругий вибір — як тест знаходить елементи. Посібник про локатори радить насамперед атрибути, які\nбачить користувач, а понад усе локатори за роллю, бо `getByRole` з доступним ім'ям найближче до\nтого, як сторінку сприймають люди й допоміжні технології. Це має корисний побічний ефект: тест, що\nнатискає кнопку з назвою «Увійти», зламається, якщо кнопка втратить назву, а це та сама вада, на яку\nнатрапить людина з екранним читачем. Посібник також каже, що локатори за роллю не замінюють аудитів\nдоступності й тестів на відповідність. Ідентифікатори для тестів — запасний варіант. Посібник\nназиває їх найстійкішим способом і водночас таким, якого не бачать користувачі, тож набір, що\nзнаходить усе за id, доводить менше про те, що відчувають відвідувачі. CSS- і XPath-селектори не\nрекомендовані, бо DOM часто змінюється.\n\nЦіна — час. Запуск браузера й завантаження сторінки роблять браузерні тести\nнайповільнішим видом тестів у проєкті. Коли такий тест завершується з помилкою\nна сервері збірки, розібратися в причині допомагає trace viewer. Документований\nприклад конфігурації записує трасу під час першого повторного запуску тесту, що\nвпав, з двома повторами на CI й жодним локально; вбудовані типові налаштування\nзасобу запуску тестів не передбачають ані записування трас, ані повторних\nзапусків. Траса проводить через кожну дію зі сторінкою до і після неї,\nмережевими запитами й консоллю.\n\n## Як це виглядає на практиці\n\nОдна платформа тут тримає бізнес-логіку в базі даних, і роботою було\n[побудувати багаторівневий набір тестів на чотирьох рівнях](/uk/portfolio/built-a-test-suite-across-go-sql-and-browser/).\nЗавданням було перевіряти поведінку кожного рівня там, де вона насправді живе, «а не перевіряти все\nззовні через браузер». В API на Go — 981 тестова функція. У базі даних — 494 файли поведінкових\nтестів, тож збережену функцію тестують у самій базі даних, а не крізь три рівні застосунку над нею.\nУ фронтенді — 543 специфікації Vitest і Playwright, зокрема 48 файлів наскрізних тестів і 30\nбраузерних специфікацій; сторінка дає одне спільне число для обох інструментів і не ділить його.\nУвесь набір запускається як 10 задач у workflow на 612 рядків, і сторінка прямо називає ціну: набір\nповільний, кожна зміна сплачує йому свою данину, а за такого розміру він і сам потребує догляду.\n\nЦей сайт керує власними браузерними перевірками за допомогою іншої бібліотеки, Puppeteer, і\n[сторінка подяк](/uk/credits/) показує той самий компроміс. Ці перевірки охоплюють те, чого\nвалідатор зробити не може, наприклад вимірювання контрасту, порядок фокуса, розмір цілі, вихід за\nмежі вікна й розбиття на сторінки під час друку. Усі, крім виходу за межі вікна, входять до\nобов'язкових перевірок перед кожним пушем, а його, як і попіксельну візуальну регресію, людина\nзапускає на вимогу.\n\n## Де виникають проблеми\n\nБільшість проблем із Playwright походить від тестів, які перевіряють менше, ніж обіцяють їхні назви.\n\n**Фіксована пауза підміняє умову.** Тест чекає дві секунди й потім читає сторінку або один раз читає\nзначення й порівнює його звичайним твердженням. На завантаженому сервері збірки двох секунд іноді\nзамало. Перевіряйте те, що побачили б відвідувачі, твердженням, яке повторює перевірку, наприклад\n`toHaveText`.\n\n**Елементи шукають за розміткою.** Селектор крізь три вкладені елементи `div` або клас оформлення\nламається з наступним редизайном, хоча сторінка й далі працює. Шукайте елемент за роллю й доступним\nім'ям або за підписом чи текстом, а ідентифікатор для тестів додавайте лише там, де елемент\nнеможливо впізнати за тим, що сприймають користувачі.\n\n**Успішний локатор за роллю вважають перевіркою доступності.** `getByRole` доводить, що один елемент\nмає ту роль і те ім'я, які задав тест. Про контраст, порядок фокуса чи решту сторінки він не каже\nнічого. Для цього запускайте з тесту рушій правил, наприклад axe, як це робить власний\n[посібник](https://playwright.dev/docs/accessibility-testing) Playwright через\n`@axe-core/playwright`; сканування охоплює сторінку в тому стані, у якому вона є на момент виклику,\nтож спершу відкрийте меню чи діалог.\n\n**Клік проштовхують силоміць.** Параметр `force` вимикає неістотні перевірки готовності; для кліку\nPlaywright перестає перевіряти, чи ціль справді отримує подію. Тест, якому він потрібен, часто\nобходить те, на що натрапили б і відвідувачі, наприклад банер над кнопкою. Сприймайте початкову\nпомилку як знахідку: або закрийте банер так, як це зробили б відвідувачі, або виправте перекриття.\n\n**Нестабільний тест перезапускають, доки він не пройде.** Коли повтори ввімкнено, тест, що впав під\nчас першого запуску й пройшов під час повтору, позначається як flaky, а не як невдалий. Тест, який\nлишається нестабільним тиждень у тиждень, або змагається зі сторінкою, або ловить справжню ваду, що\nто з'являється, то зникає, і траса, записана під час його першого повтору, — місце, з якого варто\nпочати.\n\n**Усе перевіряють через браузер.** Правило про ціни чи права доступу, перевірене кліками крізь три\nекрани, працює повільно й ламається з причин, які до правила не мають стосунку. Перевіряйте правило\nтам, де воно живе, а браузерні тести залиште для того, що може показати лише браузер: шлях\nкористувача, макет і відмінності між рушіями.\n\n## Що почитати далі\n\n- [Installation](https://playwright.dev/docs/intro) — встановлення Playwright Test, запуск прикладів\n  тестів, HTML-звіт і UI Mode.\n- [Locators](https://playwright.dev/docs/locators) — рекомендований порядок пошуку елементів, від\n  ролі й підпису до ідентифікаторів для тестів.\n- [Auto-waiting](https://playwright.dev/docs/actionability) — перевірки готовності перед кожною дією\n  і що саме вимикає `force`.\n- [Assertions](https://playwright.dev/docs/test-assertions) — твердження з повторною перевіркою і\n  без неї, тайм-аут за замовчуванням, м'які твердження й опитування.\n- [Trace viewer](https://playwright.dev/docs/trace-viewer-intro) — запис траси під час повтору й\n  покроковий перегляд тесту, що впав.\n- [Browsers](https://playwright.dev/docs/browsers) — встановлення рушіїв, запуск Chrome і Edge та\n  два режими headless.\n\n\u003chttps://engineer.company/uk/glossary/playwright/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"На що Playwright Test чекає перед кожним кліком, чому він шукає елементи за роллю й ім'ям і скільки коштує підтримувати тести у справжніх браузерах.","formats":{"gemtext":"https://engineer.company/uk/glossary/playwright/index.gmi","gopher":"https://engineer.company/uk/glossary/playwright/gophermap","html":"https://engineer.company/uk/glossary/playwright/","json":"https://engineer.company/uk/glossary/playwright/index.json","markdown":"https://engineer.company/uk/glossary/playwright/index.md","pdf":"https://engineer.company/uk/glossary/playwright/index.pdf"},"kind":"page","language":"uk","title":"Що таке Playwright?","url":"https://engineer.company/uk/glossary/playwright/","version":1}