显式断言

本文深入探讨 E2E 测试中过度使用快照测试的问题。通过分析真实代码案例，指出快照测试虽强大但易导致意图不明、认知负担重及维护困难。文章提出将断言显式化、避免庞大重复快照等最佳实践，并对比了 Playwright 与 Jest 的策略，旨在帮助开发者提升测试可读性与效率，确保测试真正模拟用户交互。

本文档概述了 Gutenberg 项目中 Browser Mode 集成测试、快照测试、端到端 (E2E) 测试以及性能测试的完整工作流、最佳实践和故障排查指南。内容包括如何设置测试环境、处理非确定性内容、使用 Playwright 进行调试与跟踪、模拟网络/性能条件，以及针对 PHP 和 JavaScript 的具体测试命令。

本文档规定了在 Gutenberg 项目中使用 Playwright 编写端到端测试的规范与最佳实践。内容涵盖禁用不推荐 API、使用无障碍选择器、采用严格模式选择器、利用页面对象模型组织代码、通过 REST API 管理状态、避免全局变量以及进行显式断言等关键策略，旨在提升测试质量与可维护性。

本文详细介绍 React Native 集成测试指南，涵盖使用 Jest 库对编辑器组件进行集成的完整流程。内容包括测试设置、组件渲染策略、基于用户视角的无障碍元素查询、事件触发与模拟、行为断言及清理步骤。同时提供辅助函数、常见操作流程、调试工具如 Accessibility Inspector 的使用说明，并列举了开发中常见的陷阱与注意事项，帮助开发者编写高效稳定的集成测试。

本文档深入解析 WordPress 区块编辑器中的样式概念，涵盖 HTML、CSS、区块样式、全局样式及布局样式的生成机制。文章面向区块作者与项目参与者，详解 theme.json 数据整合、样式表构建流程、用户操作对样式的影响，以及区块支持 API 在序列化样式中的应用与限制，帮助开发者构建一致且可定制的编辑体验。

Vitest 是一个用于测试的框架，支持 Node.js、jsdom 和 Browser Mode 等环境。它提供了丰富的配置选项和调试功能，适用于单元测试和端到端（E2E）测试。

Interactivity API 是 WordPress 的一项功能，允许在客户端导航（不重新加载整个页面）时保持交互式元素的状态和行为。它通过预加载脚本模块、管理服务器状态与客户端状态的合并、以及处理复杂的导航生命周期来实现无缝的用户体验。

本文深入解析区块编辑器的数据模型，探讨其如何在内存中通过语义一致的区块对象树表示文章。重点介绍利用 HTML 注释作为定界符进行序列化和解析的机制，确保内容与旧系统兼容。同时阐述了从保存文档到重建区块树的工作流程，以及动态区块的处理方式，为理解现代内容编辑架构提供清晰视角。

这是一个关于代码风格指南的文档片段，主要涵盖了 JavaScript/TypeScript、React 和 PHP 的编码规范。

@wordpress/deprecated 是 WordPress Gutenberg 项目的独立包，用于记录已弃用功能的警告消息。该工具假设代码运行在 ES2015+ 环境中，若环境支持有限需添加 polyfill。它提供钩子操作通知开发人员，并在单元测试中配合 Vitest 管理控制台警告，确保测试独立性，防止重复记录或干扰后续测试。