Request

---

import { Request } from "@hyper-fetch/core"

Description

Fetch request it is designed to prepare the necessary setup to execute the request to the server. We can set up basic options for example endpoint, method, headers and advanced settings like cache, invalidation patterns, concurrency, retries and much, much more.

Usage

We should not use this class directly in the standard development flow. We can initialize it using the createRequest method on the Client class.

Defined in request/request.ts:40

Parameters

Name	Details
client Required	Client<GlobalError, AdapterType>
requestOptions Required	RequestOptionsType<Endpoint, ExtractAdapterOptions<AdapterType>, ExtractAdapterMethodType<AdapterType>>
requestJSON Optional	RequestCurrentType<Payload, QueryParams, Endpoint, ExtractAdapterOptions<AdapterType>, ExtractAdapterMethodType<AdapterType>>

Properties

abortKey

Description

Defined in request/request.ts:68

Type

string

---

auth

Description

Defined in request/request.ts:54

Type

boolean

---

cache

Description

Defined in request/request.ts:64

Type

boolean

---

cacheKey

Description

Defined in request/request.ts:69

Type

string

---

cacheTime

Description

Defined in request/request.ts:65

Type

number

---

cancelable

Description

Defined in request/request.ts:60

Type

boolean

---

client

Description

Defined in request/request.ts:93

Type

Client<GlobalError, AdapterType>

---

data

Description

Defined in request/request.ts:57

Type

Payload

---

deduplicate

Description

Defined in request/request.ts:73

Type

boolean

---

deduplicateTime

Description

Defined in request/request.ts:74

Type

number

---

effectKey

Description

Defined in request/request.ts:71

Type

string

---

endpoint

Description

Defined in request/request.ts:52

Type

Endpoint

---

garbageCollection

Description

Defined in request/request.ts:63

Type

number

---

headers

Description

Defined in request/request.ts:53

Type

HeadersInit

---

method

Description

Defined in request/request.ts:55

Type

ExtractAdapterMethodType<AdapterType>

---

mock

Description

Defined in request/request.ts:76

Type

Generator<GeneratorReturnMockTypes<Response, Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>>, GeneratorReturnMockTypes<Response, Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>>, GeneratorReturnMockTypes<Response, Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>>>

---

mockData

Description

Defined in request/request.ts:81

Type

RequestDataMockTypes<Response, Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>>

---

offline

Description

Defined in request/request.ts:67

Type

boolean

---

options

Description

Defined in request/request.ts:59

Type

ExtractAdapterOptions<AdapterType>

---

params

Description

Defined in request/request.ts:56

Type

ExtractRouteParams<Endpoint>

---

queryParams

Description

Defined in request/request.ts:58

Type

QueryParams

---

queueKey

Description

Defined in request/request.ts:70

Type

string

---

queued

Description

Defined in request/request.ts:66

Type

boolean

---

requestJSON

Description

Defined in request/request.ts:99

Type

RequestCurrentType<Payload, QueryParams, Endpoint, ExtractAdapterOptions<AdapterType>, ExtractAdapterMethodType<AdapterType>>

---

requestOptions

Description

Defined in request/request.ts:94

Type

RequestOptionsType<Endpoint, ExtractAdapterOptions<AdapterType>, ExtractAdapterMethodType<AdapterType>>

---

retry

Description

Defined in request/request.ts:61

Type

number

---

retryTime

Description

Defined in request/request.ts:62

Type

number

---

used

Description

Defined in request/request.ts:72

Type

boolean

---

Methods

dataMapper()

Description

Defined in request/request.ts:75

Return

(data: Payload) => NewDataType

---

exec()

Description

Method to use the request WITHOUT adding it to cache and queues. This mean it will make simple request without queue side effects.

Defined in request/request.ts:461

Return

Promise<[Data | null, Error | null, HttpStatus]>

---

requestMapper()

Description

Defined in request/request.ts:82

Return

(requestId: string, request: RequestInstance) => R

---

responseMapper()

Description

Defined in request/request.ts:83

Return

(response: ResponseReturnType<any, any, any>) => ResponseReturnType<Response, GlobalError | LocalError, AdapterType>

---

send()

Description

Method used to perform requests with usage of cache and queues

Defined in request/request.ts:492

Return

Promise<[Data | null, Error | null, HttpStatus]>

---

abort()

Preview

abort()

Description

Defined in request/request.ts:445

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

clone()

Preview

clone<D, P, Q>(options)

Description

Defined in request/request.ts:400

Parameters

Name	Details
options Optional	RequestCurrentType<Payload, QueryParams, Endpoint, ExtractAdapterOptions<AdapterType>, ExtractAdapterMethodType<AdapterType>>

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, D, P, Q>

---

removeMock()

Preview

removeMock()

Description

Defined in request/request.ts:309

Return

this

---

setAbortKey()

Preview

setAbortKey(abortKey)

Description

Defined in request/request.ts:245

Parameters

Name	Details
abortKey Required	string

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setAuth()

Preview

setAuth(auth)

Description

Defined in request/request.ts:165

Parameters

Name	Details
auth Required	boolean

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setCache()

Preview

setCache(cache)

Description

Defined in request/request.ts:221

Parameters

Name	Details
cache Required	boolean

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setCacheKey()

Preview

setCacheKey(cacheKey)

Description

Defined in request/request.ts:250

Parameters

Name	Details
cacheKey Required	string

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setCacheTime()

Preview

setCacheTime(cacheTime)

Description

Defined in request/request.ts:231

Parameters

