API

Index

Enumerations

  • BodyCasing

  • ContentType

  • HttpCode

  • HttpMethod

  • ParsedBodyCacheState

Classes

  • CFormData

  • HttpClient

  • HttpRequestError

  • HttpResponseError

  • HttpResponseHeaders

Interfaces

  • BodyParserOptions

  • BodySerializerOptions

  • CFormDataEntryMetadata

  • CFormDataEntryValue

  • Endpoint

  • FetchRequestHandlerOptions

  • FormDataFromOptions

  • HttpClientConfig

  • HttpInterceptorInterface

  • HttpRequestHandlerOptions

  • HttpRequestOptions

  • HttpResponse

  • HttpResponseOptions

  • Log

  • LoggingInterceptorOptions

  • MockOptions

  • NormalizedHttpOptions

  • RawHttpResponse

  • RedirectionInterceptorOptions

  • SimpleServer

  • XhrRequestHandlerOptions

Type aliases

Variables

Functions

Object literals

Type aliases

BodyParser

Ƭ BodyParser: function

Type declaration:

▸ (response: RawHttpResponse): HttpResponse‹T›

Parameters:

NameType

response

RawHttpResponse


BodyParserImplementation

Ƭ BodyParserImplementation: function

Type declaration:

▸ (rawResponse: RawHttpResponse): Promise‹any›

Parameters:

NameType

rawResponse

RawHttpResponse


BodySerializer

Ƭ BodySerializer: function

Type declaration:

▸ (request: HttpOptions): NormalizedHttpBody

Parameters:

NameType

request


BufferEncoding

Ƭ BufferEncoding: "ascii" | "utf8" | "utf-8" | "utf16le" | "ucs2" | "ucs-2" | "base64" | "latin1" | "binary" | "hex"


CFormDataValue

Ƭ CFormDataValue: string | Blob | Readable


CaseConverter

Ƭ CaseConverter: function

Type declaration:

▸ (object: any): any

Parameters:

NameType

object

any


ContentTypeMap

Ƭ ContentTypeMap: Record‹keyof typeof ContentTypeRegex, T›


HttpBody

Ƭ HttpBody: object | TypedArray | string


HttpFetch

Ƭ HttpFetch: function

Type declaration:

▸ (): Promise‹HttpResponse‹Body››


HttpHeaders

Ƭ HttpHeaders: Record‹string, string | number | boolean | undefined | null›


HttpInterceptor

Ƭ HttpInterceptor: HttpInterceptorFunction | HttpInterceptorInterface


HttpInterceptorFunction

Ƭ HttpInterceptorFunction: function

Type declaration:

▸ <Body>(request: HttpFetch‹Body›, options: NormalizedHttpOptions): HttpFetch‹Body›

Type parameters:

Body

Parameters:

NameType

request

HttpFetch‹Body›

options

NormalizedHttpOptions


HttpOptions

Ƭ HttpOptions: Partial‹HttpRequestOptions


HttpRequestHandler

Ƭ HttpRequestHandler: function

Type declaration:

▸ (requestOptions: NormalizedHttpOptions): Promise‹RawHttpResponse

Parameters:

NameType

requestOptions

NormalizedHttpOptions


MockHttpRequestHandler

Ƭ MockHttpRequestHandler: HttpRequestHandler & object


NormalizedHttpBody

Ƭ NormalizedHttpBody: FormData | CFormData | TypedArray | string | undefined


PromiseFunction

Ƭ PromiseFunction: function

Type declaration:

▸ (): Promise‹T›


RequestMode

Ƭ RequestMode: "navigate" | "same-origin" | "no-cors" | "cors"

Variables

Const DEFAULT_REQUEST_TIMEOUT_MS

DEFAULT_REQUEST_TIMEOUT_MS: number = 5 * 60 * 1000

Default request timeout - 5 minutes.


Const DONE

DONE: 4 = 4


Const HEADERS_RECEIVED

