Referință rapidă

Ghid Rapid Superagent

Ghid rapid pentru biblioteca de cereri HTTP Superagent în JavaScript: cereri GET și POST, antete, parametri și proprietăți de răspuns.

· Publicat

Superagent este o bibliotecă progresivă și ușoară pentru cereri HTTP în browser și Node.js.

Efectuarea cererilor

Cerere 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)
  })

Stil bazat pe Promisiuni și 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)
}

Cereri POST și date JSON

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

Formulare Multipart și încărcare fișiere

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

Proprietățile obiectului de răspuns

Proprietate Tip Descriere
res.body Object Corpul răspunsului analizat (JSON / Formular)
res.text String Textul brut al răspunsului
res.status Number Cod de stare HTTP (de ex. 200, 404)
res.header Object Anteturile de răspuns
res.ok Boolean True dacă starea este 2xx
res.clientError Boolean True dacă starea este 4xx
res.serverError Boolean True dacă starea este 5xx
res.type String Content-Type fără parametri

Subiecte conexe