---
url: /adapters/ofetch.md
description: >-
  Map ofetch response errors, network failures, and timeouts to consistent Okapi
  errors with type-safe adapters and customizable messages
---

# ofetch

An adapter for ofetch.

## Types

```ts
type ApiOfetchError<T = unknown> = FetchError<T>
```

## `getOfetchError`

Handles ofetch response errors, transport failures, and other thrown values. An ofetch timeout
whose cause is named `TimeoutError` maps to the `timeout` kind.

* Type:

```ts
function getOfetchError<
  TCustomKind extends string = never,
  TValidationErrors = ApiValidationErrors,
>(
  error: unknown,
  options?: OkapiErrorAdapterOptions<TCustomKind, TValidationErrors>,
): OkapiError<TCustomKind, TValidationErrors>
```

## `createOfetchErrorMapper`

Creates a mapper for ofetch response errors, transport failures, and other thrown values.

* Type:

```ts
function createOfetchErrorMapper<
  TCustomKind extends string = never,
  TValidationErrors = ApiValidationErrors,
>(
  options?: OkapiErrorAdapterOptions<TCustomKind, TValidationErrors>,
): OkapiErrorMapper<TCustomKind, TValidationErrors>
```

## Example

```ts
import { ofetch } from 'ofetch'
import { createOfetchErrorMapper } from '@alexovn/okapi/ofetch'

const mapOfetchError = createOfetchErrorMapper()

async function ofetchGet<T>(url: string): Promise<T> {
  try {
    return await ofetch<T>(url)
  } catch (error) {
    throw mapOfetchError(error)
  }
}
```

ofetch exposes the parsed error response body to the adapter automatically. This example throws a
mapped object to its caller. If your application expects native `Error` instances, use
`getOfetchError` instead, then map the error at the UI boundary.