1.0.0
GitHub

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

HttpOptions

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

PromiseFunction‹T›

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

BufferEncoding

"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

HttpInterceptor

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

ContentTypeMap‹T›

defaultResult

T

Returns: T

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

Type parameters:

▪ T

Parameters:

NameType

contentType

string

map

ContentTypeMap‹T›

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

PreviousInterceptorsNextGlobals

Last updated