用 RSpec/Minitest 测试 Inertia…

为 Inertia Rails 页面编写控制器/请求/集成测试时，用匹配器正确断言组件、props、flash 和延迟 props。

适用场景

解决思路

1. 在 spec/rails_helper.rb 中 require 'inertia_rails/rspec' 完成设置。
2. 对每个控制器 action 验证：正确组件用 render_component('users/index')；预期 props 用 have_props(users: satisfy { ... })；无泄漏数据用 have_no_prop(:secret)；flash 消息先 follow_redirect! 再用 have_flash(notice: '...')；延迟 props 用 have_deferred_props(:analytics)。
3. 始终使用匹配器（render_component、have_props、have_flash），不要直接访问属性（inertia.component、inertia.props[:key]）。
4. POST/PATCH/DELETE 带 redirect 后，必须先调用 follow_redirect! 再断言 flash 或 props，否则断言的是 302 响应而非 Inertia 页面。
5. 可用匹配器：be_inertia_response 验证响应为 Inertia 格式；render_component('path') 检查渲染组件名；have_props(key: value) 部分匹配 props；have_exact_props(key: value) 精确匹配 props；have_no_prop(:key) 断言 prop 不存在；have_flash(key: value) 部分匹配 flash；have_exact_flash(key: value) 精确匹配 flash；have_no_flash(:key) 断言 flash 不存在；have_deferred_props(:key) 检查延迟 props 存在；have_view_data(key: value) 部分匹配 view_data。
6. 测试共享 props：inertia_share 的共享 props 会包含在 inertia.props 中，在 type: :request 的 spec 里 require 'inertia_rails/rspec' 后可使用 inertia 辅助方法，例如 expect(inertia).to have_props(auth: hash_including(user: hash_including(id: user.id)))。
7. 测试延迟 props：用 expect(inertia).to have_deferred_props(:analytics, :statistics) 以及 have_deferred_props(:slow_data, group: :slow)。
8. 使用部分重载辅助方法：inertia_reload_only(:users, :pagination) 只获取指定 props；inertia_reload_except(:expensive_stats) 排除指定 props；inertia_load_deferred_props(:default) 加载指定组的延迟 props；inertia_load_deferred_props 加载所有组。
9. 测试外部重定向（inertia_location）：inertia_location 返回 409 并带 X-Inertia-Location 头，断言 expect(response).to have_http_status(:conflict) 和 expect(response.headers['X-Inertia-Location']).to match(/stripe\.com/)。
10. 不要测试 Inertia 框架行为（如 <Form> 是否发送 CSRF token、router.visit 是否工作），只测试自己的控制器逻辑。
11. 不要对完整 JSON 做深度相等断言，用 have_props(users: satisfy { ... }) 避免脆弱测试。
12. 不要在初始加载时断言延迟 prop 的值（初始响应中为 nil），用 have_deferred_props(:key) 验证已注册，或用 inertia_load_deferred_props 在测试中解析。
13. 不要 mock Inertia 响应，使用 type: :request 的 spec 走完整栈；type: :controller 配合 assigns 不可用，因为 Inertia 使用只在完整请求周期执行的自定义渲染管线。
14. 仅在必要时直接访问：inertia.component、inertia.props、inertia.props[:users]、inertia.flash、inertia.deferred_props。
15. 编写 Minitest 测试（非 RSpec）时，必须完整阅读 references/minitest.md（约 40 行），其中包含与上述 RSpec 匹配器等价的 Minitest 断言；RSpec 项目不要加载 minitest.md。

适用边界 · 注意事项

• 不要测试 Inertia 框架自身行为（如 <Form> 发送 CSRF token、router.visit 是否工作），只测自己的控制器逻辑。
• 不要对完整 JSON 做深度相等断言，避免因新增列而脆弱的测试。
• 不要在初始加载时断言延迟 prop 的值（初始响应中为 nil），也不要用 type: :controller 配合 assigns 或 mock Inertia 响应。