# like-fetch

> Fetch with added features: timeout, retry, status validation, simplified response, etc

Latest version **2.4.0** (published 2025-09-02) · MIT license · 0 weekly downloads

## Install

```sh
npm install like-fetch
pnpm add like-fetch
yarn add like-fetch
bun add like-fetch
```

## Health

**Score 35/100 (D)** — status: stable.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 2.4.0 |
| Published | 2025-09-02 |
| First published | 2022-07-26 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 27.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | Lucas Barrena |
| Maintainers | lukks |

## Links

- npm: https://www.npmjs.com/package/like-fetch
- Repository: https://github.com/LuKks/like-fetch
- Issues: https://github.com/LuKks/like-fetch/issues
- npm.io page: https://npm.io/package/like-fetch

## Dependencies (2)

- [like-retry](https://npm.io/package/like-retry.md) ^1.1.0
- [cross-fetch](https://npm.io/package/cross-fetch.md) ^4.0.0

## Recent versions

- 2.4.0 (latest) — 2025-09-02
- 2.3.3 — 2025-06-04
- 2.3.2 — 2025-02-25
- 2.3.1 — 2024-12-06
- 2.3.0 — 2024-04-14
- 2.2.0 — 2024-03-06
- 2.1.0 — 2024-01-31
- 2.0.1 — 2024-01-26
- 2.0.0 — 2024-01-23
- 1.2.1 — 2024-01-22
- 1.2.0 — 2024-01-08
- 1.1.0 — 2023-08-25
- 1.0.6 — 2022-07-28
- 1.0.5 — 2022-07-28
- 1.0.4 — 2022-07-28
- … 9 more at https://npm.io/package/like-fetch/versions

## README

# like-fetch

Fetch with added features: timeout, retry, status validation, simplified response, etc.

![](https://img.shields.io/npm/v/like-fetch.svg) ![](https://img.shields.io/github/license/LuKks/like-fetch.svg)

```
npm i like-fetch
```

Compatible with Node.js, browser and React Native.\
All options are optional, so by default it's the same as a normal `fetch(...)`.

## Usage

```js
const fetch = require('like-fetch')

// As usual
const response = await fetch('https://example.com')
const body = await response.text()

// Using some features
const ip = await fetch('https://example.com', {
  query: { limit: 5 }, // It's similar to URLSearchParams for query strings
  timeout: 5000, // Uses AbortController, signal, etc
  retry: { max: 3 }, // This retry object is passed to like-retry
  validateStatus: 'ok', // Throw if status is not correct
  requestType: 'json', // Will automatically do JSON.stringify(body)
  responseType: 'json' // Will automatically do response.json()
})
```

## Timeout

```js
const response = await fetch('https://example.com', { timeout: 5000 })
const body = await response.json()
// Throws an AbortError in case of timeout (for both request and body consuming)
```

## Retry

```js
const retry = { max: 3, delay: 3000, strategy: 'linear' }
const response = await fetch('https://example.com', { retry })
// If the first attempt fails then: waits 3s and retries, 6s, 9s, and finally throws
```

Check [like-retry](https://github.com/LuKks/like-retry) for documentation about `retry` option.

## Status validation

```js
// response.status must match 200, otherwise throws
const response = await fetch('https://example.com', { validateStatus: 200 })

// response.ok must be true
const response = await fetch('https://example.com', { validateStatus: 'ok' })

// Custom function, must return true
const validateStatus = status => status >= 200 && status < 300
const response = await fetch('https://example.com', { validateStatus })
```

At this moment, when `validateStatus` fails it throws the `response` object.

## Request types

```js
// Sets the 'Content-Type' header to 'application/json'
// And if body is not undefined then does a JSON.stringify(body)
const res = await fetch('..', { method: 'POST', requestType: 'json', body: { id: '1' } })

// Sets the 'Content-Type' header to 'application/x-www-form-urlencoded'
// And if body is not undefined then it stringifes URLSearchParams using the body
const res = await fetch('..', { method: 'POST', requestType: 'url', body: { id: '2' } })

// Sets the 'Content-Type' header to 'text/plain'
const res = await fetch('..', { method: 'POST', requestType: 'text', body: { id: '3' } })

// Sets the 'Content-Type' header to 'multipart/form-data; boundary=...'
const res = await fetch('..', { method: 'POST', requestType: 'form', body: new FormData() })
```

## Response types

```js
// Sets the 'Accept' header to 'application/json' and does response.json()
const body = await fetch('https://example.com', { responseType: 'json' })
console.log(body) // => Object {...}

// Automatic response.text()
const body = await fetch('https://example.com', { responseType: 'text' })
console.log(body) // => String '...'
```

## Signal controller

Just using `useEffect` as an example of manual cancelling the request.

```js
useEffect(() => {
  if (!account) return

  // Start request
  const promise = fetch('http://localhost/api/balance/' + account, { responseType: 'json' })

  // Propagate values
  promise.then(body => setBalance(body.balance))

  // Handle exceptions
  promise.catch(error => setBalance('~'))

  // Clean up
  return () => promise.controller.abort()
}, [account])
```

## License

MIT

---
_Source: https://npm.io/package/like-fetch · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._