React Native中setTimeout内Promise解析比设定延迟快300ms的原因

可能的原因 #

• 时间源不一致：Date.now()依赖系统时钟（可能受NTP同步、用户手动调整等影响），而React Native里的setTimeout底层调用原生平台定时器，其计时基于JS引擎的单调时钟（比如performance.now()使用的时钟）。两者若存在固定偏移，就会导致计算出的耗时和预期不符。
• 调试模式干扰：Debug模式下，React Native开启的JS与原生通信桥接、Fast Refresh等功能会引入时间计算偏差；若开启远程调试（Chrome DevTools），JS代码在浏览器环境运行，时间源和设备原生定时器完全不同，偏移会更明显。
• JS引擎初始化偏差：部分JS引擎（如Hermes）在初始化时，原生层和JS层的时间戳未完全校准，导致固定时间差被计入耗时计算。

解决办法 #

1. 改用performance.now()计时
   performance.now()是单调递增的时间戳，不受系统时钟调整影响，且和JS引擎定时器的时间源一致，能更准确计算异步操作耗时。修改你的timeExecution函数：

export const timeExecution = async (functionUnderTest: () => void | Promise<void>,
                                    numberOfExecutions: number) : Promise<number[]> => {
    let executionTimesMilli: number[] = [];

    for (let i = 0; i < numberOfExecutions; i++) {
        console.log("EXECUTING CALL NUMBER: ", i);
        const startTimeMilli = performance.now(); // 替换为performance.now()

        await functionUnderTest();

        const endTimeMilli = performance.now(); // 替换为performance.now()

        const elaspedTimeMilli = endTimeMilli - startTimeMilli;
        executionTimesMilli.push(elaspedTimeMilli);
    }

    return executionTimesMilli; // 无需额外包裹Promise
};

2. 在Release模式下测试
   Debug模式的调试机制会干扰时间计算，打包成Release版本后再测试，偏移大概率会消失。

3. 手动校准时间偏移
   若必须使用Date.now()，可在应用启动时记录Date.now()与performance.now()的差值，后续用该差值修正计时结果：

// 应用启动时执行一次
const timeOffset = Date.now() - performance.now();

// 修正后的耗时计算
const startTimeMilli = Date.now();
await functionUnderTest();
const endTimeMilli = Date.now();
const elapsedTimeMilli = (endTimeMilli - timeOffset) - (startTimeMilli - timeOffset);

补充说明 #

当DEFAULT_WAIT_TIME_MILLI小于300ms时偏移不明显，是因为React Native定时器存在最小精度限制，短延迟下的误差会被精度掩盖，长延迟下固定偏移的比例则更突出。

内容的提问来源于stack exchange，提问作者Jon Sharp