Files
openlayers/float-no-zero/closure-library/closure/goog/testing/mockuseragent.js
2014-03-07 10:55:12 +01:00

142 lines
3.5 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 MockUserAgent overrides goog.userAgent.getUserAgentString()
* depending on a specified configuration.
*
*/
goog.provide('goog.testing.MockUserAgent');
goog.require('goog.Disposable');
goog.require('goog.userAgent');
/**
* Class for unit testing code that uses goog.userAgent.
*
* @extends {goog.Disposable}
* @constructor
*/
goog.testing.MockUserAgent = function() {
goog.Disposable.call(this);
/**
* The userAgent string used by goog.userAgent.
* @type {?string}
* @private
*/
this.userAgent_ = goog.userAgent.getUserAgentString();
/**
* The original goog.userAgent.getUserAgentString function.
* @type {function():?string}
* @private
*/
this.originalUserAgentFunction_ = goog.userAgent.getUserAgentString;
/**
* The navigator object used by goog.userAgent
* @type {Object}
* @private
*/
this.navigator_ = goog.userAgent.getNavigator();
/**
* The original goog.userAgent.getNavigator function
* @type {function():Object}
* @private
*/
this.originalNavigatorFunction_ = goog.userAgent.getNavigator;
};
goog.inherits(goog.testing.MockUserAgent, goog.Disposable);
/**
* Whether this MockUserAgent has been installed.
* @type {boolean}
* @private
*/
goog.testing.MockUserAgent.prototype.installed_;
/**
* Installs this MockUserAgent.
*/
goog.testing.MockUserAgent.prototype.install = function() {
if (!this.installed_) {
goog.userAgent.getUserAgentString =
goog.bind(this.getUserAgentString, this);
goog.userAgent.getNavigator = goog.bind(this.getNavigator, this);
this.installed_ = true;
}
};
/**
* @return {?string} The userAgent set in this class.
*/
goog.testing.MockUserAgent.prototype.getUserAgentString = function() {
return this.userAgent_;
};
/**
* @param {string} userAgent The desired userAgent string to use.
*/
goog.testing.MockUserAgent.prototype.setUserAgentString = function(userAgent) {
this.userAgent_ = userAgent;
};
/**
* @return {Object} The Navigator set in this class.
*/
goog.testing.MockUserAgent.prototype.getNavigator = function() {
return this.navigator_;
};
/**
* @param {Object} navigator The desired Navigator object to use.
*/
goog.testing.MockUserAgent.prototype.setNavigator = function(navigator) {
this.navigator_ = navigator;
};
/**
* Uninstalls the MockUserAgent.
*/
goog.testing.MockUserAgent.prototype.uninstall = function() {
if (this.installed_) {
goog.userAgent.getUserAgentString = this.originalUserAgentFunction_;
goog.userAgent.getNavigator = this.originalNavigatorFunction_;
this.installed_ = false;
}
};
/** @override */
goog.testing.MockUserAgent.prototype.disposeInternal = function() {
this.uninstall();
delete this.userAgent_;
delete this.originalUserAgentFunction_;
delete this.navigator_;
delete this.originalNavigatorFunction_;
goog.testing.MockUserAgent.superClass_.disposeInternal.call(this);
};