HEADERS_RECEIVED: 2 = 2


Const SUPPORTS_BROWSER_FORM_DATA

SUPPORTS_BROWSER_FORM_DATA: boolean = (() => { try { return !({} instanceof FormData); } catch { return false; } })()


TypedArray

TypedArray: any


Const symbol

symbol: unique symbol = Symbol('HttpResponseError')

Functions

Const bodyParser

bodyParser(__namedParameters: object): BodyParser‹any›

Parameters:

Default value __namedParameters: object= {}

NameType

bodyCasing

undefined | CAMEL_CASE | SNAKE_CASE | SCREAMING_SNAKE_CASE | PASCAL_CASE | KEBAB_CASE

customCaseConverter

undefined | function

defaultParser

Returns: BodyParser‹any›


Const bodySerializer

bodySerializer(__namedParameters: object): BodySerializer

Parameters:

Default value __namedParameters: object= {}

NameType

bodyCasing

undefined | CAMEL_CASE | SNAKE_CASE | SCREAMING_SNAKE_CASE | PASCAL_CASE | KEBAB_CASE

Returns: BodySerializer


Const cacheParsedBody

cacheParsedBody<T>(parsedBody: PromiseFunction‹T›): PromiseFunction‹T›

This is not a regular cache! This function is only used across subsequent executions of parsedBody() on a single HttpResponse. To implement cache, make use of interceptors.

Type parameters:

T

Parameters:

NameTypeDescription

parsedBody

a promise function returning parsed body, which in most cases can be called only once

Returns: PromiseFunction‹T›

a promise function returning body, it can be called many times


Const createAsyncBodyHandler

createAsyncBodyHandler<T>(): object

Type parameters:

T

Returns: object

  • call(): Promise‹T›

  • onBodyFailure(failer: function): void

  • onBodyReceived(getter: function): void


Const createErrorInterceptor

createErrorInterceptor(): HttpInterceptorFunction

Returns: HttpInterceptorFunction


Const createHttpResponse

createHttpResponse(__namedParameters: object): HttpResponse

Parameters:

__namedParameters: object

NameTypeDefault

body

undefined | string | Uint8Array‹› | Uint8ClampedArray‹› | Uint16Array‹› | Uint32Array‹› | Int8Array‹› | Int16Array‹› | Int32Array‹› | Float32Array‹› | Float64Array‹›

-

bodyParserOptions

BodyParserOptions

-

headers

undefined | object

-

status

number

-

url

string

""

Returns: HttpResponse


Const createLoggingInterceptor

createLoggingInterceptor(__namedParameters: object): HttpInterceptorFunction

Parameters:

__namedParameters: object

NameType

logger

function

Returns: HttpInterceptorFunction


Const createRedirectionInterceptor

createRedirectionInterceptor(__namedParameters: object): HttpInterceptorFunction

Parameters:

Default value __namedParameters: object= {}

NameTypeDefault

redirectionLimit

number

30

Returns: HttpInterceptorFunction


Const createSimpleServer

createSimpleServer(): SimpleServer

Returns: SimpleServer


Const deepKeyMap

deepKeyMap(object: any, mapper: function): any

Parameters:

object: any

mapper: function

▸ (key: string): string

Parameters:

NameType

key

string

Returns: any


Const defaultHeaders

defaultHeaders(_host: string): object

Parameters:

NameTypeDefault

_host

string

""

Returns: object

  • Accept: string = "application/json,application/vnd.api+json"

  • Content-Type: ContentType = ContentType.JSON


Const encodeArrayBuffer

encodeArrayBuffer(data: TypedArray | string | undefined, encoding: BufferEncoding): Uint8Array‹›

Parameters:

NameTypeDefault

data

TypedArray | string | undefined

""

encoding

"utf8"

Returns: Uint8Array‹›


Const encodeText

encodeText(buffer: ArrayBuffer, encoding: string): string

Parameters:

NameTypeDefault

