JavaScript Promise finally() Method

Last Updated : 17 Oct, 2024

The finally() method of the Promise object is used to return a callback when a Promise is settled (either fulfilled or rejected).

Syntax:

task.finally(onFinally() {
});

Parameters:

This method has a single parameter as mentioned above and described below:

onFinally: It is the function that will be called when the Promise is settled.

Return Value:

It returns a Promise whose finally handler is set to the specified function.

Example: The below example demonstrates the finally() method:

JavaScript

// Define the Promise
let task = new Promise((resolve, reject) => {
    setTimeout(() => {

        // Reject the Promise
        reject("Promise has been rejected!");
    }, 2000);
});

task
    .then(
        (data) => {
            console.log(data);
        },

        // Handle any error
        (error) => {
            console.log("Error:", error);
        }
    )

    // Specify the code to be executed 
    // after the Promise is settled
    .finally(() => {
        console.log(
            "This is finally() block that is " +
            "executed after Promise is settled"
        );
    });

Output:

Error: Promise has been rejected!
This is finally() block that is executed after Promise is settled

Supported Browsers:

Chrome
Edge
Firefox
Safari
Opera

N

naman9071

Improve

Article Tags :

Similar Reads

JavaScript Promise constructor

JavaScript Promises are used to handle asynchronous operations in JavaScript. They are easy to manage when dealing with multiple asynchronous operations where callbacks can create callback hell leading to unmanageable code. Promise constructor in JavaScript is mainly used to wrap functions that do n

JavaScript Promise constructor Property

JavaScript Promise constructor property is used to return the Promise constructor function for the object. The function which is returned by this property is just a reference to this function, not a Promise containing the function's name. The JavaScript number constructor, string constructor, and bo

JavaScript Promise all() Method

The Promise.all() method in JavaScript is used for handling multiple asynchronous operations simultaneously. It takes an array (or any iterable) of promises and returns a single promise that resolves when all the input promises resolve or reject if any one of the promises fails. This makes it ideal

JavaScript Promise allSettled() Method

Promise.allSettled() method in JavaScript is used to handle multiple promises concurrently and return a single promise. This promise is fulfilled with an array of promise state descriptors, each describing the outcome of the corresponding promise in the input array. Unlike Promise.all(), Promise.all

JavaScript Promise race() Method

The Promise.race() method returns a promise that fulfills or rejects as soon as one of the promises in an iterable fulfills or rejects, with the value or reason from that promise. We may think of this particular method as in the form of a real-life example where several people are running in a race

JavaScript promise reject() Method

The Promise.reject() method is used to return a rejected Promise object with a given reason for rejection. It is used for debugging purposes and selective error-catching. The catch() method can be used for logging the output of the reject() method to the console that is catch() method acts as a care

JavaScript promise resolve() Method

The Promise.resolve() method in JavaScript returns a Promise object that is resolved with a given value. If the value is a promise, it returns that promise; otherwise, it resolves the value as a new promise, making it useful for simplifying asynchronous code handling. What is Promise resolve() metho

JavaScript Promise catch() Method

JavaScript Promise catch() method is called whenever a promise is rejected. This method itself returns a promise so it can also be used to chain promises. This method is used for error handling. This method is mainly used after .then to chain a promise and handle reject condition. This method intern

JavaScript Promise then() Method

JavaScript Promise then() method is called whenever a promise is resolved. It takes data from the resolved promise. It can take up to two arguments which are callback functions for the fulfilled and rejected cases respectively. Just like the catch() method it also returns a Promise so it is used to

JavaScript Promise finally() Method

The finally() method of the Promise object is used to return a callback when a Promise is settled (either fulfilled or rejected). Syntax:task.finally(onFinally() { });Parameters: This method has a single parameter as mentioned above and described below: onFinally: It is the function that will be cal