Promise.prototype.finally()

Syntax

p.finally(onFinally);

p.finally(function() {
   // 己結算 (己履行[fulfilled]或己拒絕[rejected])
});

Parameters

onFinally

當Promise 完畢時呼叫的Function。

Return value

返回Promise 其finally 所處理設置的指定函數 onFinally。

Description

如果您希望在 promise 完成後進行一些處理或清理，無論結果如何， finally() 都非常好用。

finally() 與 .then(onFinally, onFinally) 方法與調用非常相似，但還是存在一些差異：

• 創建內聯函數時，可以傳遞一次，而不是強制要求它兩次，或者為它創建一個變量。
•  finally 不會收到任何的結果，因為有其他確認結果更好的方法。這個函數適用於您不關心執行結果的情況，因些無需提供。
• 與Promise.resolve(2).then(() => {}, () => {})（將與之解決undefined）不同，Promise.resolve(2).finally(() => {})將解決2。
• 同樣，與Promise.reject(3).then(() => {}, () => {})（將履行undefined）不同，Promise.reject(3).finally(() => {})將被拒絕3。

Examples

let isLoading = true;

fetch(myRequest).then(function(response) {
    var contentType = response.headers.get("content-type");
    if(contentType && contentType.includes("application/json")) {
      return response.json();
    }
    throw new TypeError("Oops, we haven't got JSON!");
  })
  .then(function(json) { /* process your JSON further */ })
  .catch(function(error) { console.log(error); })
  .finally(function() { isLoading = false; });

Specifications

Browser compatibility

To contribute to this compatibility data, please write a pull request against this repository: https://github.com/mdn/browser-compat-data.

See also

• Promise
• Promise.prototype.then()
• Promise.prototype.catch()