Playwright Test Explorer

Playwright 测试结构探索工具 - 用最简单的方式查看和分析你的测试。

特性

• 📋 列出所有测试文件
• 🔍 分析测试用例详情（位置、标签、注解）
• 🌳 树形结构展示完整测试层级
• 💻 CLI 命令 & JavaScript API 双模式
• 📦 支持输出到 JSON 文件

快速开始

安装

# 全局安装
npm install -g playwright-test-explorer

# 本地安装
npm install playwright-test-explorer

CLI 使用

# 列出所有测试文件
pw-test-explorer list-files

# 列出指定文件中的测试用例
pw-test-explorer list-tests -f tests/example.spec.ts

# 显示完整测试树
pw-test-explorer tree

# 保存结果到文件
pw-test-explorer tree -o output.json

API 使用

import { listTestFile, listTestCase, treeStructure } from 'playwright-test-explorer';

// 列出测试文件
await listTestFile('/path/to/project', 'playwright.config.ts');

// 列出测试用例
await listTestCase('/path/to/project', 'playwright.config.ts', ['tests/example.spec.ts']);

// 生成测试树
await treeStructure('/path/to/project', 'playwright.config.ts');

文档

• 功能规格说明 - 完整的功能需求和 API 文档

开发

pnpm install       # 安装依赖
pnpm run build     # 构建项目
pnpm test          # 运行测试

要求

• Node.js 16+
• @playwright/test

License

MIT

参考 Microsoft playwright-vscode 的测试服务器实现。