goog.testing.LooseMock

Provided By	`goog.testing.LooseMock`
Extends	`goog.testing.Mock`
All Implemented Interfaces	`goog.testing.MockInterface`
All Known Direct Subclasses	`goog.testing.MockRange` `goog.testing.editor.FieldMock`

This is a mock that does not care about the order of method calls. As a result, it won't throw exceptions until verify() is called. The only exception is that if a method is called that has no expectations, then an exception will be thrown.

new LooseMock( `objectToMock`, `opt_ignoreUnexpectedCalls`, `opt_mockStaticMethods`, `opt_createProxy` )

Parameters

`objectToMock`	`(Object\|null)`
	The object that should be mocked, or the constructor of an object to mock.
`opt_ignoreUnexpectedCalls`	`boolean=`
	Whether to ignore unexpected calls.
`opt_mockStaticMethods`	`boolean=`
	An optional argument denoting that a mock should be constructed from the static functions of a class.
`opt_createProxy`	`boolean=`
	An optional argument denoting that a proxy for the target mock should be created.

VIEW SOURCE

Instance Methods

Allows the expectation to be called any number of times.

Defined by

goog.testing.Mock

Parameters

None.

Returns

goog.testing.Mock

This mock object.

VIEW SOURCE

Render the provided argument array to a string to help clients with debugging tests.

Defined by

goog.testing.Mock

Parameters

`args`	`(Array<*>\|null)`
	The arguments passed to the mock.

Returns

string

Human-readable string.

VIEW SOURCE

Allows the expectation to be called any number of times, as long as it's called once.

Defined by

goog.testing.Mock

Parameters

None.

Returns

goog.testing.Mock

This mock object.

VIEW SOURCE

Allows the expectation to be called 0 or 1 times.

Defined by

goog.testing.Mock

Parameters

None.

Returns

goog.testing.Mock

This mock object.

VIEW SOURCE

If this expectation defines a function to be called, it will be called and its result will be returned. Otherwise, if the expectation expects to throw, it will throw. Otherwise, this method will return defined value.

Defined by

goog.testing.Mock

Parameters

`expectation`	`(goog.testing.MockExpectation\|null)`
	The expectation.
`args`	`(Array<?>\|null)`
	The arguments to the method.

Returns

*

The return value expected by the mock.

VIEW SOURCE

Specifies a function to call for currently pending expectation. Note, that using this method overrides declarations made using $returns() and $throws() methods.

Defined by

goog.testing.Mock

Parameters

`func`	`(Function\|null)`
	The function to call.

Returns

goog.testing.Mock

This mock object.

VIEW SOURCE

If the expectation expects to throw, this method will throw.

Defined by

goog.testing.Mock

Parameters

`expectation`	`(goog.testing.MockExpectation\|null)`
	The expectation.

VIEW SOURCE

The function that replaces all methods on the mock object.

Defined by

goog.testing.Mock

Parameters

`name`	`string`
	The name of the method being mocked.

Returns

*

In record mode, returns the mock object. In replay mode, returns whatever the creator of the mock set as the return value.

VIEW SOURCE

Disallows the expectation from being called.

Defined by

goog.testing.Mock

Parameters

None.

Returns

goog.testing.Mock

This mock object.

VIEW SOURCE

Allows the expectation to be called exactly once.

Defined by

goog.testing.Mock

Parameters

None.

Returns

goog.testing.Mock

This mock object.

VIEW SOURCE

Throws an exception and records that an exception was thrown.

Defined by

goog.testing.Mock

Parameters

`ex`	`(Object\|null)`
	Exception.
`rethrow`	`boolean=`
	True if this exception has already been thrown. If so, we should not report it to TestCase (since it was already reported at the original throw). This is necessary to avoid logging it twice, because assertThrowsJsUnitException only removes one record.

Throws

{Object} #ex.

VIEW SOURCE

Records an actual method call, intended to be overridden by a subclass. The subclass must find the pending expectation and return the correct value.

Overrides

goog.testing.Mock

Parameters

`name`	`string`
	The name of the method being called.
`args`	`(Array<?>\|null)`
	The arguments to the method.

Returns

*

The return expected by the mock.

VIEW SOURCE

Records the currently pending expectation, intended to be overridden by a subclass.

Overrides	`goog.testing.Mock`
Parameters	None.

VIEW SOURCE

Registers a verifier function to use when verifying method argument lists.

Defined by

goog.testing.Mock

Parameters

`methodName`	`string`
	The name of the method for which the verifierFn should be used.
`fn`	`(Function\|null)`
	Argument list verifier function. Should take 2 argument arrays as arguments, and return true if they are considered equivalent.

