Web Application Testing

To test local web applications, write native Python Playwright scripts or use the built-in helper scripts.

Helper Scripts Available:

• scripts/with_server.py - Manages server lifecycle (supports multiple servers)
• scripts/test_webapp.py - All-in-one web testing: screenshots, checks, interactions, logs
• scripts/api_test.py - REST API testing without a browser
• scripts/smoke_test.py - Automatic smoke test: visits pages, captures errors, screenshots

Always run scripts with --help first to see usage. DO NOT read the source until you try running the script first and find that a customized solution is absolutely necessary.

Quick Reference

Test a page (screenshot + checks)

python scripts/test_webapp.py --url http://localhost:3000 \
  --screenshot --check-status --check-selector "table" --console-logs --json