# withResponse

## withResponse(transform)

Wraps a fetch function and transforms the final `Response` into any value.

This wrapper does not choose a parser or special-case empty responses. The transform receives the raw `Response`, so callers can decide how to handle JSON, text, bytes, `204`/`205`, or any custom response shape.

Unlike most wrappers, this can return something other than a `Response`, so it should be placed last in a [`pipeline`](pipeline.md). Use this instead of `withHooks({afterResponse})` when the wrapped fetch function should resolve to parsed or transformed data.

## Parameters

- `transform` (`(response: Response) => Value | Promise<Value>`) - Function that receives the final `Response` and returns the desired value.

## Returns

A function that takes a fetch function and returns a wrapped fetch function that resolves with the transform result.

## Example

```js
import {withResponse} from 'fetch-extras';

const fetchJsonOrUndefined = withResponse(response => {
	if (response.status === 204 || response.status === 205) {
		return undefined;
	}

	return response.json();
})(fetch);

const data = await fetchJsonOrUndefined('/api/user');
```

Can be combined with other `with*` functions (place last in documented `pipeline()` order):

```js
import {pipeline, withHttpError, withResponse} from 'fetch-extras';

const fetchText = pipeline(
	fetch,
	withHttpError(),
	withResponse(response => response.text()),
);

const text = await fetchText('/api/message');
```