Fiber-friendly/async sleep statements
Example
1console.assert(Meteor.isServer); // Meteor.sleep (without ES7) only works on the server 2Meteor.sleep(1000); // ms
1console.assert(Meteor.isServer); // Meteor.sleepUntil (without ES7) only works on the server 2Meteor.sleepUntil(new Date(2020, 3, 1));
Why?
Meteor's fibers let you wait (i.e. during I/O) without blocking the event loop. But the greatest of all ways to wait has been unattainable until now. This package lets you sprinkle sleep statements throughout your code to convince your boss to buy better hardware. Or to rate-limit your API usage without using setTimeout.
1// Shopify wants no more than two events per second. 2var results = []; 3for (var i = 0; i < numPages; i++) { 4 Meteor.sleep(500); 5 6 var currentPage = FetchOrders(i); 7 results = results.concat(currentPage); 8} 9HandleResults(results);
Now with ES7 support
Have you ever wondered what the best ES7 feature is? Well, the answer is async/await. Here's why:
1console.assert(Meteor.isClient); // Meteor.sleep works on the client with ES7 2async function() { 3 // Do stuff 4 5 // Sleep 2 seconds 6 await Meteor.sleep(2000); 7 8 // Sleep for days 9 await Meteor.sleepUntil(new Date(2020, 3, 1)); 10 11 // Do other stuff 12}
In other words, Meteor.sleep
also works on the client now. This won't actually work until Meteor 1.3, but prepare yourself.
In a future version it should be possible to use await Meteor.sleep()
on the server for a truly isomorphic experience.
Alternatives
The real advantage is code clarity. The following examples demonstrate how this code might be written in the browser (where fibers are not available).
1// plain javascript 2var results = []; 3(function fetcher(i) { 4 if (i === 5) { 5 HandleResults(results); 6 return; 7 } 8 9 var currentPage = FetchOrders(i); 10 results = results.concat(currentPage); 11 Meteor.setTimeout(function() { 12 fetcher(i + 1); 13 }, 500); 14})(0);
1// async.js 2async.concatSeries(_.range(5), function(i, callback) { 3 var currentPage = FetchOrders(i); 4 Meteor.setTimeout(function() { 5 callback(null, currentPage); 6 }, 500); 7}, function(err, results) { 8 HandleResults(results); 9});
Setup
- Install
meteor add froatsnook:sleep
License
MIT