Async and Await

My notes and reminders for handling promises with async and await In Real Life.

As I see it, the gist of this is to switch to using await when working with promise-returning, asynchronous operations (such as fetch()) because it lends itself to more flexible and readable code.

The await keyword #


  • await is for use on functions which return promises (e.g. const users = await fetch('/users')).
  • It makes JavaScript wait until that promise settles and returns its result.
  • It may only be used inside async functions.
  • It’s a more elegant syntax for getting a promise‘s result than promise.then.
  • If the promise resolves successfully, it returns the result.
  • If the promise rejects, it throws the error, just as if there were a throw statement at that line.
  • That throw causes execution of the current function to stop (so the next statements won't be executed), with control passed to the first catch block in the call stack. If no catch block exists among caller functions, the program will terminate.
  • Given this “continue or throw” behaviour, wrapping an await in a try...catch is a really nice and well-suited pattern for including error handling, providing flexibility and aiding readability.

async functions #

The async function declaration (i.e. async function f()):

  • defines an asynchronous function i.e. a function whose processes run after the main call stack and can respond at its own convenience.
  • always returns a promise. (Its return value is implicitly wrapped in a resolved promise.)
  • allows us to use await.

Here’s a try...catch -based example. (NB let’s assume that we have a list of blog articles, and that function load() is triggered by clicking a “load more articles” button, and that the fetchURL endpoint returns more articles as HTML):

export default class LoadMore {

async fetchItems(url) {
const response = await fetch(url, { method: "GET" });
if (response.ok) {
return response.text();
throw new Error("Sorry, there was a problem fetching additional items.");

async load() {
const fetchURL = "https://mysite.com/products/";
try {
const newItems = await this.fetchItems(fetchURL);
// If we’re here, we know our promise fulfilled.
// Render our new HTML items into the DOM.
} catch (err) {

displayError(err) {
const errorMsgContainer = document.querySelector("[data-target='error-msg']");
errorMsgContainer.innerHTML = `<span class="error">${err}</span>`;


Here’s another example. Let’s say that we needed to wait for multiple promises to resolve:

const allUsers = async () => {
try {
let results = await Promise.all([
// we’ll get here if the promise returned by await
// resolved successfully.
// We can output a success message.
// ...
} catch (err) {

Using await within a try...catch is my favourite approach but sometimes it’s not an option because we’re at the topmost level of the code therefore not in an async function. In these cases it’s good to remember that we can call an async function and work with its returned value like any promise, i.e. using then and catch.

For example:

async function loadUser(url) {
const response = await fetch(url);
if (response.status == 200) {
const json = await response.json();
return json;
throw new Error(response.status);

.then((json) => {
// resolved promise, so do something with the json
// ...
.catch((err) => {
// then() returns a promise, so is chainable.
// rejected promise, so do something with the json
document.body.innerHTML = "foo";


External Link Bookmark Note Entry Search