HttpTestingController

From Get docs
< @angular/common‎ | http‎ | testingAngular/docs/8/api/common/http/testing/httptestingcontroller


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?: { ignoreCancelled?: boolean; }): 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 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...

Show All Hide All

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

Parameters
url string
description string Optional. Default is undefined.
Returns

TestRequest


Overload #1

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 RequestMatch
description string Optional. Default is undefined.
Returns

TestRequest


Overload #2

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 (req: HttpRequest) => boolean
description string Optional. Default is undefined.
Returns

TestRequest


Overload #3

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 RequestMatch | ((req: HttpRequest) => boolean)
description 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...

Show All Hide All

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

Parameters
url string
description string Optional. Default is undefined.
Returns

void


Overload #1

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


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

Parameters
params RequestMatch
description string Optional. Default is undefined.
Returns

void


Overload #2

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 (req: HttpRequest) => boolean
description string Optional. Default is undefined.
Returns

void


Overload #3

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 RequestMatch | ((req: HttpRequest) => boolean)
description 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 object 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–2020 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://v8.angular.io/api/common/http/testing/HttpTestingController