got

Simplified HTTP requests

This feature allows you to perform HTTP GET requests with a promise-based API. The example shows how to fetch a webpage and log the HTML content.

const got = require('got');
got('https://sindresorhus.com').then(response => {
  console.log(response.body);
}).catch(error => {
  console.log(error.response.body);
});

JSON support

This feature automatically parses JSON responses. The example demonstrates fetching JSON data from an API and logging the parsed object.

const got = require('got');
got('https://api.example.com/data', { responseType: 'json' }).then(response => {
  console.log(response.body);
}).catch(error => {
  console.log(error.response.body);
});

POST requests

This feature allows you to send POST requests with JSON bodies. The example shows how to send a POST request with a JSON payload and receive a JSON response.

const got = require('got');
got.post('https://api.example.com/submit', {
  json: {
    key: 'value'
  },
  responseType: 'json'
}).then(response => {
  console.log(response.body);
}).catch(error => {
  console.log(error.response.body);
});

Error handling

This feature provides comprehensive error handling for various types of request failures. The example demonstrates how to handle different error scenarios when a request fails.

const got = require('got');
got('https://api.example.com/wrong-endpoint').then(response => {
  console.log(response.body);
}).catch(error => {
  if (error.response) {
    console.log('The server responded with a non-2xx status code.');
  } else if (error.request) {
    console.log('The request was made but no response was received');
  } else {
    console.log('An error occurred when trying to perform the request.');
  }
});

Stream support

This feature allows you to use got as a stream. The example shows how to stream a webpage's content and write it to a file.

const got = require('got');
const fs = require('fs');
const stream = got.stream('https://sindresorhus.com');
stream.pipe(fs.createWriteStream('index.html'));