Class FetchHttpApi<O>

Type Parameters

O extends IHttpOpts

Hierarchy

FetchHttpApi
- MatrixHttpApi

Index

Constructors

constructor

new FetchHttpApi<O>(eventEmitter: TypedEventEmitter<HttpApiEvent, HttpApiEventHandlerMap, HttpApiEventHandlerMap>, opts: O): FetchHttpApi<O>
Type Parameters
- O extends IHttpOpts
Parameters
- eventEmitter: TypedEventEmitter<HttpApiEvent, HttpApiEventHandlerMap, HttpApiEventHandlerMap>
- opts: O
Returns FetchHttpApi<O>
- Defined in src/http-api/fetch.ts:44

Properties

`Private` abortController

abortController: AbortController = ...

`Private` eventEmitter

eventEmitter: TypedEventEmitter<HttpApiEvent, HttpApiEventHandlerMap, HttpApiEventHandlerMap>

`Readonly` opts

opts: O

Methods

abort

abort(): void
Returns void
- Defined in src/http-api/fetch.ts:53

authedRequest

authedRequest<T>(method: Method, path: string, queryParams?: QueryDict, body?: Body, opts?: IRequestOpts): Promise<ResponseType<T, O>>
Perform an authorised request to the homeserver.

Returns
Promise which resolves to
```
{
    data: {Object},
    headers: {Object},
    code: {Number},
}
```
If onlyData is set, this will resolve to the data object only.

Returns
Rejects with an error if a problem occurred. This includes network problems and Matrix-specific error JSON.
Type Parameters
- T
Parameters
- method: Method
  
  The HTTP method e.g. "GET".
- path: string
  
  The HTTP path after the supplied prefix e.g. "/createRoom".
- Optional queryParams: QueryDict
  
  A dict of query params (these will NOT be urlencoded). If unspecified, there will be no query params.
- Optional body: Body
  
  The HTTP JSON body.
- opts: IRequestOpts = {}
  
  additional options. If a number is specified, this is treated as opts.localTimeoutMs.
Returns Promise<ResponseType<T, O>>
- Defined in src/http-api/fetch.ts:131

fetch

fetch(resource: string | URL, options?: RequestInit): Promise<Response>
Parameters
- resource: string | URL
- Optional options: RequestInit
Returns Promise<Response>
- Defined in src/http-api/fetch.ts:58

getUrl

getUrl(path: string, queryParams?: QueryDict, prefix?: string, baseUrl?: string): URL
Form and return a homeserver request URL based on the given path params and prefix.

Returns
URL
Parameters
- path: string
  
  The HTTP path after the supplied prefix e.g. "/createRoom".
- Optional queryParams: QueryDict
  
  A dict of query params (these will NOT be urlencoded).
- Optional prefix: string
  
  The full prefix to use e.g. "/_matrix/client/v2_alpha", defaulting to this.opts.prefix.
- Optional baseUrl: string
  
  The baseUrl to use e.g. "https://matrix.org/", defaulting to this.opts.baseUrl.
Returns URL
- Defined in src/http-api/fetch.ts:304

idServerRequest

idServerRequest<T>(method: Method, path: string, params: undefined | Record<string, string | string[]>, prefix: string, accessToken?: string): Promise<ResponseType<T, O>>
Type Parameters
- T extends {} = Record<string, unknown>
Parameters
- method: Method
- path: string
- params: undefined | Record<string, string | string[]>
- prefix: string
- Optional accessToken: string
Returns Promise<ResponseType<T, O>>
- Defined in src/http-api/fetch.ts:73

request

request<T>(method: Method, path: string, queryParams?: QueryDict, body?: Body, opts?: IRequestOpts): Promise<ResponseType<T, O>>
Perform a request to the homeserver without any credentials.

Returns
Promise which resolves to
```
{
 data: {Object},
 headers: {Object},
 code: {Number},
}
```
If onlyData</code> is set, this will resolve to the <code>data object only.