buffer

ArrayBuffer

-

encoding

string

"utf8"

Returns: string


Const fetchRequestHandler

fetchRequestHandler(fetchRequestHandlerOptions: FetchRequestHandlerOptions): HttpRequestHandler

Creates a new HttpRequestHandler that uses Fetch API underneath. Does not support timeout property. Abort is possible only after headers were received.

Parameters:

NameTypeDefaultDescription

fetchRequestHandlerOptions

FetchRequestHandlerOptions

{}

default Fetch API options attached to all requests

Returns: HttpRequestHandler


Const getBoundaryFromContentTypeHeader

getBoundaryFromContentTypeHeader(header: string[]): string

Parameters:

NameType

header

string[]

Returns: string


Const getCaseConverter

getCaseConverter(bodyCasing?: BodyCasing): toCamelCase

Parameters:

NameType

bodyCasing?

BodyCasing

Returns: toCamelCase


Const getEncodingFromHeaders

getEncodingFromHeaders(headers: HttpResponseHeaders | undefined, fallback: string): string

Parameters:

NameTypeDefault

headers

HttpResponseHeaders | undefined

-

fallback

string

"utf8"

Returns: string


Const getFileMeta

getFileMeta(value: Blob | Readable, existingMeta?: CFormDataEntryMetadata): object | object

Parameters:

NameType

value

Blob | Readable

existingMeta?

CFormDataEntryMetadata

Returns: object | object


Const getHeader

getHeader(headers: HttpHeaders | undefined, header: string): string | undefined

Parameters:

NameType

headers

HttpHeaders | undefined

header

string

Returns: string | undefined


Const getHostname

getHostname(url: string): string

Parameters:

NameType

url

string

Returns: string


Const handleRequest

handleRequest(code: number, body: any, contentType: string): Promise‹HttpResponse

Parameters:

NameTypeDefault

code

number

-

body

any

-

contentType

string

ContentType.TEXT

Returns: Promise‹HttpResponse


Const httpRequestHandler

httpRequestHandler(requestHandlerOptions: HttpRequestHandlerOptions): HttpRequestHandler

Creates a new HttpRequestHandler that uses native Node.js HTTP & HTTPS modules underneath. Does not support mode property.

Parameters:

NameTypeDefaultDescription

requestHandlerOptions

HttpRequestHandlerOptions

{}

default native options attached to all requests

Returns: HttpRequestHandler


Const isBlob

isBlob(value: any): value is Blob

Parameters:

NameType

value

any

Returns: value is Blob


Const isBrowserFormData

isBrowserFormData(value: any): value is FormData

Parameters:

NameType

value

any

Returns: value is FormData


Const isHttpInterceptorInterface

isHttpInterceptorInterface(interceptor: HttpInterceptor): interceptor is HttpInterceptorInterface

Parameters:

NameType

interceptor

Returns: interceptor is HttpInterceptorInterface


Const isHttpRequestError

isHttpRequestError(error: any): error is HttpRequestError

Parameters:

NameType

error

any

Returns: error is HttpRequestError


Const isHttpResponseError

isHttpResponseError(error: any): error is HttpResponseError

Parameters:

NameType

error

any

Returns: error is HttpResponseError


Const mockRequestHandler

mockRequestHandler(mockOptions: MockOptions): MockHttpRequestHandler

Parameters:

NameType

mockOptions

MockOptions

Returns: MockHttpRequestHandler


Const noConversion

noConversion(object: any): any

Parameters:

NameType

object

any

Returns: any


Const parseHeaders

parseHeaders(headers: Headers): Record‹string, string›

Parameters:

NameType

headers

Headers

Returns: Record‹string, string›


Const processMultipartBody

processMultipartBody(body: string, boundary: string): never

Parameters:

NameType

body

string

boundary

string

Returns: never


Const readBlob

readBlob(blob: Blob): Promise‹Buffer›

Parameters:

NameType

blob

