要测试本地 Web 应用，请编写原生 Python Playwright 脚本。

始终先用 --help 运行脚本以查看用法。在尝试运行脚本并发现确实需要定制解决方案之前，不要阅读源代码。这些脚本可能非常大，会污染你的上下文窗口。它们的存在是为了作为黑盒脚本被直接调用，而不是被吸收进你的上下文窗口。

用户任务 → 是静态 HTML 吗？
    ├─ 是 → 直接读取 HTML 文件以识别选择器
    │         ├─ 成功 → 使用选择器编写 Playwright 脚本
    │         └─ 失败/不完整 → 按动态处理（见下文）
    │
    └─ 否（动态 Web 应用）→ 服务器是否已在运行？
        ├─ 否 → 运行：python scripts/with_server.py --help
        │        然后使用辅助脚本 + 编写简化版 Playwright 脚本
        │
        └─ 是 → 先侦察后行动：
            1. 导航并等待 networkidle
            2. 截图或检查 DOM
            3. 从渲染后的状态识别选择器
            4. 使用发现的选择器执行操作

要启动服务器，先运行 --help，然后使用辅助脚本：

python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_automation.py

多个服务器（例如，后端 + 前端）：

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 逻辑（服务器会自动管理）：

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(headless=True) # 始终以无头模式启动 chromium
    page = browser.new_page()
    page.goto('http://localhost:5173') # 服务器已在运行且就绪
    page.wait_for_load_state('networkidle') # 关键：等待 JS 执行
    # ... 你的自动化逻辑
    browser.close()

page.screenshot(path='/tmp/inspect.png', full_page=True)

❌ 不要在动态应用等待 networkidle 之前检查 DOM

✅ 要在检查之前等待 page.wait_for_load_state('networkidle')

本技能适用于执行概述中描述的工作流或操作。

来源说明：本文内容整理自开源项目 agentic-awesome-skills（中文翻译版），遵循 CC BY 4.0（知识共享署名 4.0 国际）许可协议，此处作为中文资料整理分享，版权归原作者所有。

Webapp Testing 实用指南

To test local web applications, write native Python Playwright scripts.

测试

前端

开发工具

Web应用测试实用指南：掌握Playwright自动化脚本，通过with_server.py管理服务器生命周期，运用“先侦察后行动”模式识别DOM选择器。同步脚本配合networkidle等待，避免常见陷阱，遵循最佳实践。附示例文件，适用于本地Web应用端到端测试。

服务器

Python

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Webapp Testing 实用指南

Webapp Testing 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