Returns
Rejects with an error if a problem occurred. This includes network problems and Matrix-specific error JSON.
Type Parameters
- T
Parameters
- method: Method
  
  The HTTP method e.g. "GET".
- path: string
  
  The HTTP path after the supplied prefix e.g. "/createRoom".
- Optional queryParams: QueryDict
  
  A dict of query params (these will NOT be urlencoded). If unspecified, there will be no query params.
- Optional body: Body
  
  The HTTP JSON body.
- Optional opts: IRequestOpts
  
  additional options
Returns Promise<ResponseType<T, O>>
- Defined in src/http-api/fetch.ts:197

requestOtherUrl

requestOtherUrl<T>(method: Method, url: string | URL, body?: Body, opts?: Pick<IRequestOpts, "json" | "headers" | "localTimeoutMs" | "keepAlive" | "abortSignal">): Promise<ResponseType<T, O>>
Perform a request to an arbitrary URL.

Returns
Promise which resolves to data unless onlyData is specified as false, where the resolved value will be a fetch Response object.

Returns
Rejects with an error if a problem occurred. This includes network problems and Matrix-specific error JSON.
Type Parameters
- T
Parameters
- method: Method
  
  The HTTP method e.g. "GET".
- url: string | URL
  
  The HTTP URL object.
- Optional body: Body
  
  The HTTP JSON body.
- opts: Pick<IRequestOpts, "json" | "headers" | "localTimeoutMs" | "keepAlive" | "abortSignal"> = {}
  
  additional options
Returns Promise<ResponseType<T, O>>
- Defined in src/http-api/fetch.ts:222

setIdBaseUrl

setIdBaseUrl(url: string): void
Sets the base URL for the identity server
Parameters
- url: string
  
  The new base url
Returns void
- Defined in src/http-api/fetch.ts:69

Class FetchHttpApi<O>

Type Parameters

O extends IHttpOpts

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Type Parameters

O extends IHttpOpts

Parameters

eventEmitter: TypedEventEmitter<HttpApiEvent, HttpApiEventHandlerMap, HttpApiEventHandlerMap>

opts: O

Returns FetchHttpApi<O>

Properties

Private abortController

Private eventEmitter

Readonly opts

Methods

abort

Returns void

authedRequest

Returns

Returns

Type Parameters

T

Parameters

method: Method

path: string

Optional queryParams: QueryDict

Optional body: Body

opts: IRequestOpts = {}

Returns Promise<ResponseType<T, O>>

fetch

Parameters

resource: string | URL

Optional options: RequestInit

Returns Promise<Response>

getUrl

Returns

Parameters

path: string

Optional queryParams: QueryDict

Optional prefix: string

Optional baseUrl: string

Returns URL

idServerRequest

Type Parameters

T extends {} = Record<string, unknown>

Parameters

method: Method

path: string

params: undefined | Record<string, string | string[]>

prefix: string

Optional accessToken: string

Returns Promise<ResponseType<T, O>>

request

Returns

Returns

Type Parameters

T

Parameters

method: Method

path: string

Optional queryParams: QueryDict

Optional body: Body

Optional opts: IRequestOpts

Returns Promise<ResponseType<T, O>>

requestOtherUrl

Returns

Returns

Type Parameters

T

Parameters

method: Method

url: string | URL

Optional body: Body

opts: Pick<IRequestOpts, "json" | "headers" | "localTimeoutMs" | "keepAlive" | "abortSignal"> = {}

`Private` abortController

`Private` eventEmitter

`Readonly` opts

`Optional` queryParams: QueryDict

`Optional` body: Body

`Optional` options: RequestInit

`Optional` queryParams: QueryDict

`Optional` prefix: string

`Optional` baseUrl: string

`Optional` accessToken: string

`Optional` queryParams: QueryDict

`Optional` body: Body

`Optional` opts: IRequestOpts

`Optional` body: Body