129 lines
4.1 KiB
JavaScript
129 lines
4.1 KiB
JavaScript
// Copyright 2008 The Closure Library Authors. All Rights Reserved.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS-IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
/**
|
|
* @fileoverview This file defines a strict mock implementation.
|
|
*/
|
|
|
|
goog.provide('goog.testing.StrictMock');
|
|
|
|
goog.require('goog.array');
|
|
goog.require('goog.testing.Mock');
|
|
|
|
|
|
|
|
/**
|
|
* This is a mock that verifies that methods are called in the order that they
|
|
* are specified during the recording phase. Since it verifies order, it
|
|
* follows 'fail fast' semantics. If it detects a deviation from the
|
|
* expectations, it will throw an exception and not wait for verify to be
|
|
* called.
|
|
* @param {Object} objectToMock The object to mock.
|
|
* @param {boolean=} opt_mockStaticMethods An optional argument denoting that
|
|
* a mock should be constructed from the static functions of a class.
|
|
* @param {boolean=} opt_createProxy An optional argument denoting that
|
|
* a proxy for the target mock should be created.
|
|
* @constructor
|
|
* @extends {goog.testing.Mock}
|
|
*/
|
|
goog.testing.StrictMock = function(objectToMock, opt_mockStaticMethods,
|
|
opt_createProxy) {
|
|
goog.testing.Mock.call(this, objectToMock, opt_mockStaticMethods,
|
|
opt_createProxy);
|
|
|
|
/**
|
|
* An array of MockExpectations.
|
|
* @type {Array.<goog.testing.MockExpectation>}
|
|
* @private
|
|
*/
|
|
this.$expectations_ = [];
|
|
};
|
|
goog.inherits(goog.testing.StrictMock, goog.testing.Mock);
|
|
|
|
|
|
/** @override */
|
|
goog.testing.StrictMock.prototype.$recordExpectation = function() {
|
|
this.$expectations_.push(this.$pendingExpectation);
|
|
};
|
|
|
|
|
|
/** @override */
|
|
goog.testing.StrictMock.prototype.$recordCall = function(name, args) {
|
|
if (this.$expectations_.length == 0) {
|
|
this.$throwCallException(name, args);
|
|
}
|
|
|
|
// If the current expectation has a different name, make sure it was called
|
|
// enough and then discard it. We're through with it.
|
|
var currentExpectation = this.$expectations_[0];
|
|
while (!this.$verifyCall(currentExpectation, name, args)) {
|
|
|
|
// This might be an item which has passed its min, and we can now
|
|
// look past it, or it might be below its min and generate an error.
|
|
if (currentExpectation.actualCalls < currentExpectation.minCalls) {
|
|
this.$throwCallException(name, args, currentExpectation);
|
|
}
|
|
|
|
this.$expectations_.shift();
|
|
if (this.$expectations_.length < 1) {
|
|
// Nothing left, but this may be a failed attempt to call the previous
|
|
// item on the list, which may have been between its min and max.
|
|
this.$throwCallException(name, args, currentExpectation);
|
|
}
|
|
currentExpectation = this.$expectations_[0];
|
|
}
|
|
|
|
if (currentExpectation.maxCalls == 0) {
|
|
this.$throwCallException(name, args);
|
|
}
|
|
|
|
currentExpectation.actualCalls++;
|
|
// If we hit the max number of calls for this expectation, we're finished
|
|
// with it.
|
|
if (currentExpectation.actualCalls == currentExpectation.maxCalls) {
|
|
this.$expectations_.shift();
|
|
}
|
|
|
|
return this.$do(currentExpectation, args);
|
|
};
|
|
|
|
|
|
/** @override */
|
|
goog.testing.StrictMock.prototype.$reset = function() {
|
|
goog.testing.StrictMock.superClass_.$reset.call(this);
|
|
|
|
goog.array.clear(this.$expectations_);
|
|
};
|
|
|
|
|
|
/** @override */
|
|
goog.testing.StrictMock.prototype.$verify = function() {
|
|
goog.testing.StrictMock.superClass_.$verify.call(this);
|
|
|
|
while (this.$expectations_.length > 0) {
|
|
var expectation = this.$expectations_[0];
|
|
if (expectation.actualCalls < expectation.minCalls) {
|
|
this.$throwException('Missing a call to ' + expectation.name +
|
|
'\nExpected: ' + expectation.minCalls + ' but was: ' +
|
|
expectation.actualCalls);
|
|
|
|
} else {
|
|
// Don't need to check max, that's handled when the call is made
|
|
this.$expectations_.shift();
|
|
}
|
|
}
|
|
};
|
|
|
|
|