Fetch API
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2017年3月.
* Some parts of this feature may have varying levels of support.
Fetch API 提供了一個能獲取包含跨網路資源在的資源介面。它有點像我們所熟悉的 XMLHttpRequest ,但這個新的 API 提供了更強更彈性的功能。
概念與應用
Fetch 提供了 Request 與 Response 物件,還有其他牽涉網路請求的通用定義。這能讓他們在需要的時候被使用到,不管是 service worker、Cache API、還是其他處理或更動請求回應的相類事物、或是任何需要產生有序化產生回應的用例(use case)。
它也提供了諸如 CORS 與 HTTP origin 標頭語意的分散定義,能取代分散的定義。
要發動請求並取得資源的話,請使用 GlobalFetch.fetch 方法。他實作了數種介面,並指定了 Window 與 WorkerGlobalScope,使它可以在任何想獲取資源的環境中使用。
fetch() 方法有一個強制性的參數,就是要取得資源的網址。該方法會回傳一個不論請求成敗,都會 resolve 的 promise 回應。你也能選擇性地使用第二個稱為 init 的物件參數(請參見 Request)。
當 Response 檢索後,在請求體裡面會定義一些請求體為何,還有要如何處理的方法(請參見 Body)。
你也可以直接用 Request() 與 Response() 建構子來建立請求與回應,不過你不太可能直接使用他,反而更可能是以其他 API 行動的結果為形式存在。(例如來自 service worker 的 FetchEvent.respondWith)
備註: 你可以在使用 Fetch深入理解 Fetch,並在Fetch 的基本概念文章內理解概念。
中斷一次 Fetch
各家瀏覽器已經開始加入 AbortController 與 AbortSignal 介面(也就是 Abort API)的實驗性支援,讓 Fetch 和 XHR 這類的操作在完成前可以被中斷。詳情請參閱相關介面的文件。
Fetch 介面
Fetch mixin
Body-
提供請求/回應訊息體的相關方法,能宣告內容的類別為何,以及該如何處理。
規範
| Specification |
|---|
| Fetch> # fetch-method> |
瀏覽器相容性
Loading…