Vonage Vetch

Enumerations

ContentType

Enum representing possible MIME types for the 'content-type' HTTP header that Vonage API's could accept.

Note: Most of the APIs will only accept application/json. Please refer to the specific API documentation to determine if another content type is accepted

Enumeration Members

Enumeration Member	Value	Description	Defined in
`CSV`	`"text/csv"`	Represents the MIME type for CSV data.	packages/vetch/lib/enums/contentType.ts:20
`FORM_URLENCODED`	`"application/x-www-form-urlencoded"`	Represents the MIME type for URL-encoded form data.	packages/vetch/lib/enums/contentType.ts:14
`JSON`	`"application/json"`	Represents the MIME type for JSON data.	packages/vetch/lib/enums/contentType.ts:11
`XML`	`"application/xml"`	Represents the MIME type for XML data.	packages/vetch/lib/enums/contentType.ts:17

HTTPMethods

Enum representing the HTTP methods that can be used for Vonage API requests.

Enumeration Members

Enumeration Member	Value	Description	Defined in
`DELETE`	`"DELETE"`	Represents an HTTP DELETE request.	packages/vetch/lib/enums/HTTPMethods.ts:12
`GET`	`"GET"`	Represents an HTTP GET request.	packages/vetch/lib/enums/HTTPMethods.ts:6
`PATCH`	`"PATCH"`	Represents an HTTP PATCH request.	packages/vetch/lib/enums/HTTPMethods.ts:18
`POST`	`"POST"`	Represents an HTTP POST request.	packages/vetch/lib/enums/HTTPMethods.ts:9
`PUT`	`"PUT"`	Represents an HTTP PUT request.	packages/vetch/lib/enums/HTTPMethods.ts:15

ResponseTypes

Deprecated

Enum representing the expected response types for API requests. This was originaly used to set what the expected response type will be. It is better to use the content-type header from the response to decode properly.

Enumeration Members

Enumeration Member	Value	Description	Defined in
`json`	`"json"`	Represents a JSON-formatted response.	packages/vetch/lib/enums/responseTypes.ts:11
`stream`	`"stream"`	Represents a stream response, typically for handling large data or files.	packages/vetch/lib/enums/responseTypes.ts:16
`text`	`"text"`	Represents a plain text response.	packages/vetch/lib/enums/responseTypes.ts:21

Classes

VetchError

Class representing an error from a Vetch API request. Extends the built-in Error class and adds additional properties related to the API request and response.

Template

The type of the data payload in the VetchResponse, expected to be an object that has been decoded from JSON or WebForm.

Extends

Error

Constructors

new VetchError()

new VetchError(
   message, 
   options, 
   response?): VetchError

Creates an instance of VetchError.

Parameters

message

string

The error message.

options

VetchOptions

Configuration options for the API request.

response?

Response

Configuration options for the API request.

Returns

VetchError

Overrides

Error.constructor

Defined in

packages/vetch/lib/errors/vetchError.ts:27

Properties

cause?

optional cause: unknown;

Inherited from

Error.cause

Defined in

node_modules/typescript/lib/lib.es2022.error.d.ts:24

code?

optional code: string;

An optional error code.

Defined in

packages/vetch/lib/errors/vetchError.ts:16

config

config: VetchOptions;

Configuration options for the API request.

Defined in

packages/vetch/lib/errors/vetchError.ts:17

message

message: string;

Inherited from

Error.message

Defined in

node_modules/typescript/lib/lib.es5.d.ts:1077

name

name: string;

Inherited from

Error.name

Defined in

node_modules/typescript/lib/lib.es5.d.ts:1076

response?

optional response: Response;

The API response that resulted in the error.

Defined in

packages/vetch/lib/errors/vetchError.ts:18

stack?

optional stack: string;

Inherited from

Error.stack

Defined in

node_modules/typescript/lib/lib.es5.d.ts:1078

prepareStackTrace()?

static optional prepareStackTrace: (err, stackTraces) => any;

Optional override for formatting stack traces

Parameters

err

Error

stackTraces

CallSite[]

Returns

any

See

https://v8.dev/docs/stack-trace-api#customizing-stack-traces

Inherited from

Error.prepareStackTrace

Defined in

node_modules/@types/node/globals.d.ts:143

stackTraceLimit

static stackTraceLimit: number;

Inherited from

Error.stackTraceLimit

Defined in

node_modules/@types/node/globals.d.ts:145

Methods

captureStackTrace()

static captureStackTrace(targetObject, constructorOpt?): void

Create .stack property on a target object

Parameters

targetObject

object

constructorOpt?

Function

Returns

void

Inherited from

Error.captureStackTrace

Defined in

node_modules/@types/node/globals.d.ts:136

Type Aliases

Headers

type Headers: object;

Interface representing HTTP headers as a string-keyed object. Each property represents a header name, and the associated value can be a string or an array of strings. Includes optional 'authorization' and 'content-type' properties with restricted possible values for 'content-type'.

Index Signature

[index: string]: string

Defined in

packages/vetch/lib/types/headers.ts:7

VetchOptions

type VetchOptions: object;

Options to configure the Vetch request.

Type declaration

appendUserAgent?

optional appendUserAgent: string;

Additional user agent string to append.

body?

optional body: Record<string, string | readonly string[]> | string;

Deprecated

Use 'data' instead of 'body'

checkStatus()?

optional checkStatus: (status) => boolean;

A function to check the response status.

Parameters

status

number

Returns

boolean

data?

optional data: Record<string, string | readonly string[]> | string;

Request body data. Use 'data' instead of 'body' for newer implementations.

headers?

optional headers: Headers;

The headers to be sent with the request.

method

method: HTTPMethods;

The HTTP method to use for the request, e.g., GET, POST, etc.

params?

optional params: Record<string, string | readonly string[]>;

Query parameters for the request.

responseType?

optional responseType: ResponseTypes;

Expected response type.

Deprecated

ResponseTypes is deprecated and will be removed in future versions.

timeout?

optional timeout: number;

Time in milliseconds to wait for the request to complete.

type

type: ContentType;

The content type for the request, e.g., JSON, WebForm, etc.

url

url: string;

The URL endpoint for the request.

Defined in

packages/vetch/lib/types/vetchOptions.ts:7

VetchPromise<T>

type VetchPromise<T>: Promise<VetchResponse<T>>;

Type representing a promise that resolves with a standardized Vetch API response. Vetch ("Vonage Fetch") ensures a consistent API response structure, irrespective of the HTTP adapter utilized by the developer.

Type Parameters

• T

The type of the data payload in the VetchResponse, expected to be an object that has been decoded from JSON or WebForm.

Deprecated

Defined in

packages/vetch/lib/types/vetchPromise.ts:12

VetchResponse<T>

type VetchResponse<T>: object;

Represents the response returned by a Vetch request.

Type Parameters

• T

The type of the response data.

Type declaration

config

config: VetchOptions;

The configuration options used for the request.

data

data: T;

The parsed response data.

headers

headers: Headers;

The response headers.

request

request: VetchOptions;

The configuration options for the request (same as 'config').

status

status: number;

The HTTP status code of the response.

statusText

statusText: string;

The HTTP status text of the response.

Defined in

packages/vetch/lib/types/vetchResponse.ts:9