Superagent is een progressieve, lichtgewicht HTTP-aanvraagbibliotheek voor de browser en Node.js.
Verzoeken Uitvoeren
GET-aanvraag
const superagent = require('superagent')
superagent
.get('/api/users')
.query({ role: 'admin', page: 2 })
.set('Accept', 'application/json')
.end((err, res) => {
if (err) return console.error(err)
console.log(res.status)
console.log(res.body)
})
Promise- en Async/Await-stijl
try {
const res = await superagent
.post('/api/users')
.send({ name: 'John Doe', email: '[email protected]' })
.set('Authorization', 'Bearer token123')
console.log(res.body)
} catch (err) {
console.error(err.response ? err.response.body : err.message)
}
POST-aanvragen en JSON-payloads
superagent
.post('/api/items')
.send({ item: 'Widget', qty: 10 })
.set('X-API-Key', 'secret')
.then(res => console.log(res.body))
Multipart-formulieren en bestandsuploads
superagent
.post('/upload')
.field('title', 'Profile Picture')
.attach('avatar', 'path/to/avatar.png')
.then(res => console.log('Uploaded!'))
Response-objecteigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
res.body |
Object |
Geparste response body (JSON / Formulier) |
res.text |
String |
Ruwe ongeparste response tekst |
res.status |
Number |
HTTP statuscode (bijv. 200, 404) |
res.header |
Object |
Response headers hash |
res.ok |
Boolean |
True als status 2xx is |
res.clientError |
Boolean |
True als status 4xx is |
res.serverError |
Boolean |
True als status 5xx is |
res.type |
String |
Content-Type zonder parameters |