RequestBuilder | /mod.ts | dax@0.9.0

class RequestBuilder

implements PromiseLike<RequestResult>

Re-export

import { RequestBuilder } from "https://deno.land/x/dax@0.9.0/mod.ts";

Builder API for downloading files.

Methods

arrayBuffer()

Fetches and gets the response as an array buffer.

blob()

Fetches and gets the response as a blob.

body(value: BodyInit | undefined)

cache(value: RequestCache | undefined)

fetch()

Fetches and gets the response.

header(items: Record<string, string | undefined>): RequestBuilder

Sets multiple headers at the same time via an object literal.

header(name: string, value: string | undefined): RequestBuilder

Sets a header to send with the request.

integrity(value: string | undefined)

json<TResult = any>(): Promise<TResult>

Fetches and gets the response as JSON additionally setting a JSON accept header if not set.

keepalive(value: boolean)

method(value: string)

mode(value: RequestMode)

noThrow(value?: boolean): RequestBuilder

Do not throw if a non-2xx status code is received.

By default the request builder will throw when receiving a non-2xx status code. Specify this to have it not throw.

noThrow(exclusionStatusCode: number, ...additional: number[]): RequestBuilder

Do not throw if a non-2xx status code is received except for these excluded provided status codes.

This overload may be especially useful when wanting to ignore 404 status codes and have it return undefined instead. For example:

const data = await $.request(`https://crates.io/api/v1/crates/${crateName}`)
  .noThrow(404)
  .json<CratesIoMetadata | undefined>();

Note, use multiple arguments to ignore multiple status codes (ex. .noThrow(400, 404)) as multiple calls to .noThrow() will overwrite the previous.

redirect(value: RequestRedirect)

referrer(value: string | undefined)

referrerPolicy(value: ReferrerPolicy | undefined)

text()

Fetches and gets the response as text.

timeout(ms: number | undefined)

Timeout the request after the specified number of milliseconds

url(value: string | URL | undefined)

Specifies the URL to send the request to.