这里给大家分享我在网上总结出来的一些知识，希望对大家有所帮助
我宁可查 bug 也不可能重构手里一大堆项目啊。此种方案 ❎。
此时看到了 typescript-json-schema 可以把 TypeScript 定义转为 JSON Schema ，然后再使用 JSON Schema 对数据进行校验就可以啦。这种方案比较灵活，且对代码入侵性较小。
搭建一个项目测试一下！
使用 npx create-react-app my-app --template typescript 快速创建一个 React+TS 项目。
首先安装依赖 npm install typescript-json-schema
创建类型文件 src/types/user.ts
export interface IUserInfo {
staffId: number
name: string
email: string
}
然后创建src/types/index.ts文件并引入刚才的类型。
import { IUserInfo } from ./user;
interface ILabel {
id: number;
name: string;
color: string;
remark?: string;
}
type ILabelArray = ILabel[];
type IUserInfoAlias = IUserInfo;
接下来在package.json添加脚本
"scripts": {
// ...
"json": "typescript-json-schema src/types/index.ts * -o src/types/index.json --id=api --required --strictNullChecks"
}
然后运行 npm run json 可以看到新建了一个 src/types/index.json 文件（此步在已有项目中可能会报错报错，可以尝试在 json 命令中添加 --ignoreErrors 参数），打开文件可以看到已经成功转成了 JSON Schema 格式。
{
"$id": "api",
"$schema": "http://json-schema.org/draft-07/schema#",
"definitions": {
"ILabel": {
"properties": {
"color": {
"type": "string"
},
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"remark": {
"type": "string"
}
},
"required": [
"color",
"id",
"name"
],
"type": "object"
},
"ILabelArray": {
"items": {
"$ref": "api#/definitions/ILabel"
},
"type": "array"
},
"IUserInfoAlias": {
"properties": {
"email": {
"type": "string"
},
"name": {
"type": "string"
},
"staffId": {
"type": "number"
}
},
"required": [
"email",
"name",
"staffId"
],
"type": "object"
}
}
}
使用 JSON Schema 校验数据
至于如何使用JSON Schema 校验数据，我找到了现成的库ajv，至于为什么选择 ajv，主要是因为它说它很快，详见：github.com/ebdrup/json…
接下来尝试一下。我找到了中文版文档，有兴趣的可以去看下www.febeacon.com/ajv-docs-zh…
先安装依赖npm install ajv，然后创建文件src/validate.ts
import Ajv from ajv;
import schema from ./types/index.json;
const ajv = new Ajv({ schemas: [schema] });
export function validateDataByType(type: string, data: unknown) {
console.log(`开始校验，类型：${type}， 数据：`, data);
var validate = ajv.getSchema(`api#/definitions/${type}`);
if (validate) {
const valid = validate(data);
if (!valid) {
console.log(校验失败, validate.errors);
}
else {
console.log(校验成功);
}
}
}
接下来在src/index.tsx添加下面代码来测试一下。
validateDataByType(IUserInfoAlias, {
email: idonteatcookie@gmail.com,
name: idonteatcookie,
staffId: 12306
})
validateDataByType(IUserInfoAlias, {
email: idonteatcookie@gmail.com,
staffId: 12306
})
validateDataByType(IUserInfoAlias, {
email: idonteatcookie@gmail.com,
name: idonteatcookie,
staffId: 12306
})
可以在控制台看到成功打印如下信息：
拦截请求
因为项目中发送请求都是调用统一封装的函数，所以我首先想到的是在函数中增加一层校验逻辑。但是这样的话就与项目代码耦合严重，换一个项目又要再写一份。我真的有好多项目QAQ。
那干脆拦截所有请求统一处理好了。
很容易的找到了拦截所有 XMLHttpRequest 请求的库 ajax-hook，可以非常简单地对请求做处理。
首先安装依赖 npm install ajax-hook，然后创建 src/interceptTool.ts：
import { proxy } from ajax-hook;
export function intercept() {
// 获取 XMLHttpRequest 发送的请求
proxy({
onResponse: (response: any, handler: any) => {
console.log(xhr, response.response)
handler.next(response);
},
});
}
这样就拦截了所有的XMLHttpRequest发送的请求，但是我突然想到我们的项目，好像使用fetch发送的请求来着？？？
好叭，那就再拦截一遍fetch发送的请求。
export function intercept() {
// ...
const { fetch: originalFetch } = window;
// 获取 fetch 发送的请求
window.fetch = async (...args) => {
const response = await originalFetch(...args);
response.clone().json().then((data: { result: any }) => {
console.log(window.fetch, args, data);
return data;
});
return response;
};
}
为了证明拦截成功，使用json-server搭建一个本地 mock 服务器。首先安装npm install json-server，然后在根目录创建文件db.json：
{
"user": { "staffId": 1, "name": "cookie1", "email": "cookie@cookie.com" },
"labels": [
{
"id": 1,
"name": "ck",
"color": "red",
"remark": "blabla"
},
{
"id": 2,
"color": "green"
}
]
}
再在package.json添加脚本
"scripts": {
"serve": "json-server --watch db.json -p 8000"
},
现在执行npm run serve就可以启动服务器了。在src/index.tsx增加调用接口的代码，并引入src/interceptTool.ts。
import { intercept } from ./interceptTool;
// ... other code
intercept();
fetch(http://localhost:8000/user);
const xhr = new XMLHttpRequest();
xhr.open(GET, http://localhost:8000/labels);
xhr.send();
可以看到两种请求都拦截成功了。
校验接口返回数据
胜利在望，只差最后一步，校验返回数据。我们校验数据需要提供两个关键信息，数据本身和对应的类型名，为了将两者对应起来，需要再创建一个映射文件，把 url 和类型名对应起来。
创建文件 src/urlMapType.ts 然后添加内容
export const urlMapType = {
http://localhost:8000/user: IUserInfoAlias,
http://localhost:8000/labels: ILabelArray,
}
我们在src/validate.ts新增函数validateDataByUrl
import { urlMapType } from ./urlMapType;
// ...
export function validateDataByUrl(url: string, data: unknown) {
const type = urlMapType[url as keyof typeof urlMapType];
if (!type) {
// 没有定义对应格式不进行校验
return;
}
console.log(`==== 开始校验 === url ${url}`);
validateDataByType(type, data);
}
然后在src/interceptTool.ts文件中引用
import { proxy } from ajax-hook;
import { validateDataByUrl } from ./validate;
export function intercept() {
// 获取 XMLHttpRequest 发送的请求
proxy({
onResponse: (response, handler: any) => {
validateDataByUrl(response.config.url, JSON.parse(response.response));
handler.next(response);
},
});
const { fetch: originalFetch } = window;
// 获取 fetch 发送的请求
window.fetch = async (...args) => {
const response = await originalFetch(...args);
response.json().then((data: any) => {
validateDataByUrl(args[0] as string, data);
return data;
});
return response;
};
}
现在可以在控制台看到接口数据校验的接口辣~ ✿✿ヽ(°▽°)ノ✿
总结下流程图
后续规划
目前所做的事情，准确的说不是拦截，只是获取返回数据，然后对比打印校验结果，因为初步目标不涉及数据的处理。
后续会考虑对不合法的数据进行处理，比如应该返回数组但是返回了null的情况，如果能自动赋值[]，就可以防止前端页面崩溃的情况了。
本文转载于:
https://juejin.cn/post/7166061734803963917
如果对您有所帮助，欢迎您点个关注，我会定时更新技术文档，大家一起讨论学习，一起进步。
声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。