Returns

goog.testing.Mock

This mock object.

VIEW SOURCE

Write down all the expected functions that have been called on the mock so far. From here on out, future function calls will be compared against this list.

Overrides	`goog.testing.Mock`
Specified by	`goog.testing.MockInterface`
Parameters	None.

VIEW SOURCE

Reset the mock.

Overrides	`goog.testing.Mock`
Specified by	`goog.testing.MockInterface`
Parameters	None.

VIEW SOURCE

Specifies a return value for the currently pending expectation.

Defined by

goog.testing.Mock

Parameters

`val`	`*`
	The return value.

Returns

goog.testing.Mock

This mock object.

VIEW SOURCE

A setter for the ignoreUnexpectedCalls field.

Parameters

`ignoreUnexpectedCalls`	`boolean`
	Whether to ignore unexpected calls.

Returns

goog.testing.LooseMock

This mock object.

VIEW SOURCE

Throw an exception based on an incorrect method call.

Defined by

goog.testing.Mock

Parameters

`name`	`string`
	Name of method called.
`args`	`(Array<*>\|null)`
	Arguments passed to the mock.
`opt_expectation`	`(goog.testing.MockExpectation\|null)=`
	Expected next call, if any.

VIEW SOURCE

Throws an exception and records that an exception was thrown.

Defined by

goog.testing.Mock

Parameters

`comment`	`string`
	A short comment about the exception.
`opt_message`	`(string\|null)=`
	A longer message about the exception.

Throws

{Object} JsUnitException object.

VIEW SOURCE

Specifies a value for the currently pending expectation to throw.

Defined by

goog.testing.Mock

Parameters

`val`	`*`
	The value to throw.

Returns

goog.testing.Mock

This mock object.

VIEW SOURCE

Specifies the number of times the expectation should be called.

Defined by

goog.testing.Mock

Parameters

`times`	`number`
	The number of times this method will be called.

Returns

goog.testing.Mock

This mock object.

VIEW SOURCE

Assert that the expected function calls match the actual calls.

Overrides	`goog.testing.Mock`
Specified by	`goog.testing.MockInterface`
Parameters	None.

VIEW SOURCE

Verifies that a method call matches an expectation.

Defined by

goog.testing.Mock

Parameters

`expectation`	`(goog.testing.MockExpectation\|null)`
	The expectation to check.
`name`	`string`
	The name of the called method.
`args`	`(Array<*>\|null)`
	The arguments passed to the mock.

Returns

boolean

Whether the call matches the expectation.

VIEW SOURCE

Waits for the Mock to gather expectations and then performs verify.

Overrides

goog.testing.Mock

Specified by

goog.testing.MockInterface

Parameters

None.

Returns

goog.Promise<undefined, ?>

VIEW SOURCE

Instance Properties

Map of argument name to optional argument list verifier function.

VIEW SOURCE

The expectation currently being created. All methods that modify the current expectation return the Mock object for easy chaining, so this is where we keep track of the expectation that's currently being modified.

VIEW SOURCE

A proxy for the mock. This can be used for dependency injection in lieu of the mock if the test requires a strict instanceof check.

VIEW SOURCE

No information.

VIEW SOURCE

goog.testing.LooseMock

new LooseMock( `objectToMock`, `opt_ignoreUnexpectedCalls`, `opt_mockStaticMethods`, `opt_createProxy` )

Instance Methods

`this.`$anyTimes() `→` `goog.testing.Mock`

`this.`$argumentsAsString( `args` ) `→` `string`

`this.`$atLeastOnce() `→` `goog.testing.Mock`

`this.`$atMostOnce() `→` `goog.testing.Mock`

`this.`$do( `expectation`, `args` ) `→` `*`

`this.`$does( `func` ) `→` `goog.testing.Mock`

`this.`$maybeThrow( `expectation` ) `→` `void`

`this.`$mockMethod( `name` ) `→` `*`

`this.`$never() `→` `goog.testing.Mock`

`this.`$once() `→` `goog.testing.Mock`

`this.`$recordAndThrow( `ex`, `rethrow` ) `→` `void`

`this.`$recordCall( `name`, `args` ) `→` `*`

`this.`$recordExpectation() `→` `void`

`this.`$registerArgumentListVerifier( `methodName`, `fn` ) `→` `goog.testing.Mock`

`this.`$replay() `→` `void`

`this.`$reset() `→` `void`

`this.`$returns( `val` ) `→` `goog.testing.Mock`

`this.`$setIgnoreUnexpectedCalls( `ignoreUnexpectedCalls` ) `→` `goog.testing.LooseMock`

