0. 系列文章
1.使用Typescript重構axios(一)——寫在最前面
2.使用Typescript重構axios(二)——項目起手,跑通流程
3.使用Typescript重構axios(三)——實現基礎功能:處理get請求url參數
4.使用Typescript重構axios(四)——實現基礎功能:處理post請求參數
5.使用Typescript重構axios(五)——實現基礎功能:處理請求的header
6.使用Typescript重構axios(六)——實現基礎功能:獲取響應數據
7.使用Typescript重構axios(七)——實現基礎功能:處理響應header
8.使用Typescript重構axios(八)——實現基礎功能:處理響應data
9.使用Typescript重構axios(九)——異常處理:基礎版
10.使用Typescript重構axios(十)——異常處理:增強版
11.使用Typescript重構axios(十一)——接口擴展
12.使用Typescript重構axios(十二)——增加參數
13.使用Typescript重構axios(十三)——讓響應數據支持泛型
14.使用Typescript重構axios(十四)——實現攔截器
15.使用Typescript重構axios(十五)——默認配置
16.使用Typescript重構axios(十六)——請求和響應數據配置化
17.使用Typescript重構axios(十七)——增加axios.create
18.使用Typescript重構axios(十八)——請求取消功能:總體思路
19.使用Typescript重構axios(十九)——請求取消功能:實現第二種使用方式
20.使用Typescript重構axios(二十)——請求取消功能:實現第一種使用方式
21.使用Typescript重構axios(二十一)——請求取消功能:添加axios.isCancel接口
22.使用Typescript重構axios(二十二)——請求取消功能:收尾
23.使用Typescript重構axios(二十三)——添加withCredentials屬性
24.使用Typescript重構axios(二十四)——防御XSRF攻擊
25.使用Typescript重構axios(二十五)——文件上傳下載進度監控
26.使用Typescript重構axios(二十六)——添加HTTP授權auth屬性
27.使用Typescript重構axios(二十七)——添加請求狀態碼合法性校驗
28.使用Typescript重構axios(二十八)——自定義序列化請求參數
29.使用Typescript重構axios(二十九)——添加baseURL
30.使用Typescript重構axios(三十)——添加axios.getUri方法
31.使用Typescript重構axios(三十一)——添加axios.all和axios.spread方法
32.使用Typescript重構axios(三十二)——寫在最后面(總結)
1. 前言
在實際項目開發中,前端代碼和后端代碼往往是跑在兩個不同的端口上,前端的請求要訪問后端的api
,就成了跨端口請求,也就是跨域請求。而瀏覽器為了安全起見,會根據同源策略禁止這種跨域請求。在同域的情況下,我們發送請求會默認攜帶當前域下的 cookie
,但是在跨域的情況下,由於瀏覽器的限制,默認是不會攜帶請求域下的 cookie
,而我們通常請求中是需要攜帶cookie
的,這就需要在XMLHttpRequest
對象上配置withCredentials
屬性,將其設置為true
即可,官方的axios
在請求配置對象中為我們提供了設置這一屬性的選項,接下來,我們也要在我們的axios
中提供這一選項。
添加這一選項非常簡單,我們只需在請求配置對象config
中加上該屬性,然后在發送請求時判斷是否配置了該屬性,如果配置了我們就在XMLHttpRequest
對象上將該屬性進行配置即可。
OK,接下來,我們就來實現它。
2. 修改 AxiosRequestConfig
給請求配置對象config
中添加withCredentials
屬性之前,我們需要先在src/types/index.ts
中的配置對象的接口類型定義AxiosRequestConfig
上添加該屬性的定義,如下:
export interface AxiosRequestConfig {
// 新增
withCredentials?: boolean;
}
3. 添加請求判斷邏輯
接口定義好之后,我們只需在發送請求之前,判斷用戶是否配置了該屬性,如果配置了,就把配置的屬性值添加到XMLHttpRequest
對象上即可,我們修改src/core.xhr.ts
中的xhr
函數,如下:
const { /*...*/ withCredentials } = config
if (withCredentials) {
request.withCredentials = true
}
OK,這樣withCredentials
屬性配置選項就添加好了,接下來,我們就編寫demo
來看看效果。
4. demo編寫
在 examples
目錄下創建 addWithCredentials
目錄,在 addWithCredentials
目錄下創建 index.html
:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<title>addWithCredentials demo</title>
</head>
<body>
<script src="/__build__/addWithCredentials.js"></script>
</body>
</html>
接着再創建 app.ts
作為入口文件:
import axios from "../../src/axios";
axios.post("http://192.168.1.2:3000/api/addWithCredentials", {}).then(res => {
console.log(res);
});
axios.post("http://192.168.1.2:3000/api/addWithCredentials", {}, {
withCredentials: true
}).then(res => {
console.log(res);
});
在本demo
中,我們發送兩個請求,一個請求配置了withCredentials
屬性,一個沒有。理想情況下,沒有配置withCredentials
屬性的請求就攜帶不了cookie
,自然也就接收不到服務端返回的cookie
內容;而配置了withCredentials
屬性的請求可以攜帶cookie
,那么它就可以收到服務端返回的cookie
內容。后面我們可以通過結果來驗證現在的猜測。
接着在 server/server.js
添加新的接口路由:
// 添加withCredentials
const cookieParser = require("cookie-parser");
app.use(cookieParser());
const cors = {
"Access-Control-Allow-Origin": "http://192.168.1.2:8000",
"Access-Control-Allow-Credentials": true,
"Access-Control-Allow-Methods": "POST, GET, PUT, DELETE, OPTIONS",
"Access-Control-Allow-Headers": "Content-Type"
};
router.post("/api/addWithCredentials", function(req, res) {
res.set(cors);
res.json(req.cookies);
});
router.options("/api/addWithCredentials", function(req, res) {
res.set(cors);
res.end();
});
此處切記一定要配置兩個路由接口,除了post
還有加一個options
,這是因為cors
跨域對於非簡單請求瀏覽器會先發送一個options
類型的請求來預檢請求,具體原因請看這里!
這里需要安裝一下 cookie-parser
插件,用於請求發送的 cookie
。
另外,為了形式跨域請求,我們還需要把webpack.config.js
文件中配置的webpack
跨域代理配置注釋掉,如下:
devServer: {
noInfo: true,
overlay: true,
open: true
// proxy: { // 配置跨域
// '/api/': {
// target: 'http://192.168.1.2:3000',
// ws: true,
// changOrigin: true
// },
// }
}
最后在根目錄下的index.html
中加上啟動該demo
的入口:
<li><a href="examples/addWithCredentials">addWithCredentials</a></li>
OK,我們在命令行中執行:
# 同時開啟客戶端和服務端
npm run server | npm start
接着我們打開 chrome
瀏覽器,訪問 http://localhost:8000/ 即可訪問我們的 demo
了,我們點擊 addWithCredentials
,通過F12
的 network
部分我們可以看到:兩條請求已經正常發出了,但是兩個請求返回的data
都為空,這是因為我們還沒有寫cookie
內容呢,按照下圖中的方式寫入cookie
后,在刷新頁面發送請求,我們就可以看到沒有配置withCredentials
屬性的請求返回的data
仍舊為空{}
,而配置了withCredentials
屬性的請求返回的data
已經有攜帶的cookie
內容了。
OK,添加withCredentials
屬性的功能我們就已經實現了。
(完)