SuperAgent是一个JavaScript的HTTP客户端，适用于浏览器和Node.js环境下的客户端请求代理模块。

SuperAgent是轻量级且更为优化的AJAX API，相比其他API更为灵活易读且易学。

SuperAgent有两个实现，一个是给浏览器使用的是浏览器原生对象XmlHttpRequest对象，一个是给Node.js使用的是核心的HTTP模块。

在Node.js环境下，SuperAgent通常会配合HTTP客户端使用，可以说是一个改良版的AJAX。SuperAgent是一个基于Promise的轻量级渐进式的AJAX API，非常适合发送HTTP请求和接收服务器响应。

SuperAgent与Axios相同，即适用于Node.js环境下也适用于所有现代浏览器环境。SuperAgent的优点在于它拥有一个插件生态，可以通过构建插件实现更多的功能。

Node.js中使用SuperAgent

SuperAgent可用来处理GET、POST、PUT、DELETE、HEAD等请求，并支持绝对路径、链式调用等，典型的应用比如使用SuperAgent编写爬虫应用。

安装

$ npm i -g superagent

引入

const superagent = require("superagent");

请求

通过调用superagent对象的then()或end()方法，或使用await关键字，可以向服务器发送一个请求。

同步调用

superagent("GET", url).end((err, res)=>{
  //...
});

由于HTTP请求方法默认为GET，因此可省略掉GET参数。

superagent(url).end((err, res)=>{
  //...
});

SuperAgent支持ES6，可使用then()方法替代end()方法。

superagent("GET", url).then(success, failure);

superagent.get(url).then(res=>console.log).catch(err=>console.error);

异步调用 async/await

(async _=>{
  try{
    const res = await superagent.get(url);
    console.log(res.status, res.headers, res.body);
  }catch(err){
    console.error(err.message, err.response);
  }
})();

设置GET查询字符串

SuperAgent提供get()和query()方法用于GET请求生成URL的查询字符串，query()支持对象和字符串类型的参数。

superagent.get(url).query(uid:1, page:2}).then(res=>console.log).catch(err=>console.error);

发送POST请求

SuperAgent提供post()方法并配合send()方法完成对POST请求的发送，默认POST发送字符串采用的Content-Type为application/x-www-urlencoded。比如向服务器发送POST JSON请求。

superagnet.post(url).set(headers).send(data).then(success).catch(error);

superagent.post(url)
  .set({"Content-Type":"application/json"})
  .send({nickname:"jc", sex:1})
  .then(res=>console.log)
  .catch(err=>console.error);

SuperAgent发送POST数据的格式是可扩展的，默认支持form和json，可使用type()方法进行设置。需要注意的是form的别名为form-data和urlencoded并向后兼容。

type()方法可用于速记，接收规范化使用type/subtype的MIME类型名称，或使用简单的扩展名。

superagent.post(url).type("json").send(json).then(res=>console.log).catch(err=>console.error);

设置请求头字段

SuperAgent中可使用set()方法设置请求头Header中的键值对，set()方法支持传入一个对象作为参数。

superagent.get(url).set("Accept", "application/json").then(res=>console.log).catch(err=>console.error);

superagent.get(url).set({"Accept":"application/json"}).then(res=>console.log).catch(err=>console.error);

SuperAgent会自动序列化JSON和格式，可使用serialize()方法替换为内置序列化。

响应体

SuperAgent请求发送成功后会返回服务器响应，响应数据保存在Response对象中，包括返回文本、返回结构、头字段、状态标志灯。响应体信息位于res.body属性中。

SuperAgent可以解析常用的响应体，支持application/x-www-form-urlencoded、application/json、multipart/form-data格式。