5 Awesome JavaScript Promise Tricks

By  on  

The Promise API changed the game in JavaScript. We went from abusing setTimeouts and settling for synchronous operations to doing everything possible to leverage this new async API. Let's check out a handful of awesome Promise API tricks!

Cancel a fetch Request

One problem we instantly complained about with promises was not being able to cancel them. A simple promiseInstance.cancel() would have been excellent but never came. Instead we were given an API that was way more complicated:

const controller = new AbortController();
const { signal } = controller;

fetch("http://localhost:8000", { signal }).then(response => {
    console.log(`Request 1 is complete!`);
}).catch(e => {
    console.warn(`Fetch 1 error: ${e.message}`);
});

// Abort request
controller.abort();

The magic here is providing the signal with each fetch request. In the JavaScript world, we inherit difficult APIs and do wonders to abstract them, and thus we'll find a way to better abstract this API.

waitForTime & waitForever

Waiting for a duration is useful in loads of production and testing situations -- it's never ideal but always helpful. I've used two awesome functions to make my life btter:

/* Wait for milliseconds */
function waitForTime(ms) {
  return new Promise(r => setTimeout(r, ms));
}

/* Usage */
await waitForTime(200);

/* Wait Forever */
function waitForever() {
  return new Promise(r => {});
}

// Usage:
await waitForever();

Don't wait for perfect situations, wait for the time you need.

Async Array Functions

Array functions like forEach, map, and other functions are used frequently without the need for them to be synchronous. We don't think about it there's a fair amount of times we can go async with our operations.

const promises = [1, 2, 3].map(async (num) => {
  console.log(num);
});

await promises;

The difference in caring between async and sync is Promise.allSettled. Go async when you can!

then on Objects

Did you know that you can arbitrarily add a then method on objects to have them treated as a Promise?

j = { then: resolve => fetch("/").then(resolve) }

j.then(res => console.log(res));
// Response {type: "basic", url: "https://davidwalsh.name/", redirected: false, status: 200, ok: true, …}

// ... or an await...
const response = await j;
// Response {type: "basic", url: "https://davidwalsh.name/", redirected: false, status: 200, ok: true, …}

Now you know! An excellent trick most don't know about!

Detect an Async Function

Not something you would need to do often but this post is about tricks, right? If you want to detect an asynchronous function, you always can:

async function myFunction() {

}

const isAsync = myFunction.constructor.name === "AsyncFunction";

JavaScript Promises are something we every day but a broader look at them allows us to innovate! Have any Promise tricks of your own? Please share!

Recent Features

Incredible Demos

  • By
    TextboxList for MooTools and jQuery by Guillermo Rauch

    I'll be honest with you: I still haven't figured out if I like my MooTools teammate Guillermo Rauch. He's got a lot stacked up against him. He's from Argentina so I get IM'ed about 10 times a day about how great Lionel...

  • By
    MooTools 1.3 Browser Object

    MooTools 1.3 was just released and one of the big additions is the Browser object.  The Browser object is very helpful in that not only do you get information about browser type and browser versions, you can gain information about the user's OS, browser plugins, and...

Discussion

  1. I love waitForever()! I have coded and used waitForTime for quite some time now (most often with Sindre Sorhus’ delay package on npm) but it never occurred to me to make waitForever!. Definitely useful for testing.

  2. nico

    If you plan to call a function that might be async anyway you could also just test the result for a then method. Because your async function might not be a true modern async function, but maybe just return a promise.

    The waitForTime() is one of my standard async function, but I normally call it sleep(). Another one that helps throttling or waiting for a settled DOM is: await nextFrame(), as in:

    function nextFrame () {
      return new Promise(resolve => requestAnimationFrame(r));
    }
    
  3. I’m either confused about the “Async Array Functions” section, or maybe there is an error?

    const promises = [1, 2, 3].map(async (num) => {/* ... */});
    // promises is an Array
    await promises; // does not await the promises *inside the array
    
    • Yes, I’m under the same impression.

      await [promiseA, promiseB]

      is not the same as

      await Promise.all([promiseA, promiseB])

      — or is it?

  4. Macfly

    Hello David, like answer above : await is only valid **in** async fonction. Why do u use it outside, is there a trick here ?

Wrap your code in <pre class="{language}"></pre> tags, link to a GitHub gist, JSFiddle fiddle, or CodePen pen to embed!