Fetch API 提供了一個 JavaScript接口,用於訪問和操縱HTTP管道的部分,例如請求和響應。它還提供了一個全局 fetch()方法,該方法提供了一種簡單,合乎邏輯的方式來跨網絡異步獲取資源。本文將詳細介紹fetch的相關內容html
跨網絡異步獲取資源的功能之前是使用 XMLHttpRequest實現的。Fetch提供了一個更好的替代方法,能夠很容易地被其餘技術使用,例如 Service Workers。Fetch還提供了單個邏輯位置來定義其餘HTTP相關概念,例如 CORS和HTTP的擴展react
fetch 規範與 jQuery.ajax() 主要有兩種方式的不一樣ajax
一、當接收到一個表明錯誤的 HTTP 狀態碼時,從 fetch()返回的 Promise 不會被標記爲 reject, 即便該 HTTP 響應的狀態碼是 404 或 500。相反,它會將 Promise 狀態標記爲 resolve (可是會將 resolve 的返回值的 ok 屬性設置爲 false ), 僅當網絡故障時或請求被阻止時,纔會標記爲 rejectjson
二、默認狀況下, fetch 不會從服務端發送或接收任何 cookies,若是站點依賴於用戶 session,則會致使未經認證的請求(要發送 cookies,必須設置 credentials 選項)數組
一個基本的 fetch請求設置起來很簡單。這裏咱們經過網絡獲取一個圖像並將其插入到一個 <img> 元素中。最簡單的用法是隻提供一個參數用來指明想fetch到的資源路徑,而後返回一個包含響應結果的promise(一個 Response 對象)promise
let myImage = document.querySelector('img'); fetch('flowers.jpg') .then(function(response) { return response.blob(); }) .then(function(myBlob) { let objectURL = URL.createObjectURL(myBlob); myImage.src = objectURL; });
fetch() 接受第二個可選參數,一個能夠控制不一樣配置的 init 對象:服務器
var myHeaders = new Headers(); var myInit = { method: 'GET', headers: myHeaders, mode: 'cors', cache: 'default' }; fetch('flowers.jpg',myInit) .then(function(response) { return response.blob(); }) .then(function(myBlob) { var objectURL = URL.createObjectURL(myBlob); myImage.src = objectURL; });
// 經過fetch獲取百度的錯誤提示頁面 fetch('https://www.baidu.com/search/error.html', { method: 'POST', body: JSON.stringify({a:1}), headers: { ...new Headers(headers), 'Content-Type': 'application/json' } }) .then((res)=>{ return res.text() }) .then((res)=>{ console.log(res) })
// 經過fetch獲取百度的錯誤提示頁面 fetch('https://www.baidu.com/rec?platform=wise&ms=1&rset=rcmd&word=123&qid=11327900426705455986&rq=123&from=844b&baiduid=A1D0B88941B30028C375C79CE5AC2E5E%3AFG%3D1&tn=&clientWidth=375&t=1506826017369&r=8255', { // 在URL中寫上傳遞的參數 method: 'GET', headers: new Headers({ 'Accept': 'application/json' // 經過頭指定,獲取的數據類型是JSON }) }) .then((res)=>{ return res.json() // 返回一個Promise,能夠解析成JSON }) .then((res)=>{ console.log(res) // 獲取JSON數據 })
若是遇到網絡故障,fetch() promise 將會 reject,帶上一個 TypeError 對象。雖然這個狀況常常是遇到了權限問題或相似問題——好比 404 不是一個網絡故障。想要精確的判斷 fetch() 是否成功,須要包含 promise resolved 的狀況,此時再判斷 Response.ok 是否是爲 truecookie
fetch('flowers.jpg').then(function(response) { if(response.ok) { response.blob().then(function(myBlob) { var objectURL = URL.createObjectURL(myBlob); myImage.src = objectURL; }); } else { console.log('Network response was not ok.'); } }) .catch(function(error) { console.log('There has been a problem with your fetch operation: ' + error.message); });
使用 Headers 的接口,能夠經過 Headers() 構造函數來建立一個本身的 headers 對象。一個 headers 對象是一個簡單的多名值對:網絡
var content = "Hello World"; var myHeaders = new Headers(); myHeaders.append("Content-Type", "text/plain"); myHeaders.append("Content-Length", content.length.toString()); myHeaders.append("X-Custom-Header", "ProcessThisImmediately");
也能夠傳一個多維數組或者對象字面量:session
myHeaders = new Headers({ "Content-Type": "text/plain", "Content-Length": content.length.toString(), "X-Custom-Header": "ProcessThisImmediately", });
它的內容能夠被獲取:
console.log(myHeaders.has("Content-Type")); // true console.log(myHeaders.has("Set-Cookie")); // false myHeaders.set("Content-Type", "text/html"); myHeaders.append("X-Custom-Header", "AnotherValue"); console.log(myHeaders.get("Content-Length")); // 11 console.log(myHeaders.getAll("X-Custom-Header")); // ["ProcessThisImmediately", "AnotherValue"] myHeaders.delete("X-Custom-Header"); console.log(myHeaders.getAll("X-Custom-Header")); // [ ]
下面是筆者在react中對fetch的精簡版封裝
import { showLoading, hideLoading, showAlertText, hideAlertText } from '@/components/Alert/module' import { logout } from '@/components/Auth/module' const async = ({ dispatch, url, method, data, headers, success, fail, doHideAlert }) => { // 顯示loading dispatch(showLoading()) let fetchObj = {} if (method) { fetchObj = { method, body: JSON.stringify(data), headers: new Headers({ ...headers, 'Content-Type': 'application/json' }) } } fetch(url, fetchObj).then(res => { // 關閉loading dispatch(hideLoading()) return res.json() }).then(json => { // 成功 if (json.code === 0) { !doHideAlert && dispatch(showAlertText(json.message)) setTimeout(() => { dispatch(hideAlertText()) }, 1000) success && success(json.result) // 自定義錯誤 } else if (json.code === 1) { dispatch(showAlertText(json.message)) // 系統錯誤 } else if (json.code === 2) { dispatch(showAlertText(json.message)) fail && fail(json.err) // 認證失敗 } else if (json.code === 3) { dispatch(showAlertText(json.message)) dispatch(logout) } }).catch(() => { dispatch(showAlertText('服務器故障')) }) } export default async