@hapi/wreck

What is @hapi/wreck?

@hapi/wreck is a powerful HTTP client library for Node.js, designed to make HTTP requests and handle responses with ease. It is part of the hapi ecosystem and provides a simple and consistent API for making HTTP requests, handling redirects, and managing cookies.

What are @hapi/wreck's main functionalities?

Making HTTP GET Requests

This feature allows you to make HTTP GET requests to a specified URL and handle the response. The example fetches data from a placeholder API and logs the response.

const Wreck = require('@hapi/wreck');

async function fetchData() {
  const { res, payload } = await Wreck.get('https://jsonplaceholder.typicode.com/posts/1');
  console.log(JSON.parse(payload.toString()));
}

fetchData();

Making HTTP POST Requests

This feature allows you to make HTTP POST requests with a payload. The example sends a JSON object to a placeholder API and logs the response.

const Wreck = require('@hapi/wreck');

async function postData() {
  const payload = JSON.stringify({ title: 'foo', body: 'bar', userId: 1 });
  const { res, payload: responsePayload } = await Wreck.post('https://jsonplaceholder.typicode.com/posts', { payload });
  console.log(JSON.parse(responsePayload.toString()));
}

postData();

Handling Redirects

This feature allows you to handle HTTP redirects automatically. The example makes a GET request to a URL and follows up to 3 redirects.

const Wreck = require('@hapi/wreck');

async function fetchWithRedirect() {
  const { res, payload } = await Wreck.get('http://example.com', { redirects: 3 });
  console.log(payload.toString());
}

fetchWithRedirect();

Managing Cookies

This feature allows you to manage cookies for your HTTP requests. The example sets a cookie and makes a GET request with the cookie jar.

const Wreck = require('@hapi/wreck');

async function fetchWithCookies() {
  const jar = new Wreck.CookieJar();
  await jar.setCookie('session=abc123', 'http://example.com');
  const { res, payload } = await Wreck.get('http://example.com', { cookies: jar });
  console.log(payload.toString());
}

fetchWithCookies();

Other packages similar to @hapi/wreck

axios

Axios is a popular promise-based HTTP client for the browser and Node.js. It provides a simple and intuitive API for making HTTP requests and handling responses. Compared to @hapi/wreck, Axios has a larger community and more extensive documentation.

node-fetch

Node-fetch is a lightweight module that brings the Fetch API to Node.js. It is minimalistic and focuses on providing a familiar API for making HTTP requests. Compared to @hapi/wreck, node-fetch is simpler and more lightweight, but it lacks some of the advanced features like cookie management.

request

Request is a comprehensive and flexible HTTP client for Node.js. It supports a wide range of features, including authentication, redirects, and cookies. However, it has been deprecated in favor of more modern alternatives like Axios and node-fetch. Compared to @hapi/wreck, Request is more feature-rich but is no longer actively maintained.

README

@hapi/wreck

HTTP client utilities.

wreck is part of the hapi ecosystem and was designed to work seamlessly with the hapi web framework and its other components (but works great on its own or with other frameworks). If you are using a different web framework and find this module useful, check out hapi – they work even better together.

Visit the hapi.dev Developer Portal for tutorials, documentation, and support

Useful resources

• Documentation and API
• Versions status (builds, dependencies, node versions, licenses, eol)
• Changelog
• Project policies
• Free and commercial support options