Asynchronous #"http://www.w3.org/2000/svg" fill="none" viewBox="0 0 52 14" width="52" height="14">Toptal authors are vetted experts in their fields and write on topics in which they have demonstrated experience. All of our content is peer reviewed and validated by Toptal experts in the same field.
Asynchronous programming used to be a challenge even for seasoned professionals, leading to aptly named phenomena like Callback Hell.
In this article, Toptal JavaScript Developer Demir Selmanovic explains how async functions took us out of purgatory and why you should be using them.
Demir is a developer and project manager with over 15 years of professional experience in a wide range of software development roles.
Expertise
One of the keys to writing a successful web application is being able to make dozens of AJAX calls per page.
This is a typical asynchronous programming challenge, and how you choose to deal with asynchronous calls will, in large part, make or break your app, and by extension potentially your entire startup.
Synchronizing asynchronous tasks in JavaScript was a serious issue for a very long time.
This challenge is affecting back-enddevelopers using Node.js as much as front-end developers using any JavaScript framework. Asynchronous programming is a part of our everyday work, but the challenge is often taken lightly and not considered at the right time.
A Brief History of Asynchronous JavaScript
The first and the most straightforward solution came in the form ofnested functions as callbacks. This solution led to something calledcallback hell, and too many applications still feel the burn of it.
Then, we gotPromises. This pattern made the code a lot easier to read, but it was a far cry from the Don’t Repeat Yourself (DRY) principle. There were still too many cases where you had to repeat the same pieces of code to properly manage the application’s flow.The latest addition, in the form of async/await JavaScript statements, finally madeasynchronous code in JavaScript as easy to read and write as any other piece of code.
Let’s take a look at the examples of each of these solutions and reflect on the evolution of asynchronous programming in JavaScript.
To do this, our asynchronous JavaScript tutorial will examine a simple task that performs the following steps:
- Verify the username and password of a user.
- Get application roles for the user.
- Log application access time for the user.
Approach 1: Callback Hell (“The Pyramid of Doom”)
The ancient solution to synchronize these calls was via nested callbacks. This was a decent approach for simple asynchronous JavaScript tasks, but wouldn’t scale because of an issue calledcallback hell.

The code for the three simple tasks would look something like this:
const verifyUser = function(username, password, callback){ dataBase.verifyUser(username, password, (error, userInfo) => { if (error) { callback(error) }else{ dataBase.getRoles(username, (error, roles) => { if (error){ callback(error) }else { dataBase.logAccess(username, (error) => { if (error){ callback(error); }else{ callback(null, userInfo, roles); } }) } }) } })};Each function gets an argument which is another function that is called with a parameter that is the response of the previous action.
Too many people will experience brain freeze just by reading the sentence above. Having an application with hundreds of similar code blocks will cause even more trouble to the person maintaining the code, even if they wrote it themselves.
This example gets even more complicated once you realize that adatabase.getRoles is another function that has nested callbacks.
const getRoles = function (username, callback){ database.connect((connection) => { connection.query('get roles sql', (result) => { callback(null, result); }) });};In addition to having code that is difficult to maintain, the DRY principle has absolutely no value in this case. Error handling, for example, is repeated in each function and the main callback is called from each nested function.
More complex asynchronous JavaScript operations, such as looping through asynchronous calls, is an even bigger challenge. In fact, there is no trivial way of doing this with callbacks. This is why JavaScript Promise libraries likeBluebird andQ got so much traction. They provide a way to perform common operations on asynchronous requests that the language itself doesn’t already provide.
That’s where native JavaScript Promises come in.
JavaScript Promises
Promises were the next logical step in escaping callback hell. This method did not remove the use of callbacks, but it made the chaining of asynchronous functions in JavaScript straightforward andsimplified the code, making it much easier to read.

