react-recheck
v0.1.0
Published
Dev-time performance diagnostics for React & React Native: re-render tracking, per-render object/array/function recreation detection, method-call timing, FPS / jank monitoring and an in-app debug panel.
Maintainers
Readme
react-recheck
开发期性能与重渲染诊断工具,面向 React Native / React。纯 JS,无原生代码。
- 🔍 组件 re-render 追踪 — 真实渲染次数 / 耗时 / 原因(自动 JSX 插桩或
trackComponent,基于 React Profiler) - 🧱 对象/数组/函数每次重建检测 — 渲染间 props diff,指出"内容相同却每次新建引用"的 prop 与
useMemo/useCallback建议(memo 组件为何失效一目了然) - ⏱ 方法耗时检测 —
timed / timedAsync / measureSync / instrumentClass,同步异步与异常全覆盖,慢调用阈值告警 + 调用栈 - 📉 FPS / 卡顿监控 — JS 线程帧率、卡顿帧、事件循环滞后与长任务(纯 JS 实现)
带一个 App 内悬浮调试面板(渲染 / 告警 / 方法 / 性能 / 设置)。
快速开始(React Native / Expo)
import { ReactRecheckPanel, recheck } from 'react-recheck';
if (__DEV__) {
recheck.configure({ autoTrackComponents: true, slowMethodThresholdMs: 16 });
recheck.start();
}
export default function App() {
return (
<>
{/* your app */}
<ReactRecheckPanel />
</>
);
}方法计时
import { instrumentClass, timed, measureSync } from 'react-recheck';
instrumentClass(ApiClient, { name: 'Api' }); // 整类原型方法插桩
const parse = timed((raw: string) => JSON.parse(raw), 'utils.parse');
const { durationMs } = measureSync(() => doHeavy(), 'doHeavy');入口与要求
react-recheck— 完整入口(含面板);react-recheck/core— 不含 react-native UI 的核心入口。- peer:
react >= 18;react-native >= 0.71(可选,仅面板需要)。React 18/19 通用。 - 自动 JSX 插桩依赖 Metro / CommonJS 运行时;其他环境请用
trackComponent()显式追踪。 - 仅建议开发期启用(所有插桩都有开销;生产不调用
start()即零成本)。
文档
完整使用文档(安装 / 接入 / 功能详解 / API 与设置全表 / 排查配方 / FAQ):
docs/USAGE.md · 仓库总览见根目录 README.md。
MIT License
