Axios详解及用法
Axios简介
Axios是一个基于Promise的HTTP客户端,用于浏览器和Node.js环境。它提供了一个简单、方便的API来处理HTTP请求和响应,并具备多种强大的特性,使其成为现代Web开发中不可或缺的工具。
Axios的用法
1.安装Axios
在Node.js项目中,可以通过npm或yarn安装Axios。在浏览器中,可以直接通过script标签引入Axios的CDN链接。
npm install axios
或者
通过script src="https://unpkg.com/axios/dist/axios.min.js"
2.创建Axios实例
在Node.js中,可以通过new Axios()创建一个新的Axios实例;在浏览器中,可以通过axios.create()创建新的Axios实例。
const axios = require('axios');
const instance = axios.create({
baseURL: 'https://api.example.com',
timeout: 1000,
headers: {'X-Custom-Header': 'foobar'}
});
3.设置请求参数
通过Axios实例的request方法设置请求参数,如URL、请求方法、请求头等。
const config = {
method: 'get',
url: '/user/12345',
params: {
ID: 12345
}
};
4.发送请求
通过Axios实例的get、post、put、delete方法发送HTTP请求。
instance.get('/user?ID=12345')
.then(function (response) {
console.log(response.data);
})
.catch(function (error) {
console.error(error);
});
5.处理响应
通过Promise的then、catch方法处理HTTP响应。
instance.post('/user', {
firstName: 'Fred',
lastName: 'Flintstone'
})
.then(function (response) {
console.log(response.data);
})
.catch(function (error) {
console.error(error);
});
Axios的创作流程
Axios的创作流程主要包括以下几个步骤:
- 需求分析:确定需要实现的HTTP请求类型和特性,如GET、POST、PUT、DELETE等。
- 实例创建:根据需求创建一个或多个Axios实例,并配置公共参数。
- 请求配置:设置请求的参数、头部信息等。
- 发送请求:通过实例的方法发送HTTP请求。
- 处理响应:使用Promise的then、catch方法处理响应数据或错误。
Axios的优缺点
优点:
- 基于Promise:Axios的所有函数都返回一个Promise对象,支持async/await语法,使得异步操作更加简洁明了。
- 请求和响应拦截:可以在请求被发送之前或响应被处理之前进行修改,非常适用于添加公共头部信息、处理错误响应等场景。
- 自动转换JSON数据:Axios在默认情况下会将请求的数据转化为JSON格式,同时也会自动将响应的数据从JSON转化为JavaScript对象。
- 支持取消请求:提供了取消正在进行的请求的功能。
- 客户端支持防止CSRF/XSRF:Axios在某些情况下可以自动设置XSRF-TOKEN HTTP header,增加应用安全性。
缺点:
- 体积相对较大:与一些轻量级的HTTP库相比,Axios的体积稍大,但考虑到其丰富的功能和良好的兼容性,这一点是可以接受的。
- 学习成本:对于初学者来说,可能需要一定的时间来熟悉Axios的API和特性。
代码案例
const [type5Response, type0Response, type1Response] = await Promise.all([
// 获取文件夹(type=5)
axios.get(baseurl + `/netdisk-prod-api/out/list?pageNum=1&pageSize=10&type=5&parentId=${categoryId}`),
// 获取图片(type=0)
axios.get(baseurl + `/netdisk-prod-api/out/list?pageNum=1&pageSize=10&type=0&parentId=${categoryId}`),
// 获取视频(type=1)
axios.get(baseurl + `/netdisk-prod-api/out/list?pageNum=1&pageSize=10&type=1&parentId=${categoryId}`)
]);
// 处理文件夹内容
await Promise.all(type5Response.data.rows.map(async (item) => {
const mediaDiv = document.createElement('div');
mediaDiv.className = 'grid-item album';
try {
// 获取文件夹内容
const response = await axios.get(baseurl + `/netdisk-prod-api/out/list?pageNum=1&pageSize=10&parentId=${item.id}`);
const subItems = response.data.rows;
}catch (error) {
console.error('Error processing folder:', error);
}
}));
发送GET请求
点击查看代码
axios.get('/user?ID=12345')
.then(function (response) {
console.log(response.data);
})
.catch(function (error) {
console.error(error);
});
解释:
axios.get:发送GET请求。
'/user?ID=12345':请求的URL和参数。
.then(function (response) {...}):处理成功响应。
.catch(function (error) {...}):处理错误响应。
发送POST请求
点击查看代码
axios.post('/user', {
firstName: 'Fred',
lastName: 'Flintstone'
})
.then(function (response) {
console.log(response.data);
})
.catch(function (error) {
console.error(error);
});
解释:
axios.post:发送POST请求。
'/user':请求的URL。
{firstName: 'Fred', lastName: 'Flintstone'}:请求的数据。
.then(function (response) {...}):处理成功响应。
.catch(function (error) {...}):处理错误响应。
使用拦截器
点击查看代码
axios.interceptors.request.use(function (config) {
// 在发送请求之前做些什么,例如添加公共头部信息
config.headers['Authorization'] = 'Bearer token';
return config;
}, function (error) {
// 对请求错误做些什么
return Promise.reject(error);
});
axios.interceptors.response.use(function (response) {
// 对响应数据做点什么,例如进行数据加密、解密等
return response;
}, function (error) {
// 对响应错误做点什么
return Promise.reject(error);
});
解释:
axios.interceptors.request.use:添加请求拦截器。
axios.interceptors.response.use:添加响应拦截器。
在请求拦截器中,可以修改请求的配置,如添加头部信息。
在响应拦截器中,可以修改响应的数据或处理错误。
Axios的使用场景
- 前端与后端通信:Axios是前端与后端通信的常用工具,可以方便地发送各种HTTP请求并处理响应。
- RESTful API调用:在调用RESTful API时,Axios提供了简洁明了的API,使得请求和响应的处理更加简单。
- 跨域请求:在需要跨域请求时,Axios可以配合CORS(跨源资源共享)机制实现跨域通信。
- 数据上传与下载:在文件上传和下载时,Axios可以方便地处理文件数据,并支持进度监控等功能。
- 错误处理与重试机制:Axios提供了强大的错误处理机制,并可以配合重试机制实现更加健壮的请求处理。