Files
react-native/Libraries/Core/Timers/queueMicrotask.js
T
Xuan Huang be189cd819 Introduce queueMicrotask API
Summary:
Changelog:
[General][Added] - Add global.queueMicrotask

`queueMicrotask` is a relatively recent API defined in the WHATWG HTML spec
and it's been widely adopted by all web browsers and Node.js.

This diff introduced it to React Native by polyfilling it via a lazily-allocated
resolved Promise, or calling directly into a fast path provided by Hermes.

Reviewed By: RSNara

Differential Revision: D29838852

fbshipit-source-id: 8c4378b1b713fb8b0da5e67f92ba2ea9838766f7
2021-07-28 13:37:54 -07:00

42 lines
1.2 KiB
JavaScript

/**
* Copyright (c) Facebook, Inc. and its affiliates.
*
* This source code is licensed under the MIT license found in the
* LICENSE file in the root directory of this source tree.
*
* @format
* @flow
*/
'use strict';
let resolvedPromise;
/**
* Polyfill for the microtask queuening API defined by WHATWG HTMP spec.
* https://html.spec.whatwg.org/multipage/timers-and-user-prompts.html#dom-queuemicrotask
*
* The method must queue a microtask to invoke @param {function} callback, and
* if the callback throws an exception, report the exception.
*/
export default function queueMicrotask(callback: Function) {
if (arguments.length < 1) {
throw new TypeError(
'queueMicrotask must be called with at least one argument (a function to call)',
);
}
if (typeof callback !== 'function') {
throw new TypeError('The argument to queueMicrotask must be a function.');
}
// Try to reuse a lazily allocated resolved promise from closure.
(resolvedPromise || (resolvedPromise = Promise.resolve()))
.then(callback)
.catch(error =>
// Report the exception until the next tick.
setTimeout(() => {
throw error;
}, 0),
);
}