Blob

Returns: Promise‹Buffer›


Const sanitizeHeaders

sanitizeHeaders(...multipleHeaders: undefined | object[]): Record‹string, string›

Parameters:

NameType

...multipleHeaders

undefined | object[]

Returns: Record‹string, string›


Const sleep

sleep(ms: number): Promise‹unknown›

Parameters:

NameType

ms

number

Returns: Promise‹unknown›


Const splitWords

splitWords(text: string): string[]

Parameters:

NameType

text

string

Returns: string[]


switchContentType

switchContentType<T>(contentType: string, map: ContentTypeMap‹T›, defaultResult: T): T

Type parameters:

T

Parameters:

NameType

contentType

string

map

defaultResult

T

Returns: T

switchContentType<T>(contentType: string, map: ContentTypeMap‹T›): T | undefined

Type parameters:

T

Parameters:

NameType

contentType

string

map

Returns: T | undefined


Const toCamelCase

toCamelCase(object: any): any

Parameters:

NameType

object

any

Returns: any


Const toKebabCase

toKebabCase(object: any): any

Parameters:

NameType

object

any

Returns: any


Const toPascalCase

toPascalCase(object: any): any

Parameters:

NameType

object

any

Returns: any


Const toScreamingSnakeCase

toScreamingSnakeCase(object: any): any

Parameters:

NameType

object

any

Returns: any


Const toSnakeCase

toSnakeCase(object: any): any

Parameters:

NameType

object

any

Returns: any


Const toUrlEncoded

toUrlEncoded(obj: object): string

Parameters:

NameType

obj

object

Returns: string


Const urlCombine

urlCombine(sourceUrl: string, sourceQuery?: undefined | object, options?: qs.IStringifyOptions): string

Parameters:

NameType

sourceUrl

string

sourceQuery?

undefined | object

options?

qs.IStringifyOptions

Returns: string


Const urlDecode

urlDecode<T>(value: string, options?: qs.IParseOptions): T

Type parameters:

T

Parameters:

NameType

value

string

options?

qs.IParseOptions

Returns: T


Const urlDestruct

urlDestruct(url: string, options?: qs.IParseOptions): object

Parameters:

NameType

url

string

options?

qs.IParseOptions

Returns: object

  • query: any

  • url: string


Const urlEncode

urlEncode(value: any, options?: qs.IStringifyOptions): string

Parameters:

NameType

value

any

options?

qs.IStringifyOptions

Returns: string


Const useInterceptor

useInterceptor(normalizedOptions: NormalizedHttpOptions): (Anonymous function)

Parameters:

NameType

normalizedOptions

NormalizedHttpOptions

Returns: (Anonymous function)


Const xhrRequestHandler

xhrRequestHandler(_?: XhrRequestHandlerOptions): HttpRequestHandler

Parameters:

NameType

_?

XhrRequestHandlerOptions

Returns: HttpRequestHandler

Object literals

Const ContentTypeRegex

ContentTypeRegex: object

JSON

JSON: RegExp‹› = /^application/(json|.++json)$/

MULTIPART

MULTIPART: RegExp‹› = /^multipart//

TEXT

TEXT: RegExp‹› = /^text//

URL_ENCODED

URL_ENCODED: RegExp‹› = /^application/x-www-form-urlencoded$/


Const HttpClientHelper

HttpClientHelper: object

defaultHeaders

defaultHeaders: defaultHeaders

getHostname

getHostname: getHostname

toUrlEncoded

toUrlEncoded: toUrlEncoded


Const HttpStatusText

HttpStatusText: object

__computed

__computed: string = "Network Authentication Required"


Const Interceptors

Interceptors: object

createErrorInterceptor

createErrorInterceptor: createErrorInterceptor

createLoggingInterceptor

createLoggingInterceptor: createLoggingInterceptor

createRedirectionInterceptor

createRedirectionInterceptor: createRedirectionInterceptor

Last updated