superAgent 是 Node.js 上一支輕量的 HTTP 客戶端,語法鏈式流暢,適合在腳本或服務中發送請求。以下整理四種主要動作的呼叫形式。
request.post('/api/pet')
.end(function(resp, err){
if (resp.body.status === 200) {
alert('yay got ' + JSON.stringify(res.body));
} else {
return next(resp.body);
}
});
request.get('/api/pet')
.end(function(resp, err){
// 在這裡處理回應
});
request.del('/api/pet')
.end(function(resp, err){
// 在這裡處理回應
});
request.put('/api/pet')
.end(function(resp, err){
// 在這裡處理回應
});
送出資料:.send() 會依 Content-Type 自動序列化,物件會轉成 JSON,字串則原樣送出。
request.post('/api/pet')
.send({ name: 'Mimi', type: 'cat' })
.end(cb);
設定標頭:用 .set(),例如 .set('Authorization', 'Bearer ' + token)。
查詢參數:用 .query(),可傳物件或字串。
攔截逾時:.timeout({ response: 5000, deadline: 60000 }),避免請求無限期掛著。
第一,範例中的 alert() 是瀏覽器 API,Node 環境中並不存在,應替換為 console.log() 或實際的錯誤處理邏輯。另外 POST 範例裡同時出現了 resp 與 res 兩個變數名,是筆誤,應統一。
第二,回呼的第一個參數在 superAgent 中是回應物件而非錯誤,這與 Node 其他 API 的 error-first 慣例相反,容易寫錯。若偏好 async/await,可直接 const res = await request.get('/api/pet'),並用 res.ok、res.status、res.body 判斷結果。
第三,如今 Node 18 以上已內建全域 fetch,一般情境不必再引入第三方套件。若需要進階功能(重試、攔截器、請求取消),axios 與 undici 都是不錯的選擇。