HttpTestingController

class

Controller to be injected into tests, that allows for mocking and flushing of requests.

abstract class HttpTestingController {
  abstract match(match: string | RequestMatch | ((req: HttpRequest<any>) => boolean)): TestRequest[]
  abstract expectOne(url: string, description?: string): TestRequest
  abstract expectNone(url: string, description?: string): void
  abstract verify(opts?: {...}): void
}

Methods

Search for requests that match the given parameter, without any expectations.

abstract match(match: string | RequestMatch | ((req: HttpRequest<any>) => boolean)): TestRequest[]

Parameters

match

Type: string | RequestMatch | ((req: HttpRequest) => boolean).

Returns

TestRequest[]

Expect that a single request has been made which matches the given URL, and return its mock.

3 overloads...

abstract expectOne(url: string, description?: string): TestRequest

Parameters

url

Type: string.

description

Type: string.

Optional. Default is undefined.

Returns

TestRequest

Expect that a single request has been made which matches the given parameters, and return its mock.

abstract expectOne(params: RequestMatch, description?: string): TestRequest

Parameters

params

Type: RequestMatch.

description

Type: string.

Optional. Default is undefined.

Returns

TestRequest

Expect that a single request has been made which matches the given predicate function, and return its mock.

abstract expectOne(matchFn: ((req: HttpRequest<any>) => boolean), description?: string): TestRequest

Parameters

matchFn

Type: ((req: HttpRequest) => boolean).

description

Type: string.

Optional. Default is undefined.

Returns

TestRequest

Expect that a single request has been made which matches the given condition, and return its mock.

abstract expectOne(match: string | RequestMatch | ((req: HttpRequest<any>) => boolean), description?: string): TestRequest

Parameters

match

Type: string | RequestMatch | ((req: HttpRequest) => boolean).

description

Type: string.

Optional. Default is undefined.

Returns

TestRequest

If no such request has been made, or more than one such request has been made, fail with an error message including the given request description, if any.

Expect that no requests have been made which match the given URL.

3 overloads...

abstract expectNone(url: string, description?: string): void

Parameters

url

Type: string.

description

Type: string.

Optional. Default is undefined.

Returns

void

Expect that no requests have been made which match the given parameters.

abstract expectNone(params: RequestMatch, description?: string): void

Parameters

params

Type: RequestMatch.

description

Type: string.

Optional. Default is undefined.

Returns

void

Expect that no requests have been made which match the given predicate function.

abstract expectNone(matchFn: ((req: HttpRequest<any>) => boolean), description?: string): void

Parameters

matchFn

Type: ((req: HttpRequest) => boolean).

description

Type: string.

Optional. Default is undefined.

Returns

void

Expect that no requests have been made which match the given condition.

abstract expectNone(match: string | RequestMatch | ((req: HttpRequest<any>) => boolean), description?: string): void

Parameters

match

Type: string | RequestMatch | ((req: HttpRequest) => boolean).

description

Type: string.

Optional. Default is undefined.

Returns

void

If a matching request has been made, fail with an error message including the given request description, if any.

Verify that no unmatched requests are outstanding.

abstract verify(opts?: { ignoreCancelled?: boolean; }): void

Parameters

opts

Type: { ignoreCancelled?: boolean; }.

Optional. Default is undefined.

Returns

void

If any requests are outstanding, fail with an error message indicating which requests were not handled.

If ignoreCancelled is not set (the default), verify() will also fail if cancelled requests were not explicitly matched.

© 2010–2019 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://v6.angular.io/api/common/http/testing/HttpTestingController