难凉热血

# 1. 前言

在实际工作项目中，服务端所有的api接口都会部署在同一个域名下，例如豆瓣电影的api接口都统一部署在https://api.douban.com下面，当我们想要获取正在热映的电影列表时可以请求https://api.douban.com/v2/movie/in_theaters；当想要获取TOP250电影列表时可以请求https://api.douban.com/v2/movie/top250等等。细心的你肯定会看到每个电影接口的前缀https://api.douban.com/v2/movie/都是相同的，只是后面的类别不同。本着能少些一行代码就少一写一行的原则，有没有什么办法只需把前缀写一次，每次请求的时候只用带上后面的类别后缀即可。答案当然是有的。

官方axios在请求配置对象中为我们提供了baseURL属性，官方文档对该属性介绍如下：

// `baseURL` will be prepended to `url` unless `url` is absolute.
// It can be convenient to set `baseURL` for an instance of axios to pass relative URLs
// to methods of that instance.
baseURL: 'https://some-domain.com/api/',
1
2
3
4

当配置了baseURL属性，它就会和之后请求传入的 url 拼接成完整的绝对地址，除非请求传入的 url 已经是绝对地址。为axios实例设置baseURL可以方便地将相对url传递给该实例的方法。

说了这么多，其实就是想表达如下意思：

const instance = axios.create({
  baseURL: "https://api.douban.com/v2/movie/",
});

instance.get("/in_theaters"); // 获取正在热映的电影列表

instance.post("/top250"); // 获取`TOP250`电影列表
1
2
3
4
5
6
7

那么接下来，我们就为我们的axios添加baseURL属性以及相关功能。

# 2. 思路分析

实现之前，我们先来理一下思路：

官方文档说：当配置了baseURL属性，它就会和之后请求传入的 url 拼接成完整的绝对地址，除非请求传入的 url 已经是绝对地址。

那么当用户配置了baseURL属性时：

  • 首先，判断传入的url是否是绝对地址，如果是，则不用和baseURL拼接；
  • 如果不是，则将baseURL与传入的url进行拼接；
  • 拼接好之后，将拼接后的url作为请求真正的url发送请求；

OK，以上就是实现思路，接下来，我们就逐步实现它。

# 3. 向请求配置对象添加属性

向请求配置对象config中添加 baseURL 属性之前，我们需要先在src/types/index.ts中的配置对象的接口类型定义AxiosRequestConfig上添加该属性的定义，如下：

export interface AxiosRequestConfig {
  // 新增
  baseURL?: string;
}
1
2
3
4

# 4. 判断传入的 url 是否为绝对地址

首先，我们先来编写一个辅助函数isAbsoluteURL，用来判断传入的url是否为绝对地址，我们在src/helpers目录下创建isAbsoluteURL.ts文件，在该文件中编写该函数，如下：

export default function isAbsoluteURL(url: string): boolean {
  // 如果URL以“<scheme>：//”或“//”（协议相对URL）开头，则该URL被视为绝对值。
  // RFC 3986将方案名称定义为以字母开头的字符序列，
  // 后跟字母，数字，加号，句点或连字符的任意组合。
  return /^([a-z][a-z\d\+\-\.]*:)?\/\//i.test(url);
}
1
2
3
4
5
6

该函数很简单，就是编写一个绝对地址的正则表达式，如果传入的url匹配该正则，则表明它是绝对地址，反之则不是。

# 5. 拼接 url

如果传入的url不是绝对地址的话，我们就需要将baseURL与传入的url进行拼接，所以我们再编写一个拼接的辅助函数combineURLs，该函数用来将baseURL与传入的url进行拼接，将拼接后的结果返回。我们在src/helpers目录下创建combineURLs.ts文件，在该文件中编写该函数，如下：

export default function combineURLs(
  baseURL: string,
  relativeURL?: string
): string {
  return relativeURL
    ? baseURL.replace(/\/+$/, "") + "/" + relativeURL.replace(/^\/+/, "")
    : baseURL;
}
1
2
3
4
5
6
7
8

在该函数中，为了统一起见，无论baseURL最后有没有/，都将其去掉，并且不管传入的url前面有没有/，也都将其去掉，最后用/将两部分连接。

OK，所有的辅助函数都实现好之后，我们就要在src/core/dispatchRequest.ts文件中的transformUrl函数中编写相关逻辑使用这两个辅助函数。

# 6. 修改 transformUrl 函数逻辑

按照第 2 章的思路分析，先判断传入的url是否是绝对地址，如果不是，则将baseURL与传入的url进行拼接；拼接好之后，将拼接后的url作为请求真正的url发送请求；如下：

function transformUrl(config: AxiosRequestConfig): string {
  let { url, params, paramsSerializer, baseURL } = config;
  if (baseURL && !isAbsoluteURL(url!)) {
    url = combineURLs(baseURL, url);
  }
  return bulidURL(url!, params, paramsSerializer);
}
1
2
3
4
5
6
7

OK，baseURL 属性以及相关逻辑就处理好了，接下来，我们就编写demo来测试下效果如何。

# 7. demo 编写

在 examples 目录下创建 baseURL目录，在 baseURL目录下创建 index.html:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <title>baseURL demo</title>
  </head>
  <body>
    <script src="/__build__/baseURL.js"></script>
  </body>
</html>
1
2
3
4
5
6
7
8
9
10

接着再创建 app.ts 作为入口文件：

import axios from "../../src/axios";

const instance = axios.create({
  baseURL: "http://192.168.1.106:3000/",
});

instance.get("/api/baseURL");

instance.get("http://192.168.1.106:3000/api/baseURL");
1
2
3
4
5
6
7
8
9

在本demo中，我们编写了两个请求，第一个请求用的是相对url，它会将baseURL与其拼接；而第二个请求时绝对url，不会再去拼接 baseURL。

接着在 server/server.js 添加新的接口路由：

// 添加baseURL属性
router.get("/api/baseURL", function(req, res) {
  res.end();
});
1
2
3
4

最后在根目录下的index.html中加上启动该demo的入口：

<li><a href="examples/baseURL">baseURL</a></li>
1

OK,我们在命令行中执行：

# 同时开启客户端和服务端
npm run server | npm start
1
2

接着我们打开 chrome 浏览器，访问 http://localhost:8000/ (opens new window) 即可访问我们的 demo 了，我们点击 baseURL，就可以看到两个请求都已经正常发出，并且打开F12中的network可以看到：第一个请求的url是通过baseURL与传入的url拼接后的结果，而第二个请求的url是原始传入的url，没有被拼接。

OK，以上就是为我们的axios添加baseURL属性，并实现了其功能。

← 30.添加axios.getUrl方法 →