Last Updated : 11 Jul, 2025
JavaScript Promises make handling asynchronous operations like API calls, file loading, or time delays easier. Think of a Promise as a placeholder for a value that will be available in the future. It can be in one of three states
Here is an example Promise to check if a number is even. If yes, it resolves; otherwise, it rejects.
JavaScript
let checkEven = new Promise((resolve, reject) => {
let number = 4;
if (number % 2 === 0) resolve("The number is even!");
else reject("The number is odd!");
});
checkEven
.then((message) => console.log(message)) // On success
.catch((error) => console.error(error)); // On failure
Note: The "resolve" and "reject" are not keywords. You can use any name that you want to give to a function.
Syntax
let promise = new Promise((resolve, reject) => {
// Perform async operation
if (operationSuccessful) {
resolve("Task successful");
} else {
reject("Task failed");
}
});
Let's See Advanced Promise Methods and Patterns for Effective Async Handling
1. Promise.all() MethodWaits for all promises to resolve and returns their results as an array. If any promise is rejected, it immediately rejects.
JavaScript
Promise.all([
Promise.resolve("Task 1 completed"),
Promise.resolve("Task 2 completed"),
Promise.reject("Task 3 failed")
])
.then((results) => console.log(results))
.catch((error) => console.error(error));
Output
Task 3 failed2. Promise.allSettled() Method
Waits for all promises to settle (fulfilled or rejected) Method and returns an array of their outcomes.
JavaScript
Promise.allSettled([
Promise.resolve("Task 1 completed"),
Promise.reject("Task 2 failed"),
Promise.resolve("Task 3 completed")
])
.then((results) => console.log(results));
[ { status: 'fulfilled', value: 'Task 1 completed' }, { status: 'rejected', reason: 'Task 2 failed' }, { status: 'fulfilled', value: 'Task 3 completed' } ]3. Promise.race() Method
Promise.race() Method resolves or rejects as soon as the first promise settles.
JavaScript
Promise.race([
new Promise((resolve) =>
setTimeout(() =>
resolve("Task 1 finished"), 1000)),
new Promise((resolve) =>
setTimeout(() =>
resolve("Task 2 finished"), 500)),
]).then((result) =>
console.log(result));
Output
Task 2 finished4. Promise.any() Method
Promise.any() Method resolves with the first fulfilled promise. If all are rejected, it rejects with an AggregateError.
JavaScript
Promise.any([
Promise.reject("Task 1 failed"),
Promise.resolve("Task 2 completed"),
Promise.resolve("Task 3 completed")
])
.then((result) => console.log(result))
.catch((error) => console.error(error));
5. Promise.resolve() Method
Promise.resolve() Method returns a promise that resolves with the given value.
JavaScript
Promise.resolve("Immediate success")
.then((value) => console.log(value));
6. Promise.reject() Method
Promise.reject() Method returns a promise that immediately rejects with a given reason.
JavaScript
Promise.reject("Immediate failure")
.catch((error) => console.error(error));
Output:
Immediate failure7. Promise.finally() Method
Promise.finally() Method runs a cleanup or final code block regardless of the promise’s result (fulfilled or rejected).
JavaScript
Promise.resolve("Task completed")
.then((result) => console.log(result))
.catch((error) => console.error(error))
.finally(() => console.log("Cleanup completed"));
Task completed Cleanup completed8. Chaining with Promise.prototype.then() Method
Allows sequential execution of promises, passing results to the next .then() Method.
JavaScript
Promise.resolve(5)
.then((value) => value * 2) // Multiplies by 2
.then((value) => value + 3) // Adds 3
.then((finalValue) => console.log(finalValue)); // Logs: 13
9. Sequential Execution with Array.prototype.reduce() JavaScript
let tasks = [1, 2, 3];
tasks.reduce((prevPromise, current) => {
return prevPromise.then(() => {
return new Promise((resolve) => {
console.log(`Processing task ${current}`);
setTimeout(resolve, 500); // Simulate async task
});
});
}, Promise.resolve());
Output
Processing task 110. Dynamic Promise Creation
Processing task 2
Processing task 3
Creating and resolving promises dynamically for runtime-based decisions.
JavaScript
function asyncTask(taskName) {
return new Promise((resolve) => {
setTimeout(() =>
resolve(`${taskName} completed`), 1000);
});
}
asyncTask("Download File").then((result) =>
console.log(result));
Output:
Download File completed11. Timeout Handling with Promise.race() Method
Using Promise.race() Method to set a timeout for a task.
JavaScript
let fetchData = new Promise((resolve) =>
setTimeout(() =>
resolve("Data loaded"), 3000));
let timeout = new Promise((_, reject) =>
setTimeout(() =>
reject("Timeout!"), 2000));
Promise.race([fetchData, timeout])
.then((result) =>
console.log(result))
.catch((error) =>
console.error(error));
Output
Timeout!12. Handling Multiple Failures with Promise.allSettled() Method
Works when you need to process all results, even if some promises fail.
JavaScript
Promise.allSettled([
Promise.resolve("Task 1 done"),
Promise.reject("Task 2 failed"),
Promise.resolve("Task 3 done")
])
.then((results) => console.log(results));
[ { status: 'fulfilled', value: 'Task 1 done' }, { status: 'rejected', reason: 'Task 2 failed' }, { status: 'fulfilled', value: 'Task 3 done' } ]13. Combining Promises with Parallel and Sequential Execution
Run some promises in parallel, then process their results sequentially.
JavaScript
Promise.all([
new Promise((resolve) =>
setTimeout(() =>
resolve("Task A done"), 1000)),
new Promise((resolve) =>
setTimeout(() =>
resolve("Task B done"), 500))
])
.then(([resultA, resultB]) => {
console.log(resultA, resultB);
return new Promise((resolve) =>
setTimeout(() => resolve("Final Task done"), 700));
})
.then((finalResult) =>
console.log(finalResult));
Output
Task A done Task B done14. Wrapping Callbacks into Promises
Final Task done
Convert callback-based async functions into promises.
JavaScript
function loadData(callback) {
setTimeout(() =>
callback("Data loaded"), 1000);
}
function promisifiedLoadData() {
return new Promise((resolve) => {
loadData((result) =>
resolve(result));
});
}
promisifiedLoadData().then((data) =>
console.log(data));
Output
Data loadedBenefits of Promises
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4