pax_global_header00006660000000000000000000000064140260264020014506gustar00rootroot0000000000000052 comment=dbb07ce70ef0638bd2da50af128890ba1d51ef82 queue-microtask-1.2.3/000077500000000000000000000000001402602640200146275ustar00rootroot00000000000000queue-microtask-1.2.3/.github/000077500000000000000000000000001402602640200161675ustar00rootroot00000000000000queue-microtask-1.2.3/.github/FUNDING.yml000066400000000000000000000000631402602640200200030ustar00rootroot00000000000000github: feross custom: https://feross.org/support/ queue-microtask-1.2.3/.gitignore000066400000000000000000000000261402602640200166150ustar00rootroot00000000000000node_modules .DS_Storequeue-microtask-1.2.3/.npmignore000066400000000000000000000000311402602640200166200ustar00rootroot00000000000000.travis.yml .github test queue-microtask-1.2.3/.travis.yml000066400000000000000000000000771402602640200167440ustar00rootroot00000000000000language: node_js node_js: - 6 - 8 - 10 - 12 - lts/* queue-microtask-1.2.3/LICENSE000077500000000000000000000020711402602640200156370ustar00rootroot00000000000000The MIT License (MIT) Copyright (c) Feross Aboukhadijeh Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. queue-microtask-1.2.3/README.md000066400000000000000000000127741402602640200161210ustar00rootroot00000000000000# queue-microtask [![travis][travis-image]][travis-url] [![npm][npm-image]][npm-url] [![downloads][downloads-image]][downloads-url] [![javascript style guide][standard-image]][standard-url] [travis-image]: https://img.shields.io/travis/feross/queue-microtask/master.svg [travis-url]: https://travis-ci.org/feross/queue-microtask [npm-image]: https://img.shields.io/npm/v/queue-microtask.svg [npm-url]: https://npmjs.org/package/queue-microtask [downloads-image]: https://img.shields.io/npm/dm/queue-microtask.svg [downloads-url]: https://npmjs.org/package/queue-microtask [standard-image]: https://img.shields.io/badge/code_style-standard-brightgreen.svg [standard-url]: https://standardjs.com ### fast, tiny [`queueMicrotask`](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/queueMicrotask) shim for modern engines - Use [`queueMicrotask`](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/queueMicrotask) in all modern JS engines. - No dependencies. Less than 10 lines. No shims or complicated fallbacks. - Optimal performance in all modern environments - Uses `queueMicrotask` in modern environments - Fallback to `Promise.resolve().then(fn)` in Node.js 10 and earlier, and old browsers (same performance as `queueMicrotask`) ## install ``` npm install queue-microtask ``` ## usage ```js const queueMicrotask = require('queue-microtask') queueMicrotask(() => { /* this will run soon */ }) ``` ## What is `queueMicrotask` and why would one use it? The `queueMicrotask` function is a WHATWG standard. It queues a microtask to be executed prior to control returning to the event loop. A microtask is a short function which will run after the current task has completed its work and when there is no other code waiting to be run before control of the execution context is returned to the event loop. The code `queueMicrotask(fn)` is equivalent to the code `Promise.resolve().then(fn)`. It is also very similar to [`process.nextTick(fn)`](https://nodejs.org/api/process.html#process_process_nexttick_callback_args) in Node. Using microtasks lets code run without interfering with any other, potentially higher priority, code that is pending, but before the JS engine regains control over the execution context. See the [spec](https://html.spec.whatwg.org/multipage/timers-and-user-prompts.html#microtask-queuing) or [Node documentation](https://nodejs.org/api/globals.html#globals_queuemicrotask_callback) for more information. ## Who is this package for? This package allows you to use `queueMicrotask` safely in all modern JS engines. Use it if you prioritize small JS bundle size over support for old browsers. If you just need to support Node 12 and later, use `queueMicrotask` directly. If you need to support all versions of Node, use this package. ## Why not use `process.nextTick`? In Node, `queueMicrotask` and `process.nextTick` are [essentially equivalent](https://nodejs.org/api/globals.html#globals_queuemicrotask_callback), though there are [subtle differences](https://github.com/YuzuJS/setImmediate#macrotasks-and-microtasks) that don't matter in most situations. You can think of `queueMicrotask` as a standardized version of `process.nextTick` that works in the browser. No need to rely on your browser bundler to shim `process` for the browser environment. ## Why not use `setTimeout(fn, 0)`? This approach is the most compatible, but it has problems. Modern browsers throttle timers severely, so `setTimeout(…, 0)` usually takes at least 4ms to run. Furthermore, the throttling gets even worse if the page is backgrounded. If you have many `setTimeout` calls, then this can severely limit the performance of your program. ## Why not use a microtask library like [`immediate`](https://www.npmjs.com/package/immediate) or [`asap`](https://www.npmjs.com/package/asap)? These packages are great! However, if you prioritize small JS bundle size over optimal performance in old browsers then you may want to consider this package. This package (`queue-microtask`) is four times smaller than `immediate`, twice as small as `asap`, and twice as small as using `process.nextTick` and letting the browser bundler shim it automatically. Note: This package throws an exception in JS environments which lack `Promise` support -- which are usually very old browsers and Node.js versions. Since the `queueMicrotask` API is supported in Node.js, Chrome, Firefox, Safari, Opera, and Edge, **the vast majority of users will get optimal performance**. Any JS environment with `Promise`, which is almost all of them, also get optimal performance. If you need support for JS environments which lack `Promise` support, use one of the alternative packages. ## What is a shim? > In computer programming, a shim is a library that transparently intercepts API calls and changes the arguments passed, handles the operation itself or redirects the operation elsewhere. – [Wikipedia](https://en.wikipedia.org/wiki/Shim_(computing)) This package could also be described as a "ponyfill". > A ponyfill is almost the same as a polyfill, but not quite. Instead of patching functionality for older browsers, a ponyfill provides that functionality as a standalone module you can use. – [PonyFoo](https://ponyfoo.com/articles/polyfills-or-ponyfills) ## API ### `queueMicrotask(fn)` The `queueMicrotask()` method queues a microtask. The `fn` argument is a function to be executed after all pending tasks have completed but before yielding control to the browser's event loop. ## license MIT. Copyright (c) [Feross Aboukhadijeh](https://feross.org). queue-microtask-1.2.3/index.d.ts000066400000000000000000000001171402602640200165270ustar00rootroot00000000000000declare const queueMicrotask: (cb: () => void) => void export = queueMicrotask queue-microtask-1.2.3/index.js000066400000000000000000000006221402602640200162740ustar00rootroot00000000000000/*! queue-microtask. MIT License. Feross Aboukhadijeh */ let promise module.exports = typeof queueMicrotask === 'function' ? queueMicrotask.bind(typeof window !== 'undefined' ? window : global) // reuse resolved promise, and allocate it lazily : cb => (promise || (promise = Promise.resolve())) .then(cb) .catch(err => setTimeout(() => { throw err }, 0)) queue-microtask-1.2.3/package.json000066400000000000000000000022311402602640200171130ustar00rootroot00000000000000{ "name": "queue-microtask", "description": "fast, tiny `queueMicrotask` shim for modern engines", "version": "1.2.3", "author": { "name": "Feross Aboukhadijeh", "email": "feross@feross.org", "url": "https://feross.org" }, "bugs": { "url": "https://github.com/feross/queue-microtask/issues" }, "devDependencies": { "standard": "*", "tape": "^5.2.2" }, "funding": [ { "type": "github", "url": "https://github.com/sponsors/feross" }, { "type": "patreon", "url": "https://www.patreon.com/feross" }, { "type": "consulting", "url": "https://feross.org/support" } ], "homepage": "https://github.com/feross/queue-microtask", "keywords": [ "asap", "immediate", "micro task", "microtask", "nextTick", "process.nextTick", "queue micro task", "queue microtask", "queue-microtask", "queueMicrotask", "setImmediate", "task" ], "license": "MIT", "main": "index.js", "repository": { "type": "git", "url": "git://github.com/feross/queue-microtask.git" }, "scripts": { "test": "standard && tape test/*.js" } } queue-microtask-1.2.3/test/000077500000000000000000000000001402602640200156065ustar00rootroot00000000000000queue-microtask-1.2.3/test/basic.js000066400000000000000000000013311402602640200172230ustar00rootroot00000000000000const test = require('tape') const queueMicrotask = require('../') test('basic test', t => { t.plan(1) queueMicrotask(() => t.pass('function was called')) }) test('ensure correct ordering', t => { t.plan(3) let order = 0 queueMicrotask(() => { t.equal(++order, 1) queueMicrotask(() => t.equal(++order, 2)) }) setTimeout(() => t.equal(++order, 3), 0) }) test('error handling', t => { t.plan(2) process.on('uncaughtException', onUncaughtException) function onUncaughtException (err) { t.equal(err.message, 'some error') process.removeListener('uncaughtException', onUncaughtException) } queueMicrotask(() => { t.pass('function called') throw new Error('some error') }) })