`@sinonjs/fake-timers`——模具行业从业者必备知识手册

system 2

<h2>@sinonjs/fake-timers</h2>

JavaScript implementation of the timer APIs; <code>setTimeout</code>, <code>clearTimeout</code>, <code>setImmediate</code>, <code>clearImmediate</code>, <code>setInterval</code>, <code>clearInterval</code>, <code>requestAnimationFrame</code>, <code>cancelAnimationFrame</code>, <code>requestIdleCallback</code>, and <code>cancelIdleCallback</code>, along with a clock instance that controls the flow of time. FakeTimers also provides a <code>Date</code> implementation that gets its time from the clock.

In addition in browser environment <code>@sinonjs/fake-timers</code> provides a <code>performance</code> implementation that gets its time from the clock. In Node environments FakeTimers provides a <code>nextTick</code> implementation that is synchronized with the clock - and a <code>process.hrtime</code> shim that works with the clock.

<code>@sinonjs/fake-timers</code> can be used to simulate passing time in automated tests and other
situations where you want the scheduling semantics, but don't want to actually
wait.

<code>@sinonjs/fake-timers</code> is extracted from <a href="https://github.com/sinonjs/sinon.js">Sinon.JS</a> and targets the <a href="https://sinonjs.org/releases/latest/#supported-runtimes">same runtimes</a>.

<h3>Autocomplete, IntelliSense and TypeScript definitions</h3>

Version 7 introduced JSDoc to the codebase. This should provide autocomplete and type suggestions in supporting IDEs. If you need more elaborate type support, TypeScript definitions for the Sinon projects are independently maintained by the Definitely Types community:

<pre><code>
npm install -D @types/sinonjs__fake-timers
</code></pre>

<h3>Installation</h3>

<code>@sinonjs/fake-timers</code> can be used in both Node and browser environments. Installation is as easy as

<pre><code>
npm install @sinonjs/fake-timers
</code></pre>

If you want to use <code>@sinonjs/fake-timers</code> in a browser you can either build your own bundle or use <a href="https://www.skypack.dev">Skypack</a>.

<h3>Usage</h3>

To use <code>@sinonjs/fake-timers</code>, create a new clock, schedule events on it using the timer
functions and pass time using the <code>tick</code> method.

<pre><code>
// In the browser distribution, a global FakeTimers is already available
var FakeTimers = require("@sinonjs/fake-timers");
var clock = FakeTimers.createClock();

clock.setTimeout(function () {
console.log(
"The poblano is a mild chili pepper originating in the state of Puebla, Mexico."
);
}, 15);

// ...

clock.tick(15);
</code></pre>

Upon executing the last line, an interesting fact about the
<a href="https://en.wikipedia.org/wiki/Poblano">Poblano</a> will be printed synchronously to
the screen. If you want to simulate asynchronous behavior, you have to use your
imagination when calling the various functions.

The <code>next</code>, <code>runAll</code>, <code>runToFrame</code>, and <code>runToLast</code> methods are available to advance the clock. See the
API Reference for more details.

<h4>Faking the native timers</h4>

When using <code>@sinonjs/fake-timers</code> to test timers, you will most likely want to replace the native
timers such that calling <code>setTimeout</code> actually schedules a callback with your
clock instance, not the browser's internals.

Calling <code>install</code> with no arguments achieves this. You can call <code>uninstall</code>
later to restore things as they were again.

<pre><code>
// In the browser distribution, a global FakeTimers is already available
var FakeTimers = require("@sinonjs/fake-timers");

var clock = FakeTimers.install();

还有什么补充参数吗？一起完善。
</code></pre>