Το Superagent είναι μια προοδευτική, ελαφριά βιβλιοθήκη αιτημάτων HTTP για προγράμματα περιήγησης και Node.js.
Υποβολή Αιτημάτων
Αίτημα GET
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 και Async/Await
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 και JSON Payloads
superagent
.post('/api/items')
.send({ item: 'Widget', qty: 10 })
.set('X-API-Key', 'secret')
.then(res => console.log(res.body))
Φόρμες Multipart & Μεταφόρτωση Αρχείων
superagent
.post('/upload')
.field('title', 'Profile Picture')
.attach('avatar', 'path/to/avatar.png')
.then(res => console.log('Uploaded!'))
Ιδιότητες Αντικειμένου Απόκρισης
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
res.body |
Object |
Αναλυμένο σώμα απόκρισης (JSON / Form) |
res.text |
String |
Ακατέργαστο κείμενο απόκρισης |
res.status |
Number |
Κωδικός κατάστασης HTTP (π.χ. 200, 404) |
res.header |
Object |
Κεφαλίδες απόκρισης |
res.ok |
Boolean |
True εάν η κατάσταση είναι 2xx |
res.clientError |
Boolean |
True εάν η κατάσταση είναι 4xx |
res.serverError |
Boolean |
True εάν η κατάσταση είναι 5xx |
res.type |
String |
Content-Type χωρίς παραμέτρους |