With Promises in place, the code in our asynchronous JavaScript example would look something like this:
const verifyUser = function(username, password) { database.verifyUser(username, password) .then(userInfo => dataBase.getRoles(userInfo)) .then(rolesInfo => dataBase.logAccess(rolesInfo)) .then(finalResult => { //do whatever the 'callback' would do }) .catch((err) => { //do whatever the error handler needs });};To achieve this kind of simplicity, all of the functions used in the example would have to bePromisified. Let’s take a look at how thegetRoles method would be updated to return aPromise:
const getRoles = function (username){ return new Promise((resolve, reject) => { database.connect((connection) => { connection.query('get roles sql', (result) => { resolve(result); }) }); });};We have modified the method to return aPromise, with two callbacks, and thePromise itself performs actions from the method. Now,resolve andreject callbacks will be mapped toPromise.then andPromise.catch methods respectively.
You may notice that thegetRoles method is still internally prone to the pyramid of doom phenomenon. This is due to the way database methods are created as they do not returnPromise. If our database access methods also returnedPromise thegetRoles method would look like the following:
const getRoles = new function (userInfo) { return new Promise((resolve, reject) => { database.connect() .then((connection) => connection.query('get roles sql')) .then((result) => resolve(result)) .catch(reject) });};Approach 3: Async/Await
The pyramid of doom was significantly mitigated with the introduction of Promises. However, we still had to rely on callbacks that are passed on to.then and.catch methods of aPromise.
Promises paved the way to one of the coolest improvements in JavaScript.ECMAScript 2017 brought in syntactic sugar on top of Promises in JavaScript in the form ofasync andawait statements.
They allow us to writePromise-based code as if it were synchronous, but without blocking the main thread, as this code sample demonstrates:
const verifyUser = async function(username, password){ try { const userInfo = await dataBase.verifyUser(username, password); const rolesInfo = await dataBase.getRoles(userInfo); const logStatus = await dataBase.logAccess(userInfo); return userInfo; }catch (e){ //handle errors as needed }};AwaitingPromise to resolve is allowed only withinasync functions which means thatverifyUser had to be defined usingasync function.
However, once this small change is made you canawait anyPromise without additional changes in other methods.
Async JavaScript - A Long Awaited Resolution of a Promise
Async functions are the next logical step in the evolution of asynchronous programming in JavaScript. They will make your code much cleaner and easier to maintain. Declaring a function asasync will ensure that it always returns aPromise so you don’t have to worry about that anymore.
What doesasync do in JavaScript and why you should start using JavaScriptasync functions today?
- The resulting code is much cleaner.
- Error handling is much simpler and it relies on
try/catchjust like in any other synchronous code. - Debugging is much simpler. Setting a breakpoint inside a
.thenblock will not move to the next.thenbecause it only steps through synchronous code. But, you can step throughawaitcalls as if they were synchronous calls.
Further Reading on the Toptal Blog:
Understanding the basics
What are async and await?
Async/await statements are syntactic sugar created on top of JavaScript Promises. They allow us to write Promise-based code as if it were synchronous, but without blocking the main thread.
What is callback hell?
In JavaScript, callback hell is an anti-pattern in code that happens as a result of poor structuring of asynchronous code. It is usually seen when programmers try to force a visual top-down structure in their asynchronous callback-based JavaScript code.
What are JavaScript promises?
A promise in JavaScript is like a placeholder value that is expected to eventually resolve into the final successful result value or reason for failure.
Sarajevo, Federation of Bosnia and Herzegovina, Bosnia and Herzegovina
Member since July 8, 2014
About the author
Demir is a developer and project manager with over 15 years of professional experience in a wide range of software development roles.
Expertise
World-class articles, delivered weekly.
Trending Now
About the author
World-class articles, delivered weekly.
World-class articles, delivered weekly.
Toptal Developers
- Android Developers
- App Developers
- AWS Developers
- Azure Developers
- BigCommerce Developers
- Blockchain Developers
- Coders
- Database Developers
- Embedded Software Engineers
- Flutter Developers
- HTML5 Developers
- Java Developers
- Joomla Developers
- Kubernetes Developers
- Laravel Developers
- Magento Developers
- .NET Developers
- Next.js Developers
- Odoo Developers
- Outsourced Developers
- PHP Developers
- Power BI Developers
- Prototype Developers
- Python Developers
- React Developers
- React Native Developers
- Remote Developers
- Ruby on Rails Developers
- Salesforce Developers
- Security Engineers
- SharePoint Developers
- Shopify Developers
- Software Developers
- Squarespace Developers
- Startup Developers
- Svelte Developers
- Twilio Developers
- Vue.js Developers
- Web Developers
- Web Scrapers
- WooCommerce Developers
- WordPress Developers
- View More Freelance Developers
Join the Toptal® community.

