fetch-unfucked

A zero dependencies, sensible defaults HTTP client based on fetch().

You know how you always have to write a wrapper around fetch to have sensible defaults, for every new project? This is that wrapper.

• Zero dependencies. No unnecessary fetch polyfills.
• Works on the browser and node 18
• TypeScript and ESM obviously.
• Sensible defaults - sets Accept to JSON by default, sets Content-Type header to use JSON by default.
• get(), post(), maybe other verbs if you or I add them.
• Returns a plain JS object with headers, body, and status (as text, not magic numbers).
• Automatically decodes bodies based on HTTP content types, so JSON response bodies are JS objects, HTML and text bodies are strings.
• Encodes query strings - instead of a url string, provide an object of the format { url: string; params: Record<string, string>; } and the query parameters will be encoded for you.

It's 100 lines of code, but who wants to write or maintain something that should have been baked in to JavaScript, and that we already had in a billion libraries before fetch decided to come along and have the dumbest defaults since querySelectorAll returned NodeLists? God why can't we have nice things? 🤦🏻‍♂️

Usage:

npm i fetch-unfucked

Importing

import * as http from "fetch-unfucked";

get()

• urlOrURLWithParams - required. Either a string, or a { string: someURL, params: { encode: me } } if you want some URL parameters to be encoded.
• headers optional. An object of headers. The Accept header will be set to application/json by default.
• forceResponseContentType optional. Ignores the content type used by the remote server when decoding the response. This only exists because nftstorage.link uses text/plain for JSON.

Returns a Promise of a Response object, with status, headers, and body

Example: basic get()

import * as http from "fetch-unfucked";

const { body } = await http.get(
  `https://someUrl.com/some/endpoint`
);
const dataICareAbout = body?.info?.resolved || null;

post()

• urlOrURLWithParams - required. Either a string, or a { string: someURL, params: { encode: me } } if you want some URL parameters to be encoded.
• headers optional. An object of headers. The Accept header will be set to application/json by default.
• body optional. The JS object you're posting.
• forceResponseContentType optional. Ignores the content type used by the remote server when decoding the response. This only exists because nftstorage.link uses text/plain for JSON.

Returns a Promise of a Response object, with status, headers, and body

Example: post() ing to a REST API

This example has a POST body but no headers.

const response = await http.post('/api/v1/proposals', null, {
  direction,
  url,
  currentUserWalletAddress,
  githubAccessToken,
});

Example: post() ing to GitHub

This example encodes some parameters for us:

const response = await http.post(
  { 
    url: 'https://github.com/login/oauth/access_token',
    params: {
      client_id: OAUTH_CLIENT_ID,
      client_secret: OAUTH_CLIENT_SECRET,
      code,
    }
  }
);

More info

The UI is fairly intuitive but look at the TS types for more.

Changelog

1.2

• Provide a { url, params } object instead of a string to encode query params
• Set default values if Accept header isn't specified
• Remove CommonJS

1.0

Initial release

Changes welcomed

Send me a PR.