跳到正文
本页内容

支持矩阵

拿不准某个环境能不能用时,先看这里。列出的都是当前版本实际测试并公开声明的范围,不会把一个本地示例扩大成对所有框架或浏览器的承诺。

包与运行时

范围当前支持情况
React>=19.0.0 <20.0.0
模块仅 ESM
TypeScript从类型化源码生成声明文件
Node.js工具链支持 ^22.18.0>=24.11.0;仓库固定 24.20.0
运行时依赖只有 React peer dependency

渲染方式

环境支持边界
客户端渲染 React支持
SSR 与 Hydration通过明确的服务端快照支持
React Server Components导入安全;Hook 在 Client Component 中运行
Browser Worker不是 React DOM 目标,不作支持声明
React Native尚未测试,不作支持声明

浏览器行为

Hook 会先检测自己需要的 API。matchMedia 缺失时,useMediaQuery 使用回退值;存储访问或序列化失败时,存储 Hook 保留当前值并暴露错误;事件目标不存在时,事件 Hook 跳过订阅;剪贴板访问被拒绝时,错误仍会交给调用方。

框架

框架需要支持 React 19、ESM,以及相应的客户端或 Hydration 模型。只有仓库中存在对应集成测试时,才会在这里点名声明支持。

什么时候更新这张表

只有 manifest、实现和测试一起前进,支持范围才会扩大。在那之前,上面的内容就是当前版本的公开边界。