wp-test-strategy

WordPress 测试策略技能

概述

为 WordPress 项目提供系统化的测试策略指导。**核心原则：**测试深度应与风险相匹配，测试金字塔应反映所涉及的 WordPress 范围。审查涵盖单元测试、WordPress 集成测试、REST 端点测试、区块测试、浏览器或 E2E 流程、WooCommerce 回归测试、测试固件以及发布风险优先级排序。

适用场景

适用于：

• 决定为某项功能或修复添加哪些测试
• 检查插件或主题中的覆盖缺失
• 在发布前规划回归测试
• 在单元、集成和 E2E 测试覆盖之间做出选择
• 将区块、REST、管理后台或 WooCommerce 行为映射到测试

不适用于：

• 不涉及测试决策的代码审查
• 仅调试 CI 系统
• 单独进行性能基准测试

代码审查工作流

1. 确定变更范围

   • 纯 PHP 逻辑
   • WordPress 集成行为
   • REST 或 AJAX 流程
   • 区块编辑器行为
   • 管理后台页面工作流
   • WooCommerce 订单／购物车／结账行为

2. 评估风险

   • 面向用户的功能故障
   • 数据损坏或迁移风险
   • 涉及身份验证／安全的流程
   • 浏览器交互复杂度

3. 选择测试深度

   • 为隔离逻辑编写单元测试
   • 为 WordPress API 和数据库状态编写集成测试
   • 为 UI 工作流或编辑器交互编写 E2E 测试

4. 报告建议

   • 应测试哪些内容
   • 适合采用哪种级别的测试
   • 哪些内容可以跳过或通过间接方式覆盖

测试选择启发式原则

单元测试

适用于：

• 纯转换逻辑
• 小型辅助函数
• 格式化和解析逻辑
• 与 WP 运行时解耦的验证规则

集成测试

适用于：

• 钩子和筛选器
• 选项／元数据持久化
• REST 端点
• 自定义查询
• 角色／权限行为

E2E 或浏览器测试

适用于：

• 区块编辑器流程
• 带有 JS 行为的管理后台表单
• 结账、购物车和前端交互
• 对无障碍访问敏感的交互流程

快速检测的搜索模式（TST-21）

使用这些 rg 命令了解当前测试覆盖情况和可能存在的缺口。

覆盖情况发现

# Test directories and files
rg -n "class .*Test|extends .*TestCase|describe\\(|test\\(" . -g '*.{php,js,jsx,ts,tsx}'

# PHPUnit config or bootstrap
rg -n "phpunit|tests/bootstrap|WP_UnitTestCase" .

# Playwright or E2E indicators
rg -n "playwright|@wordpress/e2e-test-utils|page\.goto|test\\(" . -g '*.{js,ts}'

缺口信号

# High-risk surfaces with no obvious tests nearby
rg -n "register_rest_route|add_action|add_filter|wp_ajax_|admin_post_|dbDelta|WC_" . -g '*.php'

# Block editor files
rg -n "block.json|edit\\(|save\\(|registerBlockType" . -g '*.{json,js,jsx}'

参考文件

• references/test-layer-guide.md - 为 WordPress 项目选择单元、集成或 E2E 测试覆盖
• references/wordpress-test-scenarios.md - 针对插件、区块、主题、REST API 和 WooCommerce 的推荐测试场景

输出格式（TST-23）

报告时按以下内容组织：

1. 审查范围
2. 推荐的测试类型
3. 优先级最高的覆盖缺口
4. 可选的增强覆盖

如果现有测试已经足够，请明确说明，并指出任何残余风险或未覆盖的边缘情况。