800字节的fetch智能封装：mande全解析

mande是一个仅800字节的现代fetch封装库，提供智能默认配置，自动处理JSON序列化、请求头、错误处理等常见需求。通过链式API和TypeScript支持，大幅简化API调用代码，是轻量级HTTP客户端的优秀选择。

适用人群：前端开发者（尤其Vue用户），需要极致性能的移动端/小程序开发者，经常对接RESTful API的全栈开发者

适用场景：前端应用对接后端API的标准化封装，移动端等对体积敏感项目的请求方案，团队项目统一接口调用规范的场景

推荐理由：mande以极致的轻量化实现了fetch的智能封装，兼顾性能与开发体验。适合追求精简代码和快速交付的现代Web项目，尤其推荐给Vue生态开发者。

项目定位与背景

mande诞生于对原生fetch API的深度优化需求。作为浏览器原生API，fetch虽然标准统一，但存在配置繁琐、错误处理不直观等痛点。项目通过分析真实开发场景中的重复模式，提炼出一套智能默认配置，在保持极简体积的同时，解决现代前端开发中的API通信痛点。项目采用TypeScript开发，兼顾类型安全和运行时性能。

核心功能与技术架构

项目核心是一个轻量级封装层，通过对象工厂模式创建API客户端。主要特性包括：

自动设置Content-Type和Accept头部
智能JSON序列化/反序列化
标准化错误处理机制
灵活的配置继承体系
完整的TypeScript类型支持

架构设计上采用分层配置策略，支持全局默认配置、实例级配置和请求级配置的三层覆盖机制。这种设计既保证了基础配置的一致性，又允许细粒度控制。

创新点与亮点

智能默认配置：自动处理JSON序列化、请求头设置等样板代码
链式API设计：通过实例方法直接调用GET/POST等操作
Token管理集成：内置Authorization头部管理方案
体积极致优化：发布版本仅800字节，零依赖
TypeScript原生支持：完整的类型定义和泛型支持

与同类项目对比

相比axios等成熟库，mande更专注于fetch的轻量封装。优势在于：

体积优势：远小于axios等库

现代API：基于标准fetch实现
TS友好：类型定义更贴合现代开发
配置灵活：支持三级配置覆盖

但相比axios缺少请求/响应拦截器等高级功能。

上手指南与快速开始

安装后通过npm/yarn引入：

import { mande } from 'mande'

const api = mande('/api/users')

基础用法：

api.post(data).then(res => console.log(res))

进阶配置：

const api = mande('/api', {
headers: { 'X-Custom': 'value' }
})

Token管理：

api.options.headers.Authorization = 'Bearer token'

全局配置：

import { defaults } from 'mande'
defaults.headers.Accept = 'application/json'

总结与展望

mande以极简设计实现了fetch的高效封装，是现代前端项目的理想选择。特别适合需要严格控制bundle体积的移动端和单页应用。未来若增加请求取消、拦截器等企业级特性，将更完善开发体验。对于追求极致性能和简洁API的开发者，mande值得纳入技术选型清单。

查看 GitHub 项目