`this.`$throwCallException( `name`, `args`, `opt_expectation` ) `→` `void`

`this.`$throwException( `comment`, `opt_message` ) `→` `void`

`this.`$throws( `val` ) `→` `goog.testing.Mock`

`this.`$times( `times` ) `→` `goog.testing.Mock`

`this.`$verify() `→` `void`

`this.`$verifyCall( `expectation`, `name`, `args` ) `→` `boolean`

`this.`$waitAndVerify() `→` `goog.Promise<undefined, ?>`

Instance Properties

`this.`$argumentListVerifiers_ `→` `(Object|null)`

`this.`$pendingExpectation `→` `(goog.testing.MockExpectation|null)`

`this.`$proxy `→` `(Object|null)`

`this.`waitingForExpectations `→` `(goog.promise.Resolver<undefined>|null)`

goog.testing.LooseMock

new LooseMock( objectToMock, opt_ignoreUnexpectedCalls, opt_mockStaticMethods, opt_createProxy )

Instance Methods

this.$anyTimes() → goog.testing.Mock

this.$argumentsAsString( args ) → string

this.$atLeastOnce() → goog.testing.Mock

this.$atMostOnce() → goog.testing.Mock

this.$do( expectation, args ) → *

this.$does( func ) → goog.testing.Mock

this.$maybeThrow( expectation ) → void

this.$mockMethod( name ) → *

this.$never() → goog.testing.Mock

this.$once() → goog.testing.Mock

this.$recordAndThrow( ex, rethrow ) → void

this.$recordCall( name, args ) → *

this.$recordExpectation() → void

this.$registerArgumentListVerifier( methodName, fn ) → goog.testing.Mock

this.$replay() → void

this.$reset() → void

this.$returns( val ) → goog.testing.Mock

this.$setIgnoreUnexpectedCalls( ignoreUnexpectedCalls ) → goog.testing.LooseMock

this.$throwCallException( name, args, opt_expectation ) → void

this.$throwException( comment, opt_message ) → void

this.$throws( val ) → goog.testing.Mock

this.$times( times ) → goog.testing.Mock

this.$verify() → void

this.$verifyCall( expectation, name, args ) → boolean

this.$waitAndVerify() → goog.Promise<undefined, ?>

Instance Properties

this.$argumentListVerifiers_ → (Object|null)

this.$pendingExpectation → (goog.testing.MockExpectation|null)

this.$proxy → (Object|null)

this.waitingForExpectations → (goog.promise.Resolver<undefined>|null)

new LooseMock( `objectToMock`, `opt_ignoreUnexpectedCalls`, `opt_mockStaticMethods`, `opt_createProxy` )

`this.`$anyTimes() `→` `goog.testing.Mock`

`this.`$argumentsAsString( `args` ) `→` `string`

`this.`$atLeastOnce() `→` `goog.testing.Mock`

`this.`$atMostOnce() `→` `goog.testing.Mock`

`this.`$do( `expectation`, `args` ) `→` `*`

`this.`$does( `func` ) `→` `goog.testing.Mock`

`this.`$maybeThrow( `expectation` ) `→` `void`

`this.`$mockMethod( `name` ) `→` `*`

`this.`$never() `→` `goog.testing.Mock`

`this.`$once() `→` `goog.testing.Mock`

`this.`$recordAndThrow( `ex`, `rethrow` ) `→` `void`

`this.`$recordCall( `name`, `args` ) `→` `*`

`this.`$recordExpectation() `→` `void`

`this.`$registerArgumentListVerifier( `methodName`, `fn` ) `→` `goog.testing.Mock`

`this.`$replay() `→` `void`

`this.`$reset() `→` `void`

`this.`$returns( `val` ) `→` `goog.testing.Mock`

`this.`$setIgnoreUnexpectedCalls( `ignoreUnexpectedCalls` ) `→` `goog.testing.LooseMock`

`this.`$throwCallException( `name`, `args`, `opt_expectation` ) `→` `void`

`this.`$throwException( `comment`, `opt_message` ) `→` `void`

`this.`$throws( `val` ) `→` `goog.testing.Mock`

`this.`$times( `times` ) `→` `goog.testing.Mock`

`this.`$verify() `→` `void`

`this.`$verifyCall( `expectation`, `name`, `args` ) `→` `boolean`

`this.`$waitAndVerify() `→` `goog.Promise<undefined, ?>`

`this.`$argumentListVerifiers_ `→` `(Object|null)`

`this.`$pendingExpectation `→` `(goog.testing.MockExpectation|null)`

`this.`$proxy `→` `(Object|null)`

`this.`waitingForExpectations `→` `(goog.promise.Resolver<undefined>|null)`