用途:面向 React Native 的单元与组件测试,基于 Jest + RNTL。端到端真机/模拟器 UI 流程建议用 Maestro(声明式 YAML,无需代码,针对已构建应用运行),两者互补而非替代。
版本差异:v13 与 v14 的 API 签名、同步/异步行为与可用函数不同。应先查看项目 package.json 中 @testing-library/react-native 的版本再加载对应参考:v14.x 对应 React 19+、异步 API、test-renderer;v13.x 对应 React 18+、同步 API、react-test-renderer。
核心参考主题:核心模式(查询优先级、render/screen、userEvent 与 fireEvent、waitFor、11 条核心规则);v13 API(同步 render、完整方法表、同步 fireEvent、React 19 兼容垫片);v14 API(异步 render、基于 await 的 API、已移除 API、v13→v14 迁移 codemod);反模式(错误查询、waitFor 误用、不必要的 act、解构、缺少 await)。
关键建议:查询始终用 screen,不要从 render() 解构;优先 getByRole 并带 { name: '...' } 选项;异步元素用 findBy*,而非 waitFor + getBy*;交互优先 userEvent 而非 fireEvent;queryBy* 仅用于不存在断言(.not.toBeOnTheScreen());v14 中每个 API 都要 await(包括 render、fireEvent、act)。
限制:资料未提供具体安装命令、配置步骤、收费与平台信息。