Fetch Wrapper

Overview

A simple fetch wrapper.

Installation

Node

npm install @nicebuzzy/fetch-wrapper

Browser

<script type="module">
  import { request, get, post } from 'https://esm.run/@nicebuzzy/fetch-wrapper'
</script>

Usage

request is a wrapper for fetch with a similar API.

import { request, get } from '@nicebuzzy/fetch-wrapper'

try {
  const response = await request('https://example.com/posts/1')
  const json = await response.json()
} catch (error) {
  console.error(error)
}

request automatically sets the correct headers and applies JSON.stringify to the body if it is an object. Otherwise, it relies on the default behavior of the fetch. Any custom options passed to request will override both its defaults and any values it tries to set.

import { post } from '@nicebuzzy/fetch-wrapper'

try {
  const body = { title: 'Hello, World!' }
  const response = await post('https://example.com/posts/add', { body })
  const json = await response.json()
} catch (error) {
  console.error(error)
}

API Reference

request(endpoint, options)

Returns: Promise<Response>

• endpoint: String | URL
  The URL to which the request is sent.

• options: Object
  Configuration options for the request.

  • options.timeout: Number (in milliseconds, default: 5000)
    If the request takes longer than this time, a TimeoutError will be thrown.

Refer to the MDN for details.

get(), post(), put(), patch(), del(), head(), options()

Helpers for making requests with specific HTTP methods.