Kurzreferenz

Superagent Spickzettel

Schnellreferenz für die Superagent HTTP-Client-Bibliothek in JavaScript: GET- und POST-Anfragen, Header, Query-Strings und Response-Eigenschaften.

· Veröffentlicht

Superagent ist eine progressive, leichtgewichtige HTTP-Anfrage-Bibliothek für den Browser und Node.js.

Anfragen durchführen

GET-Anfrage

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- und Async/Await-Stil

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-Anfragen und JSON-Payloads

superagent
  .post('/api/items')
  .send({ item: 'Widget', qty: 10 })
  .set('X-API-Key', 'secret')
  .then(res => console.log(res.body))

Multipart-Formulare und Datei-Uploads

superagent
  .post('/upload')
  .field('title', 'Profile Picture')
  .attach('avatar', 'path/to/avatar.png')
  .then(res => console.log('Uploaded!'))

Eigenschaften des Response-Objekts

Eigenschaft Typ Beschreibung
res.body Object Geparster Response-Body (JSON / Formular)
res.text String Ungeparster Roh-Response-Text
res.status Number HTTP-Statuscode (z. B. 200, 404)
res.header Object Response-Header-Hash
res.ok Boolean True, wenn der Status 2xx ist
res.clientError Boolean True, wenn der Status 4xx ist
res.serverError Boolean True, wenn der Status 5xx ist
res.type String Content-Type ohne Parameter

Verwandte Themen