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 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:

// 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