json-fetch.md

layout	description
page	A drop-in replacements for fetch, Request, and Response with first class support for JSON objects.

JSON Fetch

A drop-in replacements for fetch, Request, and Response with first class support for JSON objects.

• Table of Contents {:toc .large-only}

Unlike other HTTP libraries, this one stays as close as possible to the original Fetch API, while improving the ergonomics the most common use case:

Before:

const response = await fetch('/some', { 
  method: 'POST',
  body: JSON.stringify(json), 
  headers: {
    'Content-Type': 'application/json',
  },
});

After:

import { JSONRequest } from '@worker-tools/json-fetch';

const response = await fetch(new JSONRequest('/some', { 
  method: 'POST', 
  body: json,
}));

You can also use the updated jsonFetch function:

import { jsonFetch as fetch } from '@worker-tools/json-fetch';

const response = await fetch('/some', { method: 'POST', body: data })

Note that previous use cases remain intact, i.e. posting FormData, ReadableStream, etc. as body works:

const response = await fetch(new JSONRequest('/some', { 
  method: 'POST', 
  body: new FromData(form),
}))

This will send the body as form-data/multipart with correct content type header, as in the original Fetch API. Only difference is that the Accept header will be set to indicate preference for application/json, i.e. anticipating a JSON response from the server.

---

{:style="margin: 2rem 0"}

Links: GitHub | ghuc.cc · NPM | Browse Package · deno.land | Docs {:.faded}