Name	Details
cacheTime Required	number

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setCancelable()

Preview

setCancelable(cancelable)

Description

Defined in request/request.ts:187

Parameters

Name	Details
cancelable Required	boolean

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setData()

Preview

setData<D>(data)

Description

Defined in request/request.ts:173

Parameters

Name	Details
data Required	D

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, D extends null ? false : true, HasParams, HasQuery>

---

setDataMapper()

Preview

setDataMapper<DataMapper>(dataMapper)

Description

Defined in request/request.ts:281

Parameters

Name	Details
dataMapper Required	DataMapper

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setDeduplicate()

Preview

setDeduplicate(deduplicate)

Description

Defined in request/request.ts:265

Parameters

Name	Details
deduplicate Required	boolean

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setDeduplicateTime()

Preview

setDeduplicateTime(deduplicateTime)

Description

Defined in request/request.ts:269

Parameters

Name	Details
deduplicateTime Required	number

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setEffectKey()

Preview

setEffectKey(effectKey)

Description

Defined in request/request.ts:260

Parameters

Name	Details
effectKey Required	string

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setGarbageCollection()

Preview

setGarbageCollection(garbageCollection)

Description

Defined in request/request.ts:211

Parameters

Name	Details
garbageCollection Required	number

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setHeaders()

Preview

setHeaders(headers)

Description

Defined in request/request.ts:161

Parameters

Name	Details
headers Required	HeadersInit

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setMock()

Preview

setMock(mockData)

Description

Defined in request/request.ts:289

Parameters

Name	Details
mockData Required	RequestDataMockTypes<Response, this>

Return

this

---

setOffline()

Preview

setOffline(offline)

Description

Defined in request/request.ts:277

Parameters

Name	Details
offline Required	boolean

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setOptions()

Preview

setOptions(options)

Description

Defined in request/request.ts:183

Parameters

Name	Details
options Required	ExtractAdapterOptions<AdapterType>

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, true>

---

setParams()

Preview

setParams<P>(params)

Description

Defined in request/request.ts:169

Parameters

Name	Details
params Required	P

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, P extends null ? false : true, HasQuery>

---

setQueryParams()

Preview

setQueryParams(queryParams)

Description

Defined in request/request.ts:179

Parameters

Name	Details
queryParams Required	QueryParams

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, true>

---

setQueueKey()

Preview

setQueueKey(queueKey)

Description

Defined in request/request.ts:255

Parameters

Name	Details
queueKey Required	string

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setQueued()

Preview

setQueued(queued)

Description

Defined in request/request.ts:241

Parameters

Name	Details
queued Required	boolean

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setRequestMapper()

Preview

setRequestMapper(requestMapper)

Description

Defined in request/request.ts:315

Parameters

Name	Details
requestMapper Required	<R>(requestId: string, request: this) => R

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setResponseMapper()

Preview

setResponseMapper<NewResponse, NewError>(responseMapper)

Description

Map

Defined in request/request.ts:329

Parameters

Name	Details
responseMapper Optional	(response: ResponseReturnType<Response, GlobalError | LocalError, AdapterType>) => ResponseReturnType<NewResponse, NewError, AdapterType>

Return

Request<NewResponse, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setRetry()

Preview

setRetry(retry)

Description

Defined in request/request.ts:191

Parameters

Name	Details
retry Required	number

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setRetryTime()

Preview

setRetryTime(retryTime)

Description

Defined in request/request.ts:201

Parameters

Name	Details
retryTime Required	number

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

setUsed()

Preview

setUsed(used)

Description

Defined in request/request.ts:273

Parameters

Name	Details
used Required	boolean

Return

Request<Response, Payload, QueryParams, GlobalError, LocalError, Endpoint, AdapterType, HasData, HasParams, HasQuery>

---

toJSON()

Preview

toJSON()

Description

Defined in request/request.ts:365

Return

{
  abortKey: string;
  auth: boolean;
  cache: boolean;
  cacheKey: string;
  cacheTime: number;
  cancelable: boolean;
  data: Payload | \null\ | \undefined\;
  deduplicate: boolean;
  deduplicateTime: number;
  disableRequestInterceptors: boolean | undefined;
  disableResponseInterceptors: boolean | undefined;
  effectKey: string;
  endpoint: string;
  garbageCollection: number;
  headers: HeadersInit;
  method: T extends BaseAdapterType<any, infer M, any, any, any> ? M : never;
  offline: boolean;
  options: AdapterOptions | T extends BaseAdapterType<infer O, any, any, any, any> ? O : never;
  params: Params | \null\ | \undefined\;
  queryParams: QueryParams | \null\ | \undefined\;
  queueKey: string;
  queued: boolean;
  requestOptions: {
    abortKey: string;
    auth: boolean;
    cache: boolean;
    cacheKey: string;
    cacheTime: number;
    cancelable: boolean;
    deduplicate: boolean;
    deduplicateTime: number;
    disableRequestInterceptors: boolean;
    disableResponseInterceptors: boolean;
    effectKey: string;
    endpoint: GenericEndpoint;
    garbageCollection: number;
    headers: HeadersInit;
    method: RequestMethods;
    offline: boolean;
    options: AdapterOptions;
    queueKey: string;
    queued: boolean;
    retry: number;
    retryTime: number;
  };
  retry: number;
  retryTime: number;
  updatedAbortKey: boolean;
  updatedCacheKey: boolean;
  updatedEffectKey: boolean;
  updatedQueueKey: boolean;
  used: boolean;
}

---