superAgent 是 Node.js 生態系裡相當輕巧的 HTTP 客戶端函式庫,語法採串接式風格,寫起來比原生 http 模組直觀許多。以下把四種常見的請求方法各整理一個範例。
request.post('/api/pet')
.end(function(resp, err){
if (resp.body.status === 200) {
alert('yay got ' + JSON.stringify(resp.body));
} else {
return next(resp.body);
}
});
串接 .end() 註冊回呼,在裡面處理回應;若狀態不是預期值,就把錯誤往下一層丟。
request.get('/api/pet')
.end(function(resp, err){
// 在這裡處理 resp
});
request.del('/api/pet')
.end(function(resp, err){
// 在這裡處理 resp
});
注意 superAgent 中 DELETE 的方法名是 del,因為 delete 是 JavaScript 的保留字。
request.put('/api/pet')
.end(function(resp, err){
// 在這裡處理 resp
});
帶查詢參數時可以串上 .query();送出表單或 JSON body 時用 .send(),並以 .set() 設定 Content-Type;需要逾時控制時加上 .timeout(ms)。這些方法都能自由串接,例如:
request.post('/api/pet')
.set('Content-Type', 'application/json')
.send({ name: 'Momo', age: 2 })
.query({ dryRun: true })
.timeout(5000)
.end(function(resp, err){ /* ... */ });
整體來說,superAgent 的設計目標就是把瑣碎的請求設定濃縮成一行行清楚的鏈式呼叫,很適合用在爬蟲、API 測試或微服務之間的內部溝通。