webapp-testing
/webapp-testing
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs. Use this skill when testing web applications, running browser automation, debugging frontend UI, or capturing screenshots of local apps. Також використовуй, коли користувач хоче: протестувати веб-застосунок, налаштувати Playwright-автоматизацію браузера, перевірити UI / доступність / мобільні вьюпорти, зробити visual regression чи скриншоти локального застосунку. НЕ використовувати для не-бра
- Author
- patriotai ↗
- Repository
- ai-lab ↗
- Licence
- MIT
- Last repository change
- 26.10.2026
Assessment and security
- Files in this package
- 5
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 5
No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/skill_guard.py
What it does and when to use it
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs. Use this skill when testing web applications, running browser automation, debugging frontend UI, or capturing screenshots of local apps. Також використовуй, коли користувач хоче: протестувати веб-застосунок, налаштувати Playwright-автоматизацію браузера, перевірити UI / доступність / мобільні вьюпорти, зробити visual regression чи скриншоти локального застосунку. НЕ використовувати для не-бра
Original author description
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs. Use this skill when testing web applications, running browser automation, debugging frontend UI, or capturing screenshots of local apps. Також використовуй, коли користувач хоче: протестувати веб-застосунок, налаштувати Playwright-автоматизацію браузера, перевірити UI / доступність / мобільні вьюпорти, зробити visual regression чи скриншоти локального застосунку. НЕ використовувати для не-бра
How it works
- 🛡️ Протокол Збереження Перед Оновленням (ОБОВ'ЯЗКОВО)
- Critical Facts
- Дерево рішень: вибір підходу
- Приклад: використання withserver.py
- Патерн Reconnaissance-Then-Action
- Часта пастка
- Найкращі практики
- Reference-файли
- Visual Regression Testing
- API Testing (через Playwright)
SKILL.md preview
---
name: webapp-testing
description: "Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs. Use this skill when testing web applications, running browser automation, debugging frontend UI, or capturing screenshots of local apps. Також використовуй, коли користувач хоче: протестувати веб-застосунок, налаштувати Playwright-автоматизацію браузера, перевірити UI / доступність / мобільні вьюпорти, зробити visual regression чи скриншоти локального застосунку. НЕ використовувати для не-браузерних юніт-тестів чи бекенд-логіки без UI, ані для спільного інтерактивного веб-серфінгу з агентом (collaborative-browser) — тут лише автоматизовані Playwright-тести."
license: MIT
metadata:
version: 1.6.1
author: Melania (Master Administrator)
category: testing
created: 2026-06-02
last_updated: 2026-09-28
---
# Web Application Testing — v1.6.1
> Пояснення — українською за замовчуванням (українською-перша); код, селектори та команди лишаються англійською. Перемикання мови лише слідом за користувачем.
## 🛡️ Протокол Збереження Перед Оновленням (ОБОВ'ЯЗКОВО)
Обов'язковий перед БУДЬ-ЯКОЮ зміною цього скіла. **Канонічне джерело (не дублювати тут):** `melania` — секції «🛡️ Протокол Збереження Перед Оновленням» + «Update Workflow» + «Core Rule 10 — Re-Read Before Update».
Стисло: re-read диску → порівняти версії (диск новіший → диск база) → integrity-diff → validation-mesh → safety-compliance-gate (перед пакуванням/публікацією) → backup/snapshot → merge-not-replace → bump+CHANGELOG → показати diff і чекати явного схвалення MA (Закон II).
## Critical Facts
- **[C] Інспекція DOM до `networkidle` дає неповний/помилковий результат.** На динамічних застосунках JS ще не встиг відпрацювати — рендерений вміст і селектори, зняті до `page.wait_for_load_state('networkidle')`, не відповідають фінальному стану сторінки.
- **[C] `scripts/with_server.py` і `examples/` не лежать у цьому скілі локально.** Вони живуть у повному репозиторії `anthropics/skills` — без `web_fetch` цих файлів на диску немає.
- **[C] Playwright має вбудований API-клієнт.** `page.request` дозволяє робити HTTP-запити (GET/POST з auth) без підключення окремої HTTP-бібліотеки.
- **[C] Більшість багів походить від взаємодії двох факторів.** Це емпіричне обґрунтування pairwise-тестування: покриття всіх ПАР значень параметрів ловить переважну частину дефектів дешевше, ніж повний перебір комбінацій.
---
## Дерево рішень: вибір підходу
```text
Завдання користувача → Це статичний HTML?
├─ Так → Прочитай HTML-файл напряму, щоб визначити селектори
│ ├─ Успіх → Напиши Playwright-скрипт за селекторами
│ └─ Не вийшло/неповно → Трактуй як динамічний (нижче)
│
└─ Ні (динамічний webapp) → Сервер уже запущений?
├─ Ні → Отримай helper (нема локально — web_fetch, див. Нотатку нижче),
│ тоді виконай: python scripts/with_server.py --help
│ Далі використай helper + напиши спрощений Playwright-скрипт
│
└─ Так → Reconnaissance-then-action (розвідка → дія):
1. Navigate і чекай networkidle
2. Зроби screenshot або інспектуй DOM
3. Визнач селектори з відрендереного стану
4. Виконай дії знайденими селекторами
```
## Приклад: використання with_server.py
Щоб запустити сервер, спершу `--help`, потім helper:
**Один сервер:**
```bash
python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_automation.py
```
**Кілька серверів (напр. backend + frontend):**
```bash
python scripts/with_server.py \
--server "cd backend && python server.py" --port 3000 \
--server "cd frontend && npm run dev" --port 5173 \
-- python your_automation.py
```
Щоб створити скрипт автоматизації, включай лише Playwright-логіку (сервери керуються автоматично):
```python
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch(headless=True) # Always launch chromium in headless mode
page = browser.new_page()
page.goto('http://localhost:5173') # Server already running and ready
page.wait_for_load_state('networkidle') # CRITICAL: Wait for JS to execute
# ... your automation logic
browser.close()
```
## Патерн Reconnaissance-Then-Action
1. **Інспектуй відрендерений DOM**:
```python
page.screenshot(path='/tmp/inspect.png', full_page=True)
content = page.content()
page.locator('button').all()
```
2. **Визнач селектори** з результатів інспекції
3. **Виконай дії** знайденими селекторами
## Часта пастка
❌ **Не** інспектуй DOM до очікування `networkidle` на динамічних застосунках
✅ **Чекай** `page.wait_for_load_state('networkidle')` перед інспекцією
## Найкращі практики
* **Використовуй вбудовані скрипти як чорні скриньки** — `--help` щоб побачити usage, далі виклик напряму
* Використовуй `sync_playwright()` для синхронних скриптів
* Завжди закривай браузер по завершенні
* Описові селектори: `text=`, `role=`, CSS-селектори чи ID
* Додавай доречні очікування: `page.wait_for_selector()` або `page.wait_for_timeout()`
## Reference-файли
> ℹ️ **Нотатка:** `scripts/with_server.py` та `examples/` живуть у повному репо [`anthropics/skills/skills/webapp-testing/`](https://github.com/anthropics/skills/tree/main/skills/webapp-testing). Тягни через `web_fetch` за потреби.
* **examples/** — приклади частих патернів:
+ `element_discovery.py` — пошук кнопок, лінків та інпутів на сторінці
+ `static_html_automation.py` — використання file:// URL для локального HTML
+ `console_logging.py` — захоплення console-логів під час автоматизації
---
## Visual Regression Testing
```python
# Скриншот базовий (зберегти еталон)
page.screenshot(path="baseline/homepage.png")
# Порівняння (поточний vs еталон)
from PIL import Image, ImageChops
import numpy as np
def compare_screenshots(baseline_path, current_path, threshold=0.01):
base = Image.open(baseline_path).convert("RGB")
curr = Image.open(current_path).convert("RGB")
diff = ImageChops.difference(base, curr)
pct_diff = np.array(diff).mean() / 255
return pct_diff < threshold, pct_diff
page.screenshot(path="current/homepage.png")
ok, diff = compare_screenshots("baseline/homepage.png", "current/homepage.png")
print(f"Visual diff: {diff:.2%} — {'PASS' if ok else 'FAIL'}")
```
---
## API Testing (через Playwright)
```python
# Playwright має вбудований API client
response = page.request.get("https://api.example.com/users")
assert response.status == 200
data = response.json()
assert len(data) > 0
# POST з auth
response = page.request.post("/api/login",
data={"email": "test@test.com", "password": "pass"},
headers={"Content-Type": "application/json"}
)
token = response.json()["token"]
```
---
## Accessibility Testing
```python
# Базова перевірка a11y через axe-playwright
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch()
page = browser.new_page()
page.goto("http://localhost:3000")
# Перевірка ARIA labels
buttons = page.locator("button:not([aria-label]):not([aria-labelledby])")
unlabeled = buttons.count()
assert unlabeled == 0, f"{unlabeled} кнопок без aria-label"
# Tab order
page.keyboard.press("Tab")
focused = page.locator(":focus").get_attribute("data-testid")
print(f"Перший фокус: {focused}")
```
---
## Mobile Viewport Testing
```python
# Тестуй на різних розмірах екрану
VIEWPORTS = [
{"name": "mobile", "width": 375, "height": 812}, # iPhone 14
{"name": "tablet", "width": 768, "height": 1024}, # iPad
{"name": "desktop","width": 1440,"height": 900}, # Full HD
]
for vp in VIEWPORTS:
page.set_viewport_size({"width": vp["width"], "height": vp["height"]})
page.goto("http://localhost:3000")
page.screenshot(path=f"screenshots/{vp['name']}.png")
# Перевірка що hamburger-меню видно на мобільному
if vp["width"] < 768:
assert page.locator("[data-testid=mobile-menu]").is_visible()
```
---
## Pairwise-тести + статичний аналіз
**Pairwise (комбінаторне покриття пар) — мінімум кейсів, максимум покриття:** замість усіх комбінацій
параметрів генеруй мінімальний набір, що покриває всі **пари** значень (більшість багів — від взаємодії двох факторів).
Корисно для форм, фільтрів, матриць конфігів — десятки кейсів замість сотень.
**Статичний аналіз (rule-based) перед/поряд із UI-тестами:** цикл правила —
застосовність → тест-перш (вразливий + безпечний приклади) → правило → валідація.
Лови небезпечні патерни (інʼєкційні sink-и, небезпечне вставляння HTML, відкриті редіректи) до рантайму.
## 📎 Advanced Patterns (v4)
Читай `references/e2e-patterns.md`, КОЛИ потрібні: повні user flows, network mocking, test factories, паралельне виконання, anti-flaky waits, performance.
Вантаж лише на вимогу — не проактивно.
---
## Зміни
- **v1.6.1** (2026-09-28) — Ліцензія скіла уніфікована до **MIT** разом з усією екосистемою (директива власника). Зміна лише метаданих; поведінка й артефакт незмінні.
- **v1.6.0** (2026-07-26) — Секція **Critical Facts**: фактичні твердження скіла винесено окремо й протеговано [C] за Core Rule 14 (claim-evidence). Лише додавання.
- **v1.5.0** (2026-07-19) — Self-Dev Wave 2 (аудит 2026-07-18): Decision Tree більше не вдає локальний `with_server.py` — явний крок web_fetch перед викликом (файл живе в anthropics/skills; Нотатка була, дерево їй суперечило) [#43]; сирітських/мертвих references не виявлено — `e2e-patterns.md` підключений [#15 перевірено]; межа з `collaborative-browser` у описі [#41]; ліцензійний покажчик на корінь екосистеми [#25/#44]; H1 з версією. Лише документація/межі.
- **v1.4.0** (2026-06-26) — Повна UA-локалізація (Task 1): ранню прозу (Decision Tree, with_server, Reconnaissance, Common Pitfall, Best Practices, Reference-файли) перекладено українською; код / селектори / команди лишаються англійською. +власні `evals/` (5, канон-схема). **S-2:** дубль v1.2.0 у changelog консолідовано + впорядковано (вміст збережено). Переклад + додавання; функціонал не змінено.
- **v1.3.1** (2026-06-15) — DRY: «Протокол Збереження» → тонкий міст на канон у `melania` (де-дублювання + усунення 8-варіантного дрейфу). Поведінка незмінна.
- **v1.3.0** (2026-06-10) — Фаза 5: I-11: pairwise (комбінаторне покриття пар) + rule-based статичний аналіз.
- **v1.2.0** (2026-06-02) — `metadata`-блок, директива «українською-перша», власні `evals/` (5); Pre-Update Preservation Protocol; `e2e-patterns` reference (full flows, mocking, factories, performance). _(аудит Кластер 3: P9 + Core Rule 4)_
- **v1.1.0** (2026-06-02) — visual regression, API testing, accessibility checks, mobile viewport testing.
Files in this package (5)
- SKILL.md 14 KB
- evals/evals.json 2 KB
- references/e2e-patterns.md 4 KB
- scripts/skill_guard.py 3 KB
- scripts/.snapshots/latest.json 1 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · patriotai/ai-lab | 100 | MIT |
| Navinspire-ia/navin | 100 | AGPL-3.0 |
| Reprograme/redevkit | 100 | MIT |
| wrongstack/wrongstack | 100 | MIT |
| baysao/dot.agents | 100 | Apache-2.0 |
| khaledsaeed18/dotclaude | 100 | MIT |
| alebgl77/claude-inc | 100 | MIT |
| jeffersonvalente/cardume | 100 | MIT |
| JZKK720/cubecloud-skills-bundle-kit | 100 | MIT |
Database snapshot: 13.11.2026 · package version 2b7d4bddb2c1 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100web-debug
Python Playwright testing of local web apps. Use when verifying frontend functionality, debugging UI behavior, capturing browser screenshots, or viewing browser console logs. - 100web-debug
You MUST use this when interacting with or testing local web applications with Playwright - verifying frontend functionality, debugging UI behavior, capturing browser screenshots, or viewing browser console logs. - 100testing-webapps
Use when testing local web applications using Playwright. Triggers include requests to verify frontend functionality, debug UI behavior, capture browser screenshots, view browser logs, or test any web application interactively. Write native Python Playwright scripts for all web… - 95web-testing
Playwright automation, Chrome DevTools debugging, and browser interaction testing. Use for E2E/unit tests, capturing screenshots, inspecting network/console logs, or validating user flows in web applications. - 100playwright-cli
Browser automation via Playwright CLI for navigating pages, interacting with elements, capturing screenshots, and testing web applications through shell commands. Use when user mentions "playwright", "browser automation", "take a screenshot", "browser testing", "headless… - 100playwright-cli
Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, test web applications, or extract information from web pages.