Skip to content

Latest commit

 

History

History
154 lines (117 loc) · 6.36 KB

README.md

File metadata and controls

154 lines (117 loc) · 6.36 KB

Httpie

A modern and light Node.js http client 🐢🚀.

npm version license ossf scorecard github ci workflow size

📢 About

The package is inspired by lukeed httpie (The use is relatively similar). This package use new Node.js http client undici under the hood.

🔬 Features

  • Automatically parse based on the content-type.
  • Automatically decompress based on the content-encoding.
  • Includes aliases for common HTTP verbs: get, post, put, patch, and del.
  • Able to automatically detect domains and paths to assign the right Agent (use a LRU cache to avoid repetitive computation).
  • Allows to use an accurate rate-limiter like p-ratelimit with the limit option.
  • Built-in retry mechanism with custom policies.
  • Safe error handling with Rust-like Result.

Thanks to undici:

  • Support HTTP redirections with the maxRedirections argument.
  • Implement high-level API for undici stream and pipeline method.
  • High performance (see benchmarks).
  • Work well with newest Node.js API AbortController to cancel http request.

Light with seriously maintained dependencies:

🚧 Requirements

🚀 Getting Started

This package is available in the Node Package Repository and can be easily installed with npm or yarn.

$ npm i @myunisoft/httpie
# or
$ yarn add @myunisoft/httpie

📚 Usage example

The MyUnisoft httpie client is very similar to lukeed httpie http client.

import * as httpie from "@myunisoft/httpie";

try {
  const { data } = await httpie.get("https://jsonplaceholder.typicode.com/posts");
  console.log(data);
  
  const response = await httpie.post("https://jsonplaceholder.typicode.com/posts", {
    body: {
      title: "foo",
      body: "bar",
      userId: 1
    }
  });

  console.log(response.statusCode);
  console.log(response.statusMessage);
  console.log(response.data);
}
catch (error) {
  console.log(error.message);
  console.log(error.statusCode);
  console.log(error.headers);
  console.log(error.data);
}

Since v2.0.0 you can also use the safe prefix API to get a Promise<Result<T, E>>

import * as httpie from "@myunisoft/httpie";

const response = (await httpie.safePost("https://jsonplaceholder.typicode.com/posts", {
  body: {
    title: "foo",
    body: "bar",
    userId: 1
  }
}))
  .map((response) => response.data)
  .mapErr((error) => new Error("a message here!", { cause: error.data }));
  .unwrap();

👀 For more examples of use please look at the root folder examples.

📜 API

Error handling

Read the error documentation.

Contributors ✨

All Contributors

Thanks goes to these wonderful people (emoji key):

Gentilhomme
Gentilhomme

💻 📖 👀 🛡️ 🐛
PierreDemailly
PierreDemailly

💻 ⚠️
Yefis
Yefis

💻 🐛

License

MIT