forked from extern/easydiffusion
* New engine.js first draft. * Small fixes... * Bump version for cache... * Improved cancellation code. * Cleaning * Wrong argument used in Task.waitUntil * session_id needs to always match SD.sessionId * Removed passing explicit Session ID from UI. Use SD.sessionID to replace. * Cleaning... Removed a disabled line and a hardcoded value. * Fix return if tasks are still waiting. * Added checkbox to reverse processing order. * Fixed progress not displaying properly. * Renamed reverse label. * Only hide progress bar inside onCompleted. * Thanks to rbertus2000 for helping testing and debugging! * Resolve async promises when used optionally. * when removed var should have used let, not const. * Renamed getTaskErrorHandler to onTaskErrorHandler to better reflect actual implementation. * Switched to the unsafer and less git friendly end of lines comma as requested in review. * Raised SERVER_STATE_VALIDITY_DURATION to 90 seconds to match the changes to Beta. * Added logging. * Added one more hook before those inside the SD engine. * Added selftest.plugin.js as part of core. * Removed a tests that wasn't yet implemented... * Groupped task stopping and abort in single function. * Added optional test for plugins. * Allow prompt text to be selected. * Added comment. * Improved isServerAvailable for better mobile usage and added comments for easier debugging. * Comments... * Normalized EVENT_STATUS_CHANGED to follow the same pattern as the other events. * Disable plugins if editorModifierTagsList is not defined. * Adds a new ServiceContainer to register IOC handlers. * Added expect test for a missing dependency in a ServiceContainer * Moved all event code in it's own sub class for easier reuse. * Removed forgotten unused var... * Allow getPrompts to be reused be plugins. * Renamed EventSource to GenericEventSource to avoid redefining an existing class name. * Added missing time argument to debounce * Added output_quality to engine.js * output_quality need to be an int. * Fixed typo. * Replaced the default euler_a by dpm2 to work with both SD1.# and SD2 * Remove generic completed tasks from plugins on generator complete. * dpm2 starts at step 2, replaced with plms to start at step 1. * Merge error * Merge error * changelog Co-authored-by: Marc-Andre Ferland <madrang@gmail.com>
10469 lines
289 KiB
JavaScript
10469 lines
289 KiB
JavaScript
/*
|
|
Copyright (c) 2008-2022 Pivotal Labs
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining
|
|
a copy of this software and associated documentation files (the
|
|
"Software"), to deal in the Software without restriction, including
|
|
without limitation the rights to use, copy, modify, merge, publish,
|
|
distribute, sublicense, and/or sell copies of the Software, and to
|
|
permit persons to whom the Software is furnished to do so, subject to
|
|
the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be
|
|
included in all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
|
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
|
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
|
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
*/
|
|
// eslint-disable-next-line no-unused-vars,no-var
|
|
var getJasmineRequireObj = (function(jasmineGlobal) {
|
|
let jasmineRequire;
|
|
|
|
if (
|
|
typeof module !== 'undefined' &&
|
|
module.exports &&
|
|
typeof exports !== 'undefined'
|
|
) {
|
|
if (typeof global !== 'undefined') {
|
|
jasmineGlobal = global;
|
|
} else {
|
|
jasmineGlobal = {};
|
|
}
|
|
jasmineRequire = exports;
|
|
} else {
|
|
if (
|
|
typeof window !== 'undefined' &&
|
|
typeof window.toString === 'function' &&
|
|
window.toString() === '[object GjsGlobal]'
|
|
) {
|
|
jasmineGlobal = window;
|
|
}
|
|
jasmineRequire = jasmineGlobal.jasmineRequire = {};
|
|
}
|
|
|
|
function getJasmineRequire() {
|
|
return jasmineRequire;
|
|
}
|
|
|
|
getJasmineRequire().core = function(jRequire) {
|
|
const j$ = {};
|
|
|
|
jRequire.base(j$, jasmineGlobal);
|
|
j$.util = jRequire.util(j$);
|
|
j$.errors = jRequire.errors();
|
|
j$.formatErrorMsg = jRequire.formatErrorMsg();
|
|
j$.Any = jRequire.Any(j$);
|
|
j$.Anything = jRequire.Anything(j$);
|
|
j$.CallTracker = jRequire.CallTracker(j$);
|
|
j$.MockDate = jRequire.MockDate(j$);
|
|
j$.getClearStack = jRequire.clearStack(j$);
|
|
j$.Clock = jRequire.Clock();
|
|
j$.DelayedFunctionScheduler = jRequire.DelayedFunctionScheduler(j$);
|
|
j$.Deprecator = jRequire.Deprecator(j$);
|
|
j$.Env = jRequire.Env(j$);
|
|
j$.StackTrace = jRequire.StackTrace(j$);
|
|
j$.ExceptionFormatter = jRequire.ExceptionFormatter(j$);
|
|
j$.ExpectationFilterChain = jRequire.ExpectationFilterChain();
|
|
j$.Expector = jRequire.Expector(j$);
|
|
j$.Expectation = jRequire.Expectation(j$);
|
|
j$.buildExpectationResult = jRequire.buildExpectationResult(j$);
|
|
j$.JsApiReporter = jRequire.JsApiReporter(j$);
|
|
j$.makePrettyPrinter = jRequire.makePrettyPrinter(j$);
|
|
j$.basicPrettyPrinter_ = j$.makePrettyPrinter();
|
|
j$.MatchersUtil = jRequire.MatchersUtil(j$);
|
|
j$.ObjectContaining = jRequire.ObjectContaining(j$);
|
|
j$.ArrayContaining = jRequire.ArrayContaining(j$);
|
|
j$.ArrayWithExactContents = jRequire.ArrayWithExactContents(j$);
|
|
j$.MapContaining = jRequire.MapContaining(j$);
|
|
j$.SetContaining = jRequire.SetContaining(j$);
|
|
j$.QueueRunner = jRequire.QueueRunner(j$);
|
|
j$.NeverSkipPolicy = jRequire.NeverSkipPolicy(j$);
|
|
j$.SkipAfterBeforeAllErrorPolicy = jRequire.SkipAfterBeforeAllErrorPolicy(
|
|
j$
|
|
);
|
|
j$.CompleteOnFirstErrorSkipPolicy = jRequire.CompleteOnFirstErrorSkipPolicy(
|
|
j$
|
|
);
|
|
j$.ReportDispatcher = jRequire.ReportDispatcher(j$);
|
|
j$.RunableResources = jRequire.RunableResources(j$);
|
|
j$.Runner = jRequire.Runner(j$);
|
|
j$.Spec = jRequire.Spec(j$);
|
|
j$.Spy = jRequire.Spy(j$);
|
|
j$.SpyFactory = jRequire.SpyFactory(j$);
|
|
j$.SpyRegistry = jRequire.SpyRegistry(j$);
|
|
j$.SpyStrategy = jRequire.SpyStrategy(j$);
|
|
j$.StringMatching = jRequire.StringMatching(j$);
|
|
j$.StringContaining = jRequire.StringContaining(j$);
|
|
j$.UserContext = jRequire.UserContext(j$);
|
|
j$.Suite = jRequire.Suite(j$);
|
|
j$.SuiteBuilder = jRequire.SuiteBuilder(j$);
|
|
j$.Timer = jRequire.Timer();
|
|
j$.TreeProcessor = jRequire.TreeProcessor();
|
|
j$.version = jRequire.version();
|
|
j$.Order = jRequire.Order();
|
|
j$.DiffBuilder = jRequire.DiffBuilder(j$);
|
|
j$.NullDiffBuilder = jRequire.NullDiffBuilder(j$);
|
|
j$.ObjectPath = jRequire.ObjectPath(j$);
|
|
j$.MismatchTree = jRequire.MismatchTree(j$);
|
|
j$.GlobalErrors = jRequire.GlobalErrors(j$);
|
|
|
|
j$.Truthy = jRequire.Truthy(j$);
|
|
j$.Falsy = jRequire.Falsy(j$);
|
|
j$.Empty = jRequire.Empty(j$);
|
|
j$.NotEmpty = jRequire.NotEmpty(j$);
|
|
j$.Is = jRequire.Is(j$);
|
|
|
|
j$.matchers = jRequire.requireMatchers(jRequire, j$);
|
|
j$.asyncMatchers = jRequire.requireAsyncMatchers(jRequire, j$);
|
|
|
|
return j$;
|
|
};
|
|
|
|
return getJasmineRequire;
|
|
})(this);
|
|
|
|
getJasmineRequireObj().requireMatchers = function(jRequire, j$) {
|
|
const availableMatchers = [
|
|
'nothing',
|
|
'toBe',
|
|
'toBeCloseTo',
|
|
'toBeDefined',
|
|
'toBeInstanceOf',
|
|
'toBeFalse',
|
|
'toBeFalsy',
|
|
'toBeGreaterThan',
|
|
'toBeGreaterThanOrEqual',
|
|
'toBeLessThan',
|
|
'toBeLessThanOrEqual',
|
|
'toBeNaN',
|
|
'toBeNegativeInfinity',
|
|
'toBeNull',
|
|
'toBePositiveInfinity',
|
|
'toBeTrue',
|
|
'toBeTruthy',
|
|
'toBeUndefined',
|
|
'toContain',
|
|
'toEqual',
|
|
'toHaveSize',
|
|
'toHaveBeenCalled',
|
|
'toHaveBeenCalledBefore',
|
|
'toHaveBeenCalledOnceWith',
|
|
'toHaveBeenCalledTimes',
|
|
'toHaveBeenCalledWith',
|
|
'toHaveClass',
|
|
'toHaveSpyInteractions',
|
|
'toMatch',
|
|
'toThrow',
|
|
'toThrowError',
|
|
'toThrowMatching'
|
|
],
|
|
matchers = {};
|
|
|
|
for (const name of availableMatchers) {
|
|
matchers[name] = jRequire[name](j$);
|
|
}
|
|
|
|
return matchers;
|
|
};
|
|
|
|
getJasmineRequireObj().base = function(j$, jasmineGlobal) {
|
|
/**
|
|
* Maximum object depth the pretty printer will print to.
|
|
* Set this to a lower value to speed up pretty printing if you have large objects.
|
|
* @name jasmine.MAX_PRETTY_PRINT_DEPTH
|
|
* @default 8
|
|
* @since 1.3.0
|
|
*/
|
|
j$.MAX_PRETTY_PRINT_DEPTH = 8;
|
|
/**
|
|
* Maximum number of array elements to display when pretty printing objects.
|
|
* This will also limit the number of keys and values displayed for an object.
|
|
* Elements past this number will be ellipised.
|
|
* @name jasmine.MAX_PRETTY_PRINT_ARRAY_LENGTH
|
|
* @default 50
|
|
* @since 2.7.0
|
|
*/
|
|
j$.MAX_PRETTY_PRINT_ARRAY_LENGTH = 50;
|
|
/**
|
|
* Maximum number of characters to display when pretty printing objects.
|
|
* Characters past this number will be ellipised.
|
|
* @name jasmine.MAX_PRETTY_PRINT_CHARS
|
|
* @default 100
|
|
* @since 2.9.0
|
|
*/
|
|
j$.MAX_PRETTY_PRINT_CHARS = 1000;
|
|
/**
|
|
* Default number of milliseconds Jasmine will wait for an asynchronous spec,
|
|
* before, or after function to complete. This can be overridden on a case by
|
|
* case basis by passing a time limit as the third argument to {@link it},
|
|
* {@link beforeEach}, {@link afterEach}, {@link beforeAll}, or
|
|
* {@link afterAll}. The value must be no greater than the largest number of
|
|
* milliseconds supported by setTimeout, which is usually 2147483647.
|
|
*
|
|
* While debugging tests, you may want to set this to a large number (or pass
|
|
* a large number to one of the functions mentioned above) so that Jasmine
|
|
* does not move on to after functions or the next spec while you're debugging.
|
|
* @name jasmine.DEFAULT_TIMEOUT_INTERVAL
|
|
* @default 5000
|
|
* @since 1.3.0
|
|
*/
|
|
let DEFAULT_TIMEOUT_INTERVAL = 5000;
|
|
Object.defineProperty(j$, 'DEFAULT_TIMEOUT_INTERVAL', {
|
|
get: function() {
|
|
return DEFAULT_TIMEOUT_INTERVAL;
|
|
},
|
|
set: function(newValue) {
|
|
j$.util.validateTimeout(newValue, 'jasmine.DEFAULT_TIMEOUT_INTERVAL');
|
|
DEFAULT_TIMEOUT_INTERVAL = newValue;
|
|
}
|
|
});
|
|
|
|
j$.getGlobal = function() {
|
|
return jasmineGlobal;
|
|
};
|
|
|
|
/**
|
|
* Get the currently booted Jasmine Environment.
|
|
*
|
|
* @name jasmine.getEnv
|
|
* @since 1.3.0
|
|
* @function
|
|
* @return {Env}
|
|
*/
|
|
j$.getEnv = function(options) {
|
|
const env = (j$.currentEnv_ = j$.currentEnv_ || new j$.Env(options));
|
|
//jasmine. singletons in here (setTimeout blah blah).
|
|
return env;
|
|
};
|
|
|
|
j$.isArray_ = function(value) {
|
|
return j$.isA_('Array', value);
|
|
};
|
|
|
|
j$.isObject_ = function(value) {
|
|
return (
|
|
!j$.util.isUndefined(value) && value !== null && j$.isA_('Object', value)
|
|
);
|
|
};
|
|
|
|
j$.isString_ = function(value) {
|
|
return j$.isA_('String', value);
|
|
};
|
|
|
|
j$.isNumber_ = function(value) {
|
|
return j$.isA_('Number', value);
|
|
};
|
|
|
|
j$.isFunction_ = function(value) {
|
|
return j$.isA_('Function', value);
|
|
};
|
|
|
|
j$.isAsyncFunction_ = function(value) {
|
|
return j$.isA_('AsyncFunction', value);
|
|
};
|
|
|
|
j$.isGeneratorFunction_ = function(value) {
|
|
return j$.isA_('GeneratorFunction', value);
|
|
};
|
|
|
|
j$.isTypedArray_ = function(value) {
|
|
return (
|
|
j$.isA_('Float32Array', value) ||
|
|
j$.isA_('Float64Array', value) ||
|
|
j$.isA_('Int16Array', value) ||
|
|
j$.isA_('Int32Array', value) ||
|
|
j$.isA_('Int8Array', value) ||
|
|
j$.isA_('Uint16Array', value) ||
|
|
j$.isA_('Uint32Array', value) ||
|
|
j$.isA_('Uint8Array', value) ||
|
|
j$.isA_('Uint8ClampedArray', value)
|
|
);
|
|
};
|
|
|
|
j$.isA_ = function(typeName, value) {
|
|
return j$.getType_(value) === '[object ' + typeName + ']';
|
|
};
|
|
|
|
j$.isError_ = function(value) {
|
|
if (!value) {
|
|
return false;
|
|
}
|
|
|
|
if (value instanceof Error) {
|
|
return true;
|
|
}
|
|
|
|
return typeof value.stack === 'string' && typeof value.message === 'string';
|
|
};
|
|
|
|
j$.isAsymmetricEqualityTester_ = function(obj) {
|
|
return obj ? j$.isA_('Function', obj.asymmetricMatch) : false;
|
|
};
|
|
|
|
j$.getType_ = function(value) {
|
|
return Object.prototype.toString.apply(value);
|
|
};
|
|
|
|
j$.isDomNode = function(obj) {
|
|
// Node is a function, because constructors
|
|
return typeof jasmineGlobal.Node !== 'undefined'
|
|
? obj instanceof jasmineGlobal.Node
|
|
: obj !== null &&
|
|
typeof obj === 'object' &&
|
|
typeof obj.nodeType === 'number' &&
|
|
typeof obj.nodeName === 'string';
|
|
// return obj.nodeType > 0;
|
|
};
|
|
|
|
j$.isMap = function(obj) {
|
|
return (
|
|
obj !== null &&
|
|
typeof obj !== 'undefined' &&
|
|
obj.constructor === jasmineGlobal.Map
|
|
);
|
|
};
|
|
|
|
j$.isSet = function(obj) {
|
|
return (
|
|
obj !== null &&
|
|
typeof obj !== 'undefined' &&
|
|
obj.constructor === jasmineGlobal.Set
|
|
);
|
|
};
|
|
|
|
j$.isWeakMap = function(obj) {
|
|
return (
|
|
obj !== null &&
|
|
typeof obj !== 'undefined' &&
|
|
obj.constructor === jasmineGlobal.WeakMap
|
|
);
|
|
};
|
|
|
|
j$.isURL = function(obj) {
|
|
return (
|
|
obj !== null &&
|
|
typeof obj !== 'undefined' &&
|
|
obj.constructor === jasmineGlobal.URL
|
|
);
|
|
};
|
|
|
|
j$.isIterable_ = function(value) {
|
|
return value && !!value[Symbol.iterator];
|
|
};
|
|
|
|
j$.isDataView = function(obj) {
|
|
return (
|
|
obj !== null &&
|
|
typeof obj !== 'undefined' &&
|
|
obj.constructor === jasmineGlobal.DataView
|
|
);
|
|
};
|
|
|
|
j$.isPromise = function(obj) {
|
|
return !!obj && obj.constructor === jasmineGlobal.Promise;
|
|
};
|
|
|
|
j$.isPromiseLike = function(obj) {
|
|
return !!obj && j$.isFunction_(obj.then);
|
|
};
|
|
|
|
j$.fnNameFor = function(func) {
|
|
if (func.name) {
|
|
return func.name;
|
|
}
|
|
|
|
const matches =
|
|
func.toString().match(/^\s*function\s*(\w+)\s*\(/) ||
|
|
func.toString().match(/^\s*\[object\s*(\w+)Constructor\]/);
|
|
|
|
return matches ? matches[1] : '<anonymous>';
|
|
};
|
|
|
|
j$.isPending_ = function(promise) {
|
|
const sentinel = {};
|
|
return Promise.race([promise, Promise.resolve(sentinel)]).then(
|
|
function(result) {
|
|
return result === sentinel;
|
|
},
|
|
function() {
|
|
return false;
|
|
}
|
|
);
|
|
};
|
|
|
|
/**
|
|
* Get an {@link AsymmetricEqualityTester}, usable in any {@link matchers|matcher} that uses Jasmine's equality (e.g. {@link matchers#toEqual|toEqual}, {@link matchers#toContain|toContain}, or {@link matchers#toHaveBeenCalledWith|toHaveBeenCalledWith}),
|
|
* that will succeed if the actual value being compared is an instance of the specified class/constructor.
|
|
* @name jasmine.any
|
|
* @since 1.3.0
|
|
* @function
|
|
* @param {Constructor} clazz - The constructor to check against.
|
|
*/
|
|
j$.any = function(clazz) {
|
|
return new j$.Any(clazz);
|
|
};
|
|
|
|
/**
|
|
* Get an {@link AsymmetricEqualityTester}, usable in any {@link matchers|matcher} that uses Jasmine's equality (e.g. {@link matchers#toEqual|toEqual}, {@link matchers#toContain|toContain}, or {@link matchers#toHaveBeenCalledWith|toHaveBeenCalledWith}),
|
|
* that will succeed if the actual value being compared is not `null` and not `undefined`.
|
|
* @name jasmine.anything
|
|
* @since 2.2.0
|
|
* @function
|
|
*/
|
|
j$.anything = function() {
|
|
return new j$.Anything();
|
|
};
|
|
|
|
/**
|
|
* Get an {@link AsymmetricEqualityTester}, usable in any {@link matchers|matcher} that uses Jasmine's equality (e.g. {@link matchers#toEqual|toEqual}, {@link matchers#toContain|toContain}, or {@link matchers#toHaveBeenCalledWith|toHaveBeenCalledWith}),
|
|
* that will succeed if the actual value being compared is `true` or anything truthy.
|
|
* @name jasmine.truthy
|
|
* @since 3.1.0
|
|
* @function
|
|
*/
|
|
j$.truthy = function() {
|
|
return new j$.Truthy();
|
|
};
|
|
|
|
/**
|
|
* Get an {@link AsymmetricEqualityTester}, usable in any {@link matchers|matcher} that uses Jasmine's equality (e.g. {@link matchers#toEqual|toEqual}, {@link matchers#toContain|toContain}, or {@link matchers#toHaveBeenCalledWith|toHaveBeenCalledWith}),
|
|
* that will succeed if the actual value being compared is `null`, `undefined`, `0`, `false` or anything falsey.
|
|
* @name jasmine.falsy
|
|
* @since 3.1.0
|
|
* @function
|
|
*/
|
|
j$.falsy = function() {
|
|
return new j$.Falsy();
|
|
};
|
|
|
|
/**
|
|
* Get an {@link AsymmetricEqualityTester}, usable in any {@link matchers|matcher} that uses Jasmine's equality (e.g. {@link matchers#toEqual|toEqual}, {@link matchers#toContain|toContain}, or {@link matchers#toHaveBeenCalledWith|toHaveBeenCalledWith}),
|
|
* that will succeed if the actual value being compared is empty.
|
|
* @name jasmine.empty
|
|
* @since 3.1.0
|
|
* @function
|
|
*/
|
|
j$.empty = function() {
|
|
return new j$.Empty();
|
|
};
|
|
|
|
/**
|
|
* Get an {@link AsymmetricEqualityTester}, usable in any {@link matchers|matcher}
|
|
* that passes if the actual value is the same as the sample as determined
|
|
* by the `===` operator.
|
|
* @name jasmine.is
|
|
* @function
|
|
* @param {Object} sample - The value to compare the actual to.
|
|
*/
|
|
j$.is = function(sample) {
|
|
return new j$.Is(sample);
|
|
};
|
|
|
|
/**
|
|
* Get an {@link AsymmetricEqualityTester}, usable in any {@link matchers|matcher} that uses Jasmine's equality (e.g. {@link matchers#toEqual|toEqual}, {@link matchers#toContain|toContain}, or {@link matchers#toHaveBeenCalledWith|toHaveBeenCalledWith}),
|
|
* that will succeed if the actual value being compared is not empty.
|
|
* @name jasmine.notEmpty
|
|
* @since 3.1.0
|
|
* @function
|
|
*/
|
|
j$.notEmpty = function() {
|
|
return new j$.NotEmpty();
|
|
};
|
|
|
|
/**
|
|
* Get an {@link AsymmetricEqualityTester}, usable in any {@link matchers|matcher} that uses Jasmine's equality (e.g. {@link matchers#toEqual|toEqual}, {@link matchers#toContain|toContain}, or {@link matchers#toHaveBeenCalledWith|toHaveBeenCalledWith}),
|
|
* that will succeed if the actual value being compared contains at least the keys and values.
|
|
* @name jasmine.objectContaining
|
|
* @since 1.3.0
|
|
* @function
|
|
* @param {Object} sample - The subset of properties that _must_ be in the actual.
|
|
*/
|
|
j$.objectContaining = function(sample) {
|
|
return new j$.ObjectContaining(sample);
|
|
};
|
|
|
|
/**
|
|
* Get an {@link AsymmetricEqualityTester}, usable in any {@link matchers|matcher} that uses Jasmine's equality (e.g. {@link matchers#toEqual|toEqual}, {@link matchers#toContain|toContain}, or {@link matchers#toHaveBeenCalledWith|toHaveBeenCalledWith}),
|
|
* that will succeed if the actual value is a `String` that matches the `RegExp` or `String`.
|
|
* @name jasmine.stringMatching
|
|
* @since 2.2.0
|
|
* @function
|
|
* @param {RegExp|String} expected
|
|
*/
|
|
j$.stringMatching = function(expected) {
|
|
return new j$.StringMatching(expected);
|
|
};
|
|
|
|
/**
|
|
* Get an {@link AsymmetricEqualityTester}, usable in any {@link matchers|matcher} that uses Jasmine's equality (e.g. {@link matchers#toEqual|toEqual}, {@link matchers#toContain|toContain}, or {@link matchers#toHaveBeenCalledWith|toHaveBeenCalledWith}),
|
|
* that will succeed if the actual value is a `String` that contains the specified `String`.
|
|
* @name jasmine.stringContaining
|
|
* @since 3.10.0
|
|
* @function
|
|
* @param {String} expected
|
|
*/
|
|
j$.stringContaining = function(expected) {
|
|
return new j$.StringContaining(expected);
|
|
};
|
|
|
|
/**
|
|
* Get an {@link AsymmetricEqualityTester}, usable in any {@link matchers|matcher} that uses Jasmine's equality (e.g. {@link matchers#toEqual|toEqual}, {@link matchers#toContain|toContain}, or {@link matchers#toHaveBeenCalledWith|toHaveBeenCalledWith}),
|
|
* that will succeed if the actual value is an `Array` that contains at least the elements in the sample.
|
|
* @name jasmine.arrayContaining
|
|
* @since 2.2.0
|
|
* @function
|
|
* @param {Array} sample
|
|
*/
|
|
j$.arrayContaining = function(sample) {
|
|
return new j$.ArrayContaining(sample);
|
|
};
|
|
|
|
/**
|
|
* Get an {@link AsymmetricEqualityTester}, usable in any {@link matchers|matcher} that uses Jasmine's equality (e.g. {@link matchers#toEqual|toEqual}, {@link matchers#toContain|toContain}, or {@link matchers#toHaveBeenCalledWith|toHaveBeenCalledWith}),
|
|
* that will succeed if the actual value is an `Array` that contains all of the elements in the sample in any order.
|
|
* @name jasmine.arrayWithExactContents
|
|
* @since 2.8.0
|
|
* @function
|
|
* @param {Array} sample
|
|
*/
|
|
j$.arrayWithExactContents = function(sample) {
|
|
return new j$.ArrayWithExactContents(sample);
|
|
};
|
|
|
|
/**
|
|
* Get an {@link AsymmetricEqualityTester}, usable in any {@link matchers|matcher} that uses Jasmine's equality (e.g. {@link matchers#toEqual|toEqual}, {@link matchers#toContain|toContain}, or {@link matchers#toHaveBeenCalledWith|toHaveBeenCalledWith}),
|
|
* that will succeed if every key/value pair in the sample passes the deep equality comparison
|
|
* with at least one key/value pair in the actual value being compared
|
|
* @name jasmine.mapContaining
|
|
* @since 3.5.0
|
|
* @function
|
|
* @param {Map} sample - The subset of items that _must_ be in the actual.
|
|
*/
|
|
j$.mapContaining = function(sample) {
|
|
return new j$.MapContaining(sample);
|
|
};
|
|
|
|
/**
|
|
* Get an {@link AsymmetricEqualityTester}, usable in any {@link matchers|matcher} that uses Jasmine's equality (e.g. {@link matchers#toEqual|toEqual}, {@link matchers#toContain|toContain}, or {@link matchers#toHaveBeenCalledWith|toHaveBeenCalledWith}),
|
|
* that will succeed if every item in the sample passes the deep equality comparison
|
|
* with at least one item in the actual value being compared
|
|
* @name jasmine.setContaining
|
|
* @since 3.5.0
|
|
* @function
|
|
* @param {Set} sample - The subset of items that _must_ be in the actual.
|
|
*/
|
|
j$.setContaining = function(sample) {
|
|
return new j$.SetContaining(sample);
|
|
};
|
|
|
|
/**
|
|
* Determines whether the provided function is a Jasmine spy.
|
|
* @name jasmine.isSpy
|
|
* @since 2.0.0
|
|
* @function
|
|
* @param {Function} putativeSpy - The function to check.
|
|
* @return {Boolean}
|
|
*/
|
|
j$.isSpy = function(putativeSpy) {
|
|
if (!putativeSpy) {
|
|
return false;
|
|
}
|
|
return (
|
|
putativeSpy.and instanceof j$.SpyStrategy &&
|
|
putativeSpy.calls instanceof j$.CallTracker
|
|
);
|
|
};
|
|
|
|
/**
|
|
* Logs a message for use in debugging. If the spec fails, trace messages
|
|
* will be included in the {@link SpecResult|result} passed to the
|
|
* reporter's specDone method.
|
|
*
|
|
* This method should be called only when a spec (including any associated
|
|
* beforeEach or afterEach functions) is running.
|
|
* @function
|
|
* @name jasmine.debugLog
|
|
* @since 4.0.0
|
|
* @param {String} msg - The message to log
|
|
*/
|
|
j$.debugLog = function(msg) {
|
|
j$.getEnv().debugLog(msg);
|
|
};
|
|
|
|
/**
|
|
* Replaces Jasmine's global error handling with a spy. This prevents Jasmine
|
|
* from treating uncaught exceptions and unhandled promise rejections
|
|
* as spec failures and allows them to be inspected using the spy's
|
|
* {@link Spy#calls|calls property} and related matchers such as
|
|
* {@link matchers#toHaveBeenCalledWith|toHaveBeenCalledWith}.
|
|
*
|
|
* After installing the spy, spyOnGlobalErrorsAsync immediately calls its
|
|
* argument, which must be an async or promise-returning function. The spy
|
|
* will be passed as the first argument to that callback. Normal error
|
|
* handling will be restored when the promise returned from the callback is
|
|
* settled.
|
|
*
|
|
* Note: The JavaScript runtime may deliver uncaught error events and unhandled
|
|
* rejection events asynchronously, especially in browsers. If the event
|
|
* occurs after the promise returned from the callback is settled, it won't
|
|
* be routed to the spy even if the underlying error occurred previously.
|
|
* It's up to you to ensure that the returned promise isn't resolved until
|
|
* all of the error/rejection events that you want to handle have occurred.
|
|
*
|
|
* You must await the return value of spyOnGlobalErrorsAsync.
|
|
* @name jasmine.spyOnGlobalErrorsAsync
|
|
* @function
|
|
* @async
|
|
* @param {AsyncFunction} fn - A function to run, during which the global error spy will be effective
|
|
* @example
|
|
* it('demonstrates global error spies', async function() {
|
|
* await jasmine.spyOnGlobalErrorsAsync(async function(globalErrorSpy) {
|
|
* setTimeout(function() {
|
|
* throw new Error('the expected error');
|
|
* });
|
|
* await new Promise(function(resolve) {
|
|
* setTimeout(resolve);
|
|
* });
|
|
* const expected = new Error('the expected error');
|
|
* expect(globalErrorSpy).toHaveBeenCalledWith(expected);
|
|
* });
|
|
* });
|
|
*/
|
|
j$.spyOnGlobalErrorsAsync = async function(fn) {
|
|
await jasmine.getEnv().spyOnGlobalErrorsAsync(fn);
|
|
};
|
|
};
|
|
|
|
getJasmineRequireObj().util = function(j$) {
|
|
const util = {};
|
|
|
|
util.isUndefined = function(obj) {
|
|
return obj === void 0;
|
|
};
|
|
|
|
util.clone = function(obj) {
|
|
if (Object.prototype.toString.apply(obj) === '[object Array]') {
|
|
return obj.slice();
|
|
}
|
|
|
|
const cloned = {};
|
|
for (const prop in obj) {
|
|
if (obj.hasOwnProperty(prop)) {
|
|
cloned[prop] = obj[prop];
|
|
}
|
|
}
|
|
|
|
return cloned;
|
|
};
|
|
|
|
util.cloneArgs = function(args) {
|
|
return Array.from(args).map(function(arg) {
|
|
const str = Object.prototype.toString.apply(arg),
|
|
primitives = /^\[object (Boolean|String|RegExp|Number)/;
|
|
|
|
// All falsey values are either primitives, `null`, or `undefined.
|
|
if (!arg || str.match(primitives)) {
|
|
return arg;
|
|
} else if (str === '[object Date]') {
|
|
return new Date(arg.valueOf());
|
|
} else {
|
|
return j$.util.clone(arg);
|
|
}
|
|
});
|
|
};
|
|
|
|
util.getPropertyDescriptor = function(obj, methodName) {
|
|
let descriptor,
|
|
proto = obj;
|
|
|
|
do {
|
|
descriptor = Object.getOwnPropertyDescriptor(proto, methodName);
|
|
proto = Object.getPrototypeOf(proto);
|
|
} while (!descriptor && proto);
|
|
|
|
return descriptor;
|
|
};
|
|
|
|
util.has = function(obj, key) {
|
|
return Object.prototype.hasOwnProperty.call(obj, key);
|
|
};
|
|
|
|
util.errorWithStack = function errorWithStack() {
|
|
// Don't throw and catch. That makes it harder for users to debug their
|
|
// code with exception breakpoints, and it's unnecessary since all
|
|
// supported environments populate new Error().stack
|
|
return new Error();
|
|
};
|
|
|
|
function callerFile() {
|
|
const trace = new j$.StackTrace(util.errorWithStack());
|
|
return trace.frames[2].file;
|
|
}
|
|
|
|
util.jasmineFile = (function() {
|
|
let result;
|
|
|
|
return function() {
|
|
if (!result) {
|
|
result = callerFile();
|
|
}
|
|
|
|
return result;
|
|
};
|
|
})();
|
|
|
|
util.validateTimeout = function(timeout, msgPrefix) {
|
|
// Timeouts are implemented with setTimeout, which only supports a limited
|
|
// range of values. The limit is unspecified, as is the behavior when it's
|
|
// exceeded. But on all currently supported JS runtimes, setTimeout calls
|
|
// the callback immediately when the timeout is greater than 2147483647
|
|
// (the maximum value of a signed 32 bit integer).
|
|
const max = 2147483647;
|
|
|
|
if (timeout > max) {
|
|
throw new Error(
|
|
(msgPrefix || 'Timeout value') + ' cannot be greater than ' + max
|
|
);
|
|
}
|
|
};
|
|
|
|
return util;
|
|
};
|
|
|
|
getJasmineRequireObj().Spec = function(j$) {
|
|
function Spec(attrs) {
|
|
this.expectationFactory = attrs.expectationFactory;
|
|
this.asyncExpectationFactory = attrs.asyncExpectationFactory;
|
|
this.resultCallback = attrs.resultCallback || function() {};
|
|
this.id = attrs.id;
|
|
this.description = attrs.description || '';
|
|
this.queueableFn = attrs.queueableFn;
|
|
this.beforeAndAfterFns =
|
|
attrs.beforeAndAfterFns ||
|
|
function() {
|
|
return { befores: [], afters: [] };
|
|
};
|
|
this.userContext =
|
|
attrs.userContext ||
|
|
function() {
|
|
return {};
|
|
};
|
|
this.onStart = attrs.onStart || function() {};
|
|
this.autoCleanClosures =
|
|
attrs.autoCleanClosures === undefined ? true : !!attrs.autoCleanClosures;
|
|
this.getSpecName =
|
|
attrs.getSpecName ||
|
|
function() {
|
|
return '';
|
|
};
|
|
this.onLateError = attrs.onLateError || function() {};
|
|
this.catchingExceptions =
|
|
attrs.catchingExceptions ||
|
|
function() {
|
|
return true;
|
|
};
|
|
this.throwOnExpectationFailure = !!attrs.throwOnExpectationFailure;
|
|
this.timer = attrs.timer || new j$.Timer();
|
|
|
|
if (!this.queueableFn.fn) {
|
|
this.exclude();
|
|
}
|
|
|
|
/**
|
|
* @typedef SpecResult
|
|
* @property {String} id - The unique id of this spec.
|
|
* @property {String} description - The description passed to the {@link it} that created this spec.
|
|
* @property {String} fullName - The full description including all ancestors of this spec.
|
|
* @property {Expectation[]} failedExpectations - The list of expectations that failed during execution of this spec.
|
|
* @property {Expectation[]} passedExpectations - The list of expectations that passed during execution of this spec.
|
|
* @property {Expectation[]} deprecationWarnings - The list of deprecation warnings that occurred during execution this spec.
|
|
* @property {String} pendingReason - If the spec is {@link pending}, this will be the reason.
|
|
* @property {String} status - Once the spec has completed, this string represents the pass/fail status of this spec.
|
|
* @property {number} duration - The time in ms used by the spec execution, including any before/afterEach.
|
|
* @property {Object} properties - User-supplied properties, if any, that were set using {@link Env#setSpecProperty}
|
|
* @property {DebugLogEntry[]|null} debugLogs - Messages, if any, that were logged using {@link jasmine.debugLog} during a failing spec.
|
|
* @since 2.0.0
|
|
*/
|
|
this.result = {
|
|
id: this.id,
|
|
description: this.description,
|
|
fullName: this.getFullName(),
|
|
failedExpectations: [],
|
|
passedExpectations: [],
|
|
deprecationWarnings: [],
|
|
pendingReason: '',
|
|
duration: null,
|
|
properties: null,
|
|
debugLogs: null
|
|
};
|
|
|
|
this.reportedDone = false;
|
|
}
|
|
|
|
Spec.prototype.addExpectationResult = function(passed, data, isError) {
|
|
const expectationResult = j$.buildExpectationResult(data);
|
|
|
|
if (passed) {
|
|
this.result.passedExpectations.push(expectationResult);
|
|
} else {
|
|
if (this.reportedDone) {
|
|
this.onLateError(expectationResult);
|
|
} else {
|
|
this.result.failedExpectations.push(expectationResult);
|
|
|
|
// TODO: refactor so that we don't need to override cached status
|
|
if (this.result.status) {
|
|
this.result.status = 'failed';
|
|
}
|
|
}
|
|
|
|
if (this.throwOnExpectationFailure && !isError) {
|
|
throw new j$.errors.ExpectationFailed();
|
|
}
|
|
}
|
|
};
|
|
|
|
Spec.prototype.setSpecProperty = function(key, value) {
|
|
this.result.properties = this.result.properties || {};
|
|
this.result.properties[key] = value;
|
|
};
|
|
|
|
Spec.prototype.expect = function(actual) {
|
|
return this.expectationFactory(actual, this);
|
|
};
|
|
|
|
Spec.prototype.expectAsync = function(actual) {
|
|
return this.asyncExpectationFactory(actual, this);
|
|
};
|
|
|
|
Spec.prototype.execute = function(
|
|
queueRunnerFactory,
|
|
onComplete,
|
|
excluded,
|
|
failSpecWithNoExp
|
|
) {
|
|
const onStart = {
|
|
fn: done => {
|
|
this.timer.start();
|
|
this.onStart(this, done);
|
|
}
|
|
};
|
|
|
|
const complete = {
|
|
fn: done => {
|
|
if (this.autoCleanClosures) {
|
|
this.queueableFn.fn = null;
|
|
}
|
|
this.result.status = this.status(excluded, failSpecWithNoExp);
|
|
this.result.duration = this.timer.elapsed();
|
|
|
|
if (this.result.status !== 'failed') {
|
|
this.result.debugLogs = null;
|
|
}
|
|
|
|
this.resultCallback(this.result, done);
|
|
},
|
|
type: 'specCleanup'
|
|
};
|
|
|
|
const fns = this.beforeAndAfterFns();
|
|
|
|
const runnerConfig = {
|
|
isLeaf: true,
|
|
queueableFns: [...fns.befores, this.queueableFn, ...fns.afters],
|
|
onException: e => this.handleException(e),
|
|
onMultipleDone: () => {
|
|
// Issue a deprecation. Include the context ourselves and pass
|
|
// ignoreRunnable: true, since getting here always means that we've already
|
|
// moved on and the current runnable isn't the one that caused the problem.
|
|
this.onLateError(
|
|
new Error(
|
|
'An asynchronous spec, beforeEach, or afterEach function called its ' +
|
|
"'done' callback more than once.\n(in spec: " +
|
|
this.getFullName() +
|
|
')'
|
|
)
|
|
);
|
|
},
|
|
onComplete: () => {
|
|
if (this.result.status === 'failed') {
|
|
onComplete(new j$.StopExecutionError('spec failed'));
|
|
} else {
|
|
onComplete();
|
|
}
|
|
},
|
|
userContext: this.userContext(),
|
|
runnableName: this.getFullName.bind(this)
|
|
};
|
|
|
|
if (this.markedPending || excluded === true) {
|
|
runnerConfig.queueableFns = [];
|
|
}
|
|
|
|
runnerConfig.queueableFns.unshift(onStart);
|
|
runnerConfig.queueableFns.push(complete);
|
|
|
|
queueRunnerFactory(runnerConfig);
|
|
};
|
|
|
|
Spec.prototype.reset = function() {
|
|
this.result = {
|
|
id: this.id,
|
|
description: this.description,
|
|
fullName: this.getFullName(),
|
|
failedExpectations: [],
|
|
passedExpectations: [],
|
|
deprecationWarnings: [],
|
|
pendingReason: this.excludeMessage,
|
|
duration: null,
|
|
properties: null,
|
|
debugLogs: null
|
|
};
|
|
this.markedPending = this.markedExcluding;
|
|
this.reportedDone = false;
|
|
};
|
|
|
|
Spec.prototype.handleException = function handleException(e) {
|
|
if (Spec.isPendingSpecException(e)) {
|
|
this.pend(extractCustomPendingMessage(e));
|
|
return;
|
|
}
|
|
|
|
if (e instanceof j$.errors.ExpectationFailed) {
|
|
return;
|
|
}
|
|
|
|
this.addExpectationResult(
|
|
false,
|
|
{
|
|
matcherName: '',
|
|
passed: false,
|
|
expected: '',
|
|
actual: '',
|
|
error: e
|
|
},
|
|
true
|
|
);
|
|
};
|
|
|
|
/*
|
|
* Marks state as pending
|
|
* @param {string} [message] An optional reason message
|
|
*/
|
|
Spec.prototype.pend = function(message) {
|
|
this.markedPending = true;
|
|
if (message) {
|
|
this.result.pendingReason = message;
|
|
}
|
|
};
|
|
|
|
/*
|
|
* Like {@link Spec#pend}, but pending state will survive {@link Spec#reset}
|
|
* Useful for fit, xit, where pending state remains.
|
|
* @param {string} [message] An optional reason message
|
|
*/
|
|
Spec.prototype.exclude = function(message) {
|
|
this.markedExcluding = true;
|
|
if (this.message) {
|
|
this.excludeMessage = message;
|
|
}
|
|
this.pend(message);
|
|
};
|
|
|
|
Spec.prototype.getResult = function() {
|
|
this.result.status = this.status();
|
|
return this.result;
|
|
};
|
|
|
|
Spec.prototype.status = function(excluded, failSpecWithNoExpectations) {
|
|
if (excluded === true) {
|
|
return 'excluded';
|
|
}
|
|
|
|
if (this.markedPending) {
|
|
return 'pending';
|
|
}
|
|
|
|
if (
|
|
this.result.failedExpectations.length > 0 ||
|
|
(failSpecWithNoExpectations &&
|
|
this.result.failedExpectations.length +
|
|
this.result.passedExpectations.length ===
|
|
0)
|
|
) {
|
|
return 'failed';
|
|
}
|
|
|
|
return 'passed';
|
|
};
|
|
|
|
Spec.prototype.getFullName = function() {
|
|
return this.getSpecName(this);
|
|
};
|
|
|
|
Spec.prototype.addDeprecationWarning = function(deprecation) {
|
|
if (typeof deprecation === 'string') {
|
|
deprecation = { message: deprecation };
|
|
}
|
|
this.result.deprecationWarnings.push(
|
|
j$.buildExpectationResult(deprecation)
|
|
);
|
|
};
|
|
|
|
Spec.prototype.debugLog = function(msg) {
|
|
if (!this.result.debugLogs) {
|
|
this.result.debugLogs = [];
|
|
}
|
|
|
|
/**
|
|
* @typedef DebugLogEntry
|
|
* @property {String} message - The message that was passed to {@link jasmine.debugLog}.
|
|
* @property {number} timestamp - The time when the entry was added, in
|
|
* milliseconds from the spec's start time
|
|
*/
|
|
this.result.debugLogs.push({
|
|
message: msg,
|
|
timestamp: this.timer.elapsed()
|
|
});
|
|
};
|
|
|
|
const extractCustomPendingMessage = function(e) {
|
|
const fullMessage = e.toString(),
|
|
boilerplateStart = fullMessage.indexOf(Spec.pendingSpecExceptionMessage),
|
|
boilerplateEnd =
|
|
boilerplateStart + Spec.pendingSpecExceptionMessage.length;
|
|
|
|
return fullMessage.slice(boilerplateEnd);
|
|
};
|
|
|
|
Spec.pendingSpecExceptionMessage = '=> marked Pending';
|
|
|
|
Spec.isPendingSpecException = function(e) {
|
|
return !!(
|
|
e &&
|
|
e.toString &&
|
|
e.toString().indexOf(Spec.pendingSpecExceptionMessage) !== -1
|
|
);
|
|
};
|
|
|
|
/**
|
|
* @interface Spec
|
|
* @see Configuration#specFilter
|
|
* @since 2.0.0
|
|
*/
|
|
Object.defineProperty(Spec.prototype, 'metadata', {
|
|
get: function() {
|
|
if (!this.metadata_) {
|
|
this.metadata_ = {
|
|
/**
|
|
* The unique ID of this spec.
|
|
* @name Spec#id
|
|
* @readonly
|
|
* @type {string}
|
|
* @since 2.0.0
|
|
*/
|
|
id: this.id,
|
|
|
|
/**
|
|
* The description passed to the {@link it} that created this spec.
|
|
* @name Spec#description
|
|
* @readonly
|
|
* @type {string}
|
|
* @since 2.0.0
|
|
*/
|
|
description: this.description,
|
|
|
|
/**
|
|
* The full description including all ancestors of this spec.
|
|
* @name Spec#getFullName
|
|
* @function
|
|
* @returns {string}
|
|
* @since 2.0.0
|
|
*/
|
|
getFullName: this.getFullName.bind(this)
|
|
};
|
|
}
|
|
|
|
return this.metadata_;
|
|
}
|
|
});
|
|
|
|
return Spec;
|
|
};
|
|
|
|
getJasmineRequireObj().Order = function() {
|
|
function Order(options) {
|
|
this.random = 'random' in options ? options.random : true;
|
|
const seed = (this.seed = options.seed || generateSeed());
|
|
this.sort = this.random ? randomOrder : naturalOrder;
|
|
|
|
function naturalOrder(items) {
|
|
return items;
|
|
}
|
|
|
|
function randomOrder(items) {
|
|
const copy = items.slice();
|
|
copy.sort(function(a, b) {
|
|
return jenkinsHash(seed + a.id) - jenkinsHash(seed + b.id);
|
|
});
|
|
return copy;
|
|
}
|
|
|
|
function generateSeed() {
|
|
return String(Math.random()).slice(-5);
|
|
}
|
|
|
|
// Bob Jenkins One-at-a-Time Hash algorithm is a non-cryptographic hash function
|
|
// used to get a different output when the key changes slightly.
|
|
// We use your return to sort the children randomly in a consistent way when
|
|
// used in conjunction with a seed
|
|
|
|
function jenkinsHash(key) {
|
|
let hash, i;
|
|
for (hash = i = 0; i < key.length; ++i) {
|
|
hash += key.charCodeAt(i);
|
|
hash += hash << 10;
|
|
hash ^= hash >> 6;
|
|
}
|
|
hash += hash << 3;
|
|
hash ^= hash >> 11;
|
|
hash += hash << 15;
|
|
return hash;
|
|
}
|
|
}
|
|
|
|
return Order;
|
|
};
|
|
|
|
getJasmineRequireObj().Env = function(j$) {
|
|
/**
|
|
* @class Env
|
|
* @since 2.0.0
|
|
* @classdesc The Jasmine environment.<br>
|
|
* _Note:_ Do not construct this directly. You can obtain the Env instance by
|
|
* calling {@link jasmine.getEnv}.
|
|
* @hideconstructor
|
|
*/
|
|
function Env(options) {
|
|
options = options || {};
|
|
|
|
const self = this;
|
|
const global = options.global || j$.getGlobal();
|
|
|
|
const realSetTimeout = global.setTimeout;
|
|
const realClearTimeout = global.clearTimeout;
|
|
const clearStack = j$.getClearStack(global);
|
|
this.clock = new j$.Clock(
|
|
global,
|
|
function() {
|
|
return new j$.DelayedFunctionScheduler();
|
|
},
|
|
new j$.MockDate(global)
|
|
);
|
|
|
|
const globalErrors = new j$.GlobalErrors();
|
|
const installGlobalErrors = (function() {
|
|
let installed = false;
|
|
return function() {
|
|
if (!installed) {
|
|
globalErrors.install();
|
|
installed = true;
|
|
}
|
|
};
|
|
})();
|
|
|
|
const runableResources = new j$.RunableResources({
|
|
getCurrentRunableId: function() {
|
|
const r = runner.currentRunable();
|
|
return r ? r.id : null;
|
|
},
|
|
globalErrors
|
|
});
|
|
|
|
let reporter;
|
|
let topSuite;
|
|
let runner;
|
|
|
|
/**
|
|
* This represents the available options to configure Jasmine.
|
|
* Options that are not provided will use their default values.
|
|
* @see Env#configure
|
|
* @interface Configuration
|
|
* @since 3.3.0
|
|
*/
|
|
const config = {
|
|
/**
|
|
* Whether to randomize spec execution order
|
|
* @name Configuration#random
|
|
* @since 3.3.0
|
|
* @type Boolean
|
|
* @default true
|
|
*/
|
|
random: true,
|
|
/**
|
|
* Seed to use as the basis of randomization.
|
|
* Null causes the seed to be determined randomly at the start of execution.
|
|
* @name Configuration#seed
|
|
* @since 3.3.0
|
|
* @type (number|string)
|
|
* @default null
|
|
*/
|
|
seed: null,
|
|
/**
|
|
* Whether to stop execution of the suite after the first spec failure
|
|
* @name Configuration#stopOnSpecFailure
|
|
* @since 3.9.0
|
|
* @type Boolean
|
|
* @default false
|
|
*/
|
|
stopOnSpecFailure: false,
|
|
/**
|
|
* Whether to fail the spec if it ran no expectations. By default
|
|
* a spec that ran no expectations is reported as passed. Setting this
|
|
* to true will report such spec as a failure.
|
|
* @name Configuration#failSpecWithNoExpectations
|
|
* @since 3.5.0
|
|
* @type Boolean
|
|
* @default false
|
|
*/
|
|
failSpecWithNoExpectations: false,
|
|
/**
|
|
* Whether to cause specs to only have one expectation failure.
|
|
* @name Configuration#stopSpecOnExpectationFailure
|
|
* @since 3.3.0
|
|
* @type Boolean
|
|
* @default false
|
|
*/
|
|
stopSpecOnExpectationFailure: false,
|
|
/**
|
|
* A function that takes a spec and returns true if it should be executed
|
|
* or false if it should be skipped.
|
|
* @callback SpecFilter
|
|
* @param {Spec} spec - The spec that the filter is being applied to.
|
|
* @return boolean
|
|
*/
|
|
/**
|
|
* Function to use to filter specs
|
|
* @name Configuration#specFilter
|
|
* @since 3.3.0
|
|
* @type SpecFilter
|
|
* @default A function that always returns true.
|
|
*/
|
|
specFilter: function() {
|
|
return true;
|
|
},
|
|
/**
|
|
* Whether or not reporters should hide disabled specs from their output.
|
|
* Currently only supported by Jasmine's HTMLReporter
|
|
* @name Configuration#hideDisabled
|
|
* @since 3.3.0
|
|
* @type Boolean
|
|
* @default false
|
|
*/
|
|
hideDisabled: false,
|
|
/**
|
|
* Clean closures when a suite is done running (done by clearing the stored function reference).
|
|
* This prevents memory leaks, but you won't be able to run jasmine multiple times.
|
|
* @name Configuration#autoCleanClosures
|
|
* @since 3.10.0
|
|
* @type boolean
|
|
* @default true
|
|
*/
|
|
autoCleanClosures: true,
|
|
/**
|
|
* Whether or not to issue warnings for certain deprecated functionality
|
|
* every time it's used. If not set or set to false, deprecation warnings
|
|
* for methods that tend to be called frequently will be issued only once
|
|
* or otherwise throttled to to prevent the suite output from being flooded
|
|
* with warnings.
|
|
* @name Configuration#verboseDeprecations
|
|
* @since 3.6.0
|
|
* @type Boolean
|
|
* @default false
|
|
*/
|
|
verboseDeprecations: false
|
|
};
|
|
|
|
if (!options.suppressLoadErrors) {
|
|
installGlobalErrors();
|
|
globalErrors.pushListener(function loadtimeErrorHandler(
|
|
message,
|
|
filename,
|
|
lineno,
|
|
colNo,
|
|
err
|
|
) {
|
|
topSuite.result.failedExpectations.push({
|
|
passed: false,
|
|
globalErrorType: 'load',
|
|
message: message,
|
|
stack: err && err.stack,
|
|
filename: filename,
|
|
lineno: lineno
|
|
});
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Configure your jasmine environment
|
|
* @name Env#configure
|
|
* @since 3.3.0
|
|
* @argument {Configuration} configuration
|
|
* @function
|
|
*/
|
|
this.configure = function(configuration) {
|
|
const booleanProps = [
|
|
'random',
|
|
'failSpecWithNoExpectations',
|
|
'hideDisabled',
|
|
'stopOnSpecFailure',
|
|
'stopSpecOnExpectationFailure',
|
|
'autoCleanClosures'
|
|
];
|
|
|
|
booleanProps.forEach(function(prop) {
|
|
if (typeof configuration[prop] !== 'undefined') {
|
|
config[prop] = !!configuration[prop];
|
|
}
|
|
});
|
|
|
|
if (configuration.specFilter) {
|
|
config.specFilter = configuration.specFilter;
|
|
}
|
|
|
|
if (typeof configuration.seed !== 'undefined') {
|
|
config.seed = configuration.seed;
|
|
}
|
|
|
|
if (configuration.hasOwnProperty('verboseDeprecations')) {
|
|
config.verboseDeprecations = configuration.verboseDeprecations;
|
|
deprecator.verboseDeprecations(config.verboseDeprecations);
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Get the current configuration for your jasmine environment
|
|
* @name Env#configuration
|
|
* @since 3.3.0
|
|
* @function
|
|
* @returns {Configuration}
|
|
*/
|
|
this.configuration = function() {
|
|
const result = {};
|
|
for (const property in config) {
|
|
result[property] = config[property];
|
|
}
|
|
return result;
|
|
};
|
|
|
|
this.setDefaultSpyStrategy = function(defaultStrategyFn) {
|
|
runableResources.setDefaultSpyStrategy(defaultStrategyFn);
|
|
};
|
|
|
|
this.addSpyStrategy = function(name, fn) {
|
|
runableResources.customSpyStrategies()[name] = fn;
|
|
};
|
|
|
|
this.addCustomEqualityTester = function(tester) {
|
|
runableResources.customEqualityTesters().push(tester);
|
|
};
|
|
|
|
this.addMatchers = function(matchersToAdd) {
|
|
runableResources.addCustomMatchers(matchersToAdd);
|
|
};
|
|
|
|
this.addAsyncMatchers = function(matchersToAdd) {
|
|
runableResources.addCustomAsyncMatchers(matchersToAdd);
|
|
};
|
|
|
|
this.addCustomObjectFormatter = function(formatter) {
|
|
runableResources.customObjectFormatters().push(formatter);
|
|
};
|
|
|
|
j$.Expectation.addCoreMatchers(j$.matchers);
|
|
j$.Expectation.addAsyncCoreMatchers(j$.asyncMatchers);
|
|
|
|
const expectationFactory = function(actual, spec) {
|
|
return j$.Expectation.factory({
|
|
matchersUtil: runableResources.makeMatchersUtil(),
|
|
customMatchers: runableResources.customMatchers(),
|
|
actual: actual,
|
|
addExpectationResult: addExpectationResult
|
|
});
|
|
|
|
function addExpectationResult(passed, result) {
|
|
return spec.addExpectationResult(passed, result);
|
|
}
|
|
};
|
|
|
|
// TODO: Unify recordLateError with recordLateExpectation? The extra
|
|
// diagnostic info added by the latter is probably useful in most cases.
|
|
function recordLateError(error) {
|
|
const isExpectationResult =
|
|
error.matcherName !== undefined && error.passed !== undefined;
|
|
const result = isExpectationResult
|
|
? error
|
|
: j$.buildExpectationResult({
|
|
error,
|
|
passed: false,
|
|
matcherName: '',
|
|
expected: '',
|
|
actual: ''
|
|
});
|
|
routeLateFailure(result);
|
|
}
|
|
|
|
function recordLateExpectation(runable, runableType, result) {
|
|
const delayedExpectationResult = {};
|
|
Object.keys(result).forEach(function(k) {
|
|
delayedExpectationResult[k] = result[k];
|
|
});
|
|
delayedExpectationResult.passed = false;
|
|
delayedExpectationResult.globalErrorType = 'lateExpectation';
|
|
delayedExpectationResult.message =
|
|
runableType +
|
|
' "' +
|
|
runable.getFullName() +
|
|
'" ran a "' +
|
|
result.matcherName +
|
|
'" expectation after it finished.\n';
|
|
|
|
if (result.message) {
|
|
delayedExpectationResult.message +=
|
|
'Message: "' + result.message + '"\n';
|
|
}
|
|
|
|
delayedExpectationResult.message +=
|
|
'1. Did you forget to return or await the result of expectAsync?\n' +
|
|
'2. Was done() invoked before an async operation completed?\n' +
|
|
'3. Did an expectation follow a call to done()?';
|
|
|
|
topSuite.result.failedExpectations.push(delayedExpectationResult);
|
|
}
|
|
|
|
function routeLateFailure(expectationResult) {
|
|
// Report the result on the nearest ancestor suite that hasn't already
|
|
// been reported done.
|
|
for (let r = runner.currentRunable(); r; r = r.parentSuite) {
|
|
if (!r.reportedDone) {
|
|
if (r === topSuite) {
|
|
expectationResult.globalErrorType = 'lateError';
|
|
}
|
|
|
|
r.result.failedExpectations.push(expectationResult);
|
|
return;
|
|
}
|
|
}
|
|
|
|
// If we get here, all results have been reported and there's nothing we
|
|
// can do except log the result and hope the user sees it.
|
|
console.error('Jasmine received a result after the suite finished:');
|
|
console.error(expectationResult);
|
|
}
|
|
|
|
const asyncExpectationFactory = function(actual, spec, runableType) {
|
|
return j$.Expectation.asyncFactory({
|
|
matchersUtil: runableResources.makeMatchersUtil(),
|
|
customAsyncMatchers: runableResources.customAsyncMatchers(),
|
|
actual: actual,
|
|
addExpectationResult: addExpectationResult
|
|
});
|
|
|
|
function addExpectationResult(passed, result) {
|
|
if (runner.currentRunable() !== spec) {
|
|
recordLateExpectation(spec, runableType, result);
|
|
}
|
|
return spec.addExpectationResult(passed, result);
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Causes a deprecation warning to be logged to the console and reported to
|
|
* reporters.
|
|
*
|
|
* The optional second parameter is an object that can have either of the
|
|
* following properties:
|
|
*
|
|
* omitStackTrace: Whether to omit the stack trace. Optional. Defaults to
|
|
* false. This option is ignored if the deprecation is an Error. Set this
|
|
* when the stack trace will not contain anything that helps the user find
|
|
* the source of the deprecation.
|
|
*
|
|
* ignoreRunnable: Whether to log the deprecation on the root suite, ignoring
|
|
* the spec or suite that's running when it happens. Optional. Defaults to
|
|
* false.
|
|
*
|
|
* @name Env#deprecated
|
|
* @since 2.99
|
|
* @function
|
|
* @param {String|Error} deprecation The deprecation message
|
|
* @param {Object} [options] Optional extra options, as described above
|
|
*/
|
|
this.deprecated = function(deprecation, options) {
|
|
const runable = runner.currentRunable() || topSuite;
|
|
deprecator.addDeprecationWarning(runable, deprecation, options);
|
|
};
|
|
|
|
function queueRunnerFactory(options) {
|
|
options.clearStack = options.clearStack || clearStack;
|
|
options.timeout = {
|
|
setTimeout: realSetTimeout,
|
|
clearTimeout: realClearTimeout
|
|
};
|
|
options.fail = self.fail;
|
|
options.globalErrors = globalErrors;
|
|
options.onException =
|
|
options.onException ||
|
|
function(e) {
|
|
(runner.currentRunable() || topSuite).handleException(e);
|
|
};
|
|
options.deprecated = self.deprecated;
|
|
|
|
new j$.QueueRunner(options).execute();
|
|
}
|
|
|
|
const suiteBuilder = new j$.SuiteBuilder({
|
|
env: this,
|
|
expectationFactory,
|
|
asyncExpectationFactory,
|
|
onLateError: recordLateError,
|
|
specResultCallback,
|
|
specStarted,
|
|
queueRunnerFactory
|
|
});
|
|
topSuite = suiteBuilder.topSuite;
|
|
const deprecator = new j$.Deprecator(topSuite);
|
|
|
|
/**
|
|
* Provides the root suite, through which all suites and specs can be
|
|
* accessed.
|
|
* @function
|
|
* @name Env#topSuite
|
|
* @return {Suite} the root suite
|
|
* @since 2.0.0
|
|
*/
|
|
this.topSuite = function() {
|
|
return topSuite.metadata;
|
|
};
|
|
|
|
/**
|
|
* This represents the available reporter callback for an object passed to {@link Env#addReporter}.
|
|
* @interface Reporter
|
|
* @see custom_reporter
|
|
*/
|
|
reporter = new j$.ReportDispatcher(
|
|
[
|
|
/**
|
|
* `jasmineStarted` is called after all of the specs have been loaded, but just before execution starts.
|
|
* @function
|
|
* @name Reporter#jasmineStarted
|
|
* @param {JasmineStartedInfo} suiteInfo Information about the full Jasmine suite that is being run
|
|
* @param {Function} [done] Used to specify to Jasmine that this callback is asynchronous and Jasmine should wait until it has been called before moving on.
|
|
* @returns {} Optionally return a Promise instead of using `done` to cause Jasmine to wait for completion.
|
|
* @see async
|
|
*/
|
|
'jasmineStarted',
|
|
/**
|
|
* When the entire suite has finished execution `jasmineDone` is called
|
|
* @function
|
|
* @name Reporter#jasmineDone
|
|
* @param {JasmineDoneInfo} suiteInfo Information about the full Jasmine suite that just finished running.
|
|
* @param {Function} [done] Used to specify to Jasmine that this callback is asynchronous and Jasmine should wait until it has been called before moving on.
|
|
* @returns {} Optionally return a Promise instead of using `done` to cause Jasmine to wait for completion.
|
|
* @see async
|
|
*/
|
|
'jasmineDone',
|
|
/**
|
|
* `suiteStarted` is invoked when a `describe` starts to run
|
|
* @function
|
|
* @name Reporter#suiteStarted
|
|
* @param {SuiteResult} result Information about the individual {@link describe} being run
|
|
* @param {Function} [done] Used to specify to Jasmine that this callback is asynchronous and Jasmine should wait until it has been called before moving on.
|
|
* @returns {} Optionally return a Promise instead of using `done` to cause Jasmine to wait for completion.
|
|
* @see async
|
|
*/
|
|
'suiteStarted',
|
|
/**
|
|
* `suiteDone` is invoked when all of the child specs and suites for a given suite have been run
|
|
*
|
|
* While jasmine doesn't require any specific functions, not defining a `suiteDone` will make it impossible for a reporter to know when a suite has failures in an `afterAll`.
|
|
* @function
|
|
* @name Reporter#suiteDone
|
|
* @param {SuiteResult} result
|
|
* @param {Function} [done] Used to specify to Jasmine that this callback is asynchronous and Jasmine should wait until it has been called before moving on.
|
|
* @returns {} Optionally return a Promise instead of using `done` to cause Jasmine to wait for completion.
|
|
* @see async
|
|
*/
|
|
'suiteDone',
|
|
/**
|
|
* `specStarted` is invoked when an `it` starts to run (including associated `beforeEach` functions)
|
|
* @function
|
|
* @name Reporter#specStarted
|
|
* @param {SpecResult} result Information about the individual {@link it} being run
|
|
* @param {Function} [done] Used to specify to Jasmine that this callback is asynchronous and Jasmine should wait until it has been called before moving on.
|
|
* @returns {} Optionally return a Promise instead of using `done` to cause Jasmine to wait for completion.
|
|
* @see async
|
|
*/
|
|
'specStarted',
|
|
/**
|
|
* `specDone` is invoked when an `it` and its associated `beforeEach` and `afterEach` functions have been run.
|
|
*
|
|
* While jasmine doesn't require any specific functions, not defining a `specDone` will make it impossible for a reporter to know when a spec has failed.
|
|
* @function
|
|
* @name Reporter#specDone
|
|
* @param {SpecResult} result
|
|
* @param {Function} [done] Used to specify to Jasmine that this callback is asynchronous and Jasmine should wait until it has been called before moving on.
|
|
* @returns {} Optionally return a Promise instead of using `done` to cause Jasmine to wait for completion.
|
|
* @see async
|
|
*/
|
|
'specDone'
|
|
],
|
|
function(options) {
|
|
options.SkipPolicy = j$.NeverSkipPolicy;
|
|
return queueRunnerFactory(options);
|
|
},
|
|
recordLateError
|
|
);
|
|
|
|
runner = new j$.Runner({
|
|
topSuite,
|
|
totalSpecsDefined: () => suiteBuilder.totalSpecsDefined,
|
|
focusedRunables: () => suiteBuilder.focusedRunables,
|
|
runableResources,
|
|
reporter,
|
|
queueRunnerFactory,
|
|
getConfig: () => config,
|
|
reportSpecDone
|
|
});
|
|
|
|
/**
|
|
* Executes the specs.
|
|
*
|
|
* If called with no parameters or with a falsy value as the first parameter,
|
|
* all specs will be executed except those that are excluded by a
|
|
* [spec filter]{@link Configuration#specFilter} or other mechanism. If the
|
|
* first parameter is a list of spec/suite IDs, only those specs/suites will
|
|
* be run.
|
|
*
|
|
* Both parameters are optional, but a completion callback is only valid as
|
|
* the second parameter. To specify a completion callback but not a list of
|
|
* specs/suites to run, pass null or undefined as the first parameter. The
|
|
* completion callback is supported for backward compatibility. In most
|
|
* cases it will be more convenient to use the returned promise instead.
|
|
*
|
|
* execute should not be called more than once unless the env has been
|
|
* configured with `{autoCleanClosures: false}`.
|
|
*
|
|
* execute returns a promise. The promise will be resolved to the same
|
|
* {@link JasmineDoneInfo|overall result} that's passed to a reporter's
|
|
* `jasmineDone` method, even if the suite did not pass. To determine
|
|
* whether the suite passed, check the value that the promise resolves to
|
|
* or use a {@link Reporter}.
|
|
*
|
|
* @name Env#execute
|
|
* @since 2.0.0
|
|
* @function
|
|
* @param {(string[])=} runablesToRun IDs of suites and/or specs to run
|
|
* @param {Function=} onComplete Function that will be called after all specs have run
|
|
* @return {Promise<JasmineDoneInfo>}
|
|
*/
|
|
this.execute = function(runablesToRun, onComplete) {
|
|
installGlobalErrors();
|
|
|
|
return runner.execute(runablesToRun).then(function(jasmineDoneInfo) {
|
|
if (onComplete) {
|
|
onComplete();
|
|
}
|
|
|
|
return jasmineDoneInfo;
|
|
});
|
|
};
|
|
|
|
/**
|
|
* Add a custom reporter to the Jasmine environment.
|
|
* @name Env#addReporter
|
|
* @since 2.0.0
|
|
* @function
|
|
* @param {Reporter} reporterToAdd The reporter to be added.
|
|
* @see custom_reporter
|
|
*/
|
|
this.addReporter = function(reporterToAdd) {
|
|
reporter.addReporter(reporterToAdd);
|
|
};
|
|
|
|
/**
|
|
* Provide a fallback reporter if no other reporters have been specified.
|
|
* @name Env#provideFallbackReporter
|
|
* @since 2.5.0
|
|
* @function
|
|
* @param {Reporter} reporterToAdd The reporter
|
|
* @see custom_reporter
|
|
*/
|
|
this.provideFallbackReporter = function(reporterToAdd) {
|
|
reporter.provideFallbackReporter(reporterToAdd);
|
|
};
|
|
|
|
/**
|
|
* Clear all registered reporters
|
|
* @name Env#clearReporters
|
|
* @since 2.5.2
|
|
* @function
|
|
*/
|
|
this.clearReporters = function() {
|
|
reporter.clearReporters();
|
|
};
|
|
|
|
/**
|
|
* Configures whether Jasmine should allow the same function to be spied on
|
|
* more than once during the execution of a spec. By default, spying on
|
|
* a function that is already a spy will cause an error.
|
|
* @name Env#allowRespy
|
|
* @function
|
|
* @since 2.5.0
|
|
* @param {boolean} allow Whether to allow respying
|
|
*/
|
|
this.allowRespy = function(allow) {
|
|
runableResources.spyRegistry.allowRespy(allow);
|
|
};
|
|
|
|
this.spyOn = function() {
|
|
return runableResources.spyRegistry.spyOn.apply(
|
|
runableResources.spyRegistry,
|
|
arguments
|
|
);
|
|
};
|
|
|
|
this.spyOnProperty = function() {
|
|
return runableResources.spyRegistry.spyOnProperty.apply(
|
|
runableResources.spyRegistry,
|
|
arguments
|
|
);
|
|
};
|
|
|
|
this.spyOnAllFunctions = function() {
|
|
return runableResources.spyRegistry.spyOnAllFunctions.apply(
|
|
runableResources.spyRegistry,
|
|
arguments
|
|
);
|
|
};
|
|
|
|
this.createSpy = function(name, originalFn) {
|
|
return runableResources.spyFactory.createSpy(name, originalFn);
|
|
};
|
|
|
|
this.createSpyObj = function(baseName, methodNames, propertyNames) {
|
|
return runableResources.spyFactory.createSpyObj(
|
|
baseName,
|
|
methodNames,
|
|
propertyNames
|
|
);
|
|
};
|
|
|
|
this.spyOnGlobalErrorsAsync = async function(fn) {
|
|
const spy = this.createSpy('global error handler');
|
|
const associatedRunable = runner.currentRunable();
|
|
let cleanedUp = false;
|
|
|
|
globalErrors.setOverrideListener(spy, () => {
|
|
if (!cleanedUp) {
|
|
const message =
|
|
'Global error spy was not uninstalled. (Did you ' +
|
|
'forget to await the return value of spyOnGlobalErrorsAsync?)';
|
|
associatedRunable.addExpectationResult(false, {
|
|
matcherName: '',
|
|
passed: false,
|
|
expected: '',
|
|
actual: '',
|
|
message,
|
|
error: null
|
|
});
|
|
}
|
|
|
|
cleanedUp = true;
|
|
});
|
|
|
|
try {
|
|
const maybePromise = fn(spy);
|
|
|
|
if (!j$.isPromiseLike(maybePromise)) {
|
|
throw new Error(
|
|
'The callback to spyOnGlobalErrorsAsync must be an async or promise-returning function'
|
|
);
|
|
}
|
|
|
|
await maybePromise;
|
|
} finally {
|
|
if (!cleanedUp) {
|
|
cleanedUp = true;
|
|
globalErrors.removeOverrideListener();
|
|
}
|
|
}
|
|
};
|
|
|
|
function ensureIsNotNested(method) {
|
|
const runable = runner.currentRunable();
|
|
if (runable !== null && runable !== undefined) {
|
|
throw new Error(
|
|
"'" + method + "' should only be used in 'describe' function"
|
|
);
|
|
}
|
|
}
|
|
|
|
this.describe = function(description, definitionFn) {
|
|
ensureIsNotNested('describe');
|
|
return suiteBuilder.describe(description, definitionFn).metadata;
|
|
};
|
|
|
|
this.xdescribe = function(description, definitionFn) {
|
|
ensureIsNotNested('xdescribe');
|
|
return suiteBuilder.xdescribe(description, definitionFn).metadata;
|
|
};
|
|
|
|
this.fdescribe = function(description, definitionFn) {
|
|
ensureIsNotNested('fdescribe');
|
|
return suiteBuilder.fdescribe(description, definitionFn).metadata;
|
|
};
|
|
|
|
function specResultCallback(spec, result, next) {
|
|
runableResources.clearForRunable(spec.id);
|
|
runner.currentSpec = null;
|
|
|
|
if (result.status === 'failed') {
|
|
runner.hasFailures = true;
|
|
}
|
|
|
|
reportSpecDone(spec, result, next);
|
|
}
|
|
|
|
function specStarted(spec, suite, next) {
|
|
runner.currentSpec = spec;
|
|
runableResources.initForRunable(spec.id, suite.id);
|
|
reporter.specStarted(spec.result).then(next);
|
|
}
|
|
|
|
function reportSpecDone(spec, result, next) {
|
|
spec.reportedDone = true;
|
|
reporter.specDone(result).then(next);
|
|
}
|
|
|
|
this.it = function(description, fn, timeout) {
|
|
ensureIsNotNested('it');
|
|
return suiteBuilder.it(description, fn, timeout).metadata;
|
|
};
|
|
|
|
this.xit = function(description, fn, timeout) {
|
|
ensureIsNotNested('xit');
|
|
return suiteBuilder.xit(description, fn, timeout).metadata;
|
|
};
|
|
|
|
this.fit = function(description, fn, timeout) {
|
|
ensureIsNotNested('fit');
|
|
return suiteBuilder.fit(description, fn, timeout).metadata;
|
|
};
|
|
|
|
/**
|
|
* Sets a user-defined property that will be provided to reporters as part of the properties field of {@link SpecResult}
|
|
* @name Env#setSpecProperty
|
|
* @since 3.6.0
|
|
* @function
|
|
* @param {String} key The name of the property
|
|
* @param {*} value The value of the property
|
|
*/
|
|
this.setSpecProperty = function(key, value) {
|
|
if (
|
|
!runner.currentRunable() ||
|
|
runner.currentRunable() == runner.currentSuite()
|
|
) {
|
|
throw new Error(
|
|
"'setSpecProperty' was used when there was no current spec"
|
|
);
|
|
}
|
|
runner.currentRunable().setSpecProperty(key, value);
|
|
};
|
|
|
|
/**
|
|
* Sets a user-defined property that will be provided to reporters as part of the properties field of {@link SuiteResult}
|
|
* @name Env#setSuiteProperty
|
|
* @since 3.6.0
|
|
* @function
|
|
* @param {String} key The name of the property
|
|
* @param {*} value The value of the property
|
|
*/
|
|
this.setSuiteProperty = function(key, value) {
|
|
if (!runner.currentSuite()) {
|
|
throw new Error(
|
|
"'setSuiteProperty' was used when there was no current suite"
|
|
);
|
|
}
|
|
runner.currentSuite().setSuiteProperty(key, value);
|
|
};
|
|
|
|
this.debugLog = function(msg) {
|
|
const maybeSpec = runner.currentRunable();
|
|
|
|
if (!maybeSpec || !maybeSpec.debugLog) {
|
|
throw new Error("'debugLog' was called when there was no current spec");
|
|
}
|
|
|
|
maybeSpec.debugLog(msg);
|
|
};
|
|
|
|
this.expect = function(actual) {
|
|
if (!runner.currentRunable()) {
|
|
throw new Error(
|
|
"'expect' was used when there was no current spec, this could be because an asynchronous test timed out"
|
|
);
|
|
}
|
|
|
|
return runner.currentRunable().expect(actual);
|
|
};
|
|
|
|
this.expectAsync = function(actual) {
|
|
if (!runner.currentRunable()) {
|
|
throw new Error(
|
|
"'expectAsync' was used when there was no current spec, this could be because an asynchronous test timed out"
|
|
);
|
|
}
|
|
|
|
return runner.currentRunable().expectAsync(actual);
|
|
};
|
|
|
|
this.beforeEach = function(beforeEachFunction, timeout) {
|
|
ensureIsNotNested('beforeEach');
|
|
suiteBuilder.beforeEach(beforeEachFunction, timeout);
|
|
};
|
|
|
|
this.beforeAll = function(beforeAllFunction, timeout) {
|
|
ensureIsNotNested('beforeAll');
|
|
suiteBuilder.beforeAll(beforeAllFunction, timeout);
|
|
};
|
|
|
|
this.afterEach = function(afterEachFunction, timeout) {
|
|
ensureIsNotNested('afterEach');
|
|
suiteBuilder.afterEach(afterEachFunction, timeout);
|
|
};
|
|
|
|
this.afterAll = function(afterAllFunction, timeout) {
|
|
ensureIsNotNested('afterAll');
|
|
suiteBuilder.afterAll(afterAllFunction, timeout);
|
|
};
|
|
|
|
this.pending = function(message) {
|
|
let fullMessage = j$.Spec.pendingSpecExceptionMessage;
|
|
if (message) {
|
|
fullMessage += message;
|
|
}
|
|
throw fullMessage;
|
|
};
|
|
|
|
this.fail = function(error) {
|
|
if (!runner.currentRunable()) {
|
|
throw new Error(
|
|
"'fail' was used when there was no current spec, this could be because an asynchronous test timed out"
|
|
);
|
|
}
|
|
|
|
let message = 'Failed';
|
|
if (error) {
|
|
message += ': ';
|
|
if (error.message) {
|
|
message += error.message;
|
|
} else if (j$.isString_(error)) {
|
|
message += error;
|
|
} else {
|
|
// pretty print all kind of objects. This includes arrays.
|
|
const pp = runableResources.makePrettyPrinter();
|
|
message += pp(error);
|
|
}
|
|
}
|
|
|
|
runner.currentRunable().addExpectationResult(false, {
|
|
matcherName: '',
|
|
passed: false,
|
|
expected: '',
|
|
actual: '',
|
|
message: message,
|
|
error: error && error.message ? error : null
|
|
});
|
|
|
|
if (config.stopSpecOnExpectationFailure) {
|
|
throw new Error(message);
|
|
}
|
|
};
|
|
|
|
this.cleanup_ = function() {
|
|
if (globalErrors) {
|
|
globalErrors.uninstall();
|
|
}
|
|
};
|
|
}
|
|
|
|
return Env;
|
|
};
|
|
|
|
getJasmineRequireObj().JsApiReporter = function(j$) {
|
|
/**
|
|
* @name jsApiReporter
|
|
* @classdesc {@link Reporter} added by default in `boot.js` to record results for retrieval in javascript code. An instance is made available as `jsApiReporter` on the global object.
|
|
* @class
|
|
* @hideconstructor
|
|
*/
|
|
function JsApiReporter(options) {
|
|
const timer = options.timer || new j$.Timer();
|
|
let status = 'loaded';
|
|
|
|
this.started = false;
|
|
this.finished = false;
|
|
this.runDetails = {};
|
|
|
|
this.jasmineStarted = function() {
|
|
this.started = true;
|
|
status = 'started';
|
|
timer.start();
|
|
};
|
|
|
|
let executionTime;
|
|
|
|
this.jasmineDone = function(runDetails) {
|
|
this.finished = true;
|
|
this.runDetails = runDetails;
|
|
executionTime = timer.elapsed();
|
|
status = 'done';
|
|
};
|
|
|
|
/**
|
|
* Get the current status for the Jasmine environment.
|
|
* @name jsApiReporter#status
|
|
* @since 2.0.0
|
|
* @function
|
|
* @return {String} - One of `loaded`, `started`, or `done`
|
|
*/
|
|
this.status = function() {
|
|
return status;
|
|
};
|
|
|
|
const suites = [],
|
|
suites_hash = {};
|
|
|
|
this.suiteStarted = function(result) {
|
|
suites_hash[result.id] = result;
|
|
};
|
|
|
|
this.suiteDone = function(result) {
|
|
storeSuite(result);
|
|
};
|
|
|
|
/**
|
|
* Get the results for a set of suites.
|
|
*
|
|
* Retrievable in slices for easier serialization.
|
|
* @name jsApiReporter#suiteResults
|
|
* @since 2.1.0
|
|
* @function
|
|
* @param {Number} index - The position in the suites list to start from.
|
|
* @param {Number} length - Maximum number of suite results to return.
|
|
* @return {SuiteResult[]}
|
|
*/
|
|
this.suiteResults = function(index, length) {
|
|
return suites.slice(index, index + length);
|
|
};
|
|
|
|
function storeSuite(result) {
|
|
suites.push(result);
|
|
suites_hash[result.id] = result;
|
|
}
|
|
|
|
/**
|
|
* Get all of the suites in a single object, with their `id` as the key.
|
|
* @name jsApiReporter#suites
|
|
* @since 2.0.0
|
|
* @function
|
|
* @return {Object} - Map of suite id to {@link SuiteResult}
|
|
*/
|
|
this.suites = function() {
|
|
return suites_hash;
|
|
};
|
|
|
|
const specs = [];
|
|
|
|
this.specDone = function(result) {
|
|
specs.push(result);
|
|
};
|
|
|
|
/**
|
|
* Get the results for a set of specs.
|
|
*
|
|
* Retrievable in slices for easier serialization.
|
|
* @name jsApiReporter#specResults
|
|
* @since 2.0.0
|
|
* @function
|
|
* @param {Number} index - The position in the specs list to start from.
|
|
* @param {Number} length - Maximum number of specs results to return.
|
|
* @return {SpecResult[]}
|
|
*/
|
|
this.specResults = function(index, length) {
|
|
return specs.slice(index, index + length);
|
|
};
|
|
|
|
/**
|
|
* Get all spec results.
|
|
* @name jsApiReporter#specs
|
|
* @since 2.0.0
|
|
* @function
|
|
* @return {SpecResult[]}
|
|
*/
|
|
this.specs = function() {
|
|
return specs;
|
|
};
|
|
|
|
/**
|
|
* Get the number of milliseconds it took for the full Jasmine suite to run.
|
|
* @name jsApiReporter#executionTime
|
|
* @since 2.0.0
|
|
* @function
|
|
* @return {Number}
|
|
*/
|
|
this.executionTime = function() {
|
|
return executionTime;
|
|
};
|
|
}
|
|
|
|
return JsApiReporter;
|
|
};
|
|
|
|
getJasmineRequireObj().Any = function(j$) {
|
|
function Any(expectedObject) {
|
|
if (typeof expectedObject === 'undefined') {
|
|
throw new TypeError(
|
|
'jasmine.any() expects to be passed a constructor function. ' +
|
|
'Please pass one or use jasmine.anything() to match any object.'
|
|
);
|
|
}
|
|
this.expectedObject = expectedObject;
|
|
}
|
|
|
|
Any.prototype.asymmetricMatch = function(other) {
|
|
if (this.expectedObject == String) {
|
|
return typeof other == 'string' || other instanceof String;
|
|
}
|
|
|
|
if (this.expectedObject == Number) {
|
|
return typeof other == 'number' || other instanceof Number;
|
|
}
|
|
|
|
if (this.expectedObject == Function) {
|
|
return typeof other == 'function' || other instanceof Function;
|
|
}
|
|
|
|
if (this.expectedObject == Object) {
|
|
return other !== null && typeof other == 'object';
|
|
}
|
|
|
|
if (this.expectedObject == Boolean) {
|
|
return typeof other == 'boolean';
|
|
}
|
|
|
|
if (typeof Symbol != 'undefined' && this.expectedObject == Symbol) {
|
|
return typeof other == 'symbol';
|
|
}
|
|
|
|
return other instanceof this.expectedObject;
|
|
};
|
|
|
|
Any.prototype.jasmineToString = function() {
|
|
return '<jasmine.any(' + j$.fnNameFor(this.expectedObject) + ')>';
|
|
};
|
|
|
|
return Any;
|
|
};
|
|
|
|
getJasmineRequireObj().Anything = function(j$) {
|
|
function Anything() {}
|
|
|
|
Anything.prototype.asymmetricMatch = function(other) {
|
|
return !j$.util.isUndefined(other) && other !== null;
|
|
};
|
|
|
|
Anything.prototype.jasmineToString = function() {
|
|
return '<jasmine.anything>';
|
|
};
|
|
|
|
return Anything;
|
|
};
|
|
|
|
getJasmineRequireObj().ArrayContaining = function(j$) {
|
|
function ArrayContaining(sample) {
|
|
this.sample = sample;
|
|
}
|
|
|
|
ArrayContaining.prototype.asymmetricMatch = function(other, matchersUtil) {
|
|
if (!j$.isArray_(this.sample)) {
|
|
throw new Error(
|
|
'You must provide an array to arrayContaining, not ' +
|
|
j$.basicPrettyPrinter_(this.sample) +
|
|
'.'
|
|
);
|
|
}
|
|
|
|
// If the actual parameter is not an array, we can fail immediately, since it couldn't
|
|
// possibly be an "array containing" anything. However, we also want an empty sample
|
|
// array to match anything, so we need to double-check we aren't in that case
|
|
if (!j$.isArray_(other) && this.sample.length > 0) {
|
|
return false;
|
|
}
|
|
|
|
for (const item of this.sample) {
|
|
if (!matchersUtil.contains(other, item)) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
return true;
|
|
};
|
|
|
|
ArrayContaining.prototype.jasmineToString = function(pp) {
|
|
return '<jasmine.arrayContaining(' + pp(this.sample) + ')>';
|
|
};
|
|
|
|
return ArrayContaining;
|
|
};
|
|
|
|
getJasmineRequireObj().ArrayWithExactContents = function(j$) {
|
|
function ArrayWithExactContents(sample) {
|
|
this.sample = sample;
|
|
}
|
|
|
|
ArrayWithExactContents.prototype.asymmetricMatch = function(
|
|
other,
|
|
matchersUtil
|
|
) {
|
|
if (!j$.isArray_(this.sample)) {
|
|
throw new Error(
|
|
'You must provide an array to arrayWithExactContents, not ' +
|
|
j$.basicPrettyPrinter_(this.sample) +
|
|
'.'
|
|
);
|
|
}
|
|
|
|
if (this.sample.length !== other.length) {
|
|
return false;
|
|
}
|
|
|
|
for (const item of this.sample) {
|
|
if (!matchersUtil.contains(other, item)) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
return true;
|
|
};
|
|
|
|
ArrayWithExactContents.prototype.jasmineToString = function(pp) {
|
|
return '<jasmine.arrayWithExactContents(' + pp(this.sample) + ')>';
|
|
};
|
|
|
|
return ArrayWithExactContents;
|
|
};
|
|
|
|
getJasmineRequireObj().Empty = function(j$) {
|
|
function Empty() {}
|
|
|
|
Empty.prototype.asymmetricMatch = function(other) {
|
|
if (j$.isString_(other) || j$.isArray_(other) || j$.isTypedArray_(other)) {
|
|
return other.length === 0;
|
|
}
|
|
|
|
if (j$.isMap(other) || j$.isSet(other)) {
|
|
return other.size === 0;
|
|
}
|
|
|
|
if (j$.isObject_(other)) {
|
|
return Object.keys(other).length === 0;
|
|
}
|
|
return false;
|
|
};
|
|
|
|
Empty.prototype.jasmineToString = function() {
|
|
return '<jasmine.empty>';
|
|
};
|
|
|
|
return Empty;
|
|
};
|
|
|
|
getJasmineRequireObj().Falsy = function(j$) {
|
|
function Falsy() {}
|
|
|
|
Falsy.prototype.asymmetricMatch = function(other) {
|
|
return !other;
|
|
};
|
|
|
|
Falsy.prototype.jasmineToString = function() {
|
|
return '<jasmine.falsy>';
|
|
};
|
|
|
|
return Falsy;
|
|
};
|
|
|
|
getJasmineRequireObj().Is = function(j$) {
|
|
class Is {
|
|
constructor(expected) {
|
|
this.expected_ = expected;
|
|
}
|
|
|
|
asymmetricMatch(actual) {
|
|
return actual === this.expected_;
|
|
}
|
|
|
|
jasmineToString(pp) {
|
|
return `<jasmine.is(${pp(this.expected_)})>`;
|
|
}
|
|
}
|
|
|
|
return Is;
|
|
};
|
|
|
|
getJasmineRequireObj().MapContaining = function(j$) {
|
|
function MapContaining(sample) {
|
|
if (!j$.isMap(sample)) {
|
|
throw new Error(
|
|
'You must provide a map to `mapContaining`, not ' +
|
|
j$.basicPrettyPrinter_(sample)
|
|
);
|
|
}
|
|
|
|
this.sample = sample;
|
|
}
|
|
|
|
MapContaining.prototype.asymmetricMatch = function(other, matchersUtil) {
|
|
if (!j$.isMap(other)) return false;
|
|
|
|
for (const [key, value] of this.sample) {
|
|
// for each key/value pair in `sample`
|
|
// there should be at least one pair in `other` whose key and value both match
|
|
let hasMatch = false;
|
|
for (const [oKey, oValue] of other) {
|
|
if (
|
|
matchersUtil.equals(oKey, key) &&
|
|
matchersUtil.equals(oValue, value)
|
|
) {
|
|
hasMatch = true;
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (!hasMatch) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
return true;
|
|
};
|
|
|
|
MapContaining.prototype.jasmineToString = function(pp) {
|
|
return '<jasmine.mapContaining(' + pp(this.sample) + ')>';
|
|
};
|
|
|
|
return MapContaining;
|
|
};
|
|
|
|
getJasmineRequireObj().NotEmpty = function(j$) {
|
|
function NotEmpty() {}
|
|
|
|
NotEmpty.prototype.asymmetricMatch = function(other) {
|
|
if (j$.isString_(other) || j$.isArray_(other) || j$.isTypedArray_(other)) {
|
|
return other.length !== 0;
|
|
}
|
|
|
|
if (j$.isMap(other) || j$.isSet(other)) {
|
|
return other.size !== 0;
|
|
}
|
|
|
|
if (j$.isObject_(other)) {
|
|
return Object.keys(other).length !== 0;
|
|
}
|
|
|
|
return false;
|
|
};
|
|
|
|
NotEmpty.prototype.jasmineToString = function() {
|
|
return '<jasmine.notEmpty>';
|
|
};
|
|
|
|
return NotEmpty;
|
|
};
|
|
|
|
getJasmineRequireObj().ObjectContaining = function(j$) {
|
|
function ObjectContaining(sample) {
|
|
this.sample = sample;
|
|
}
|
|
|
|
function hasProperty(obj, property) {
|
|
if (!obj || typeof obj !== 'object') {
|
|
return false;
|
|
}
|
|
|
|
if (Object.prototype.hasOwnProperty.call(obj, property)) {
|
|
return true;
|
|
}
|
|
|
|
return hasProperty(Object.getPrototypeOf(obj), property);
|
|
}
|
|
|
|
ObjectContaining.prototype.asymmetricMatch = function(other, matchersUtil) {
|
|
if (typeof this.sample !== 'object') {
|
|
throw new Error(
|
|
"You must provide an object to objectContaining, not '" +
|
|
this.sample +
|
|
"'."
|
|
);
|
|
}
|
|
if (typeof other !== 'object') {
|
|
return false;
|
|
}
|
|
|
|
for (const property in this.sample) {
|
|
if (
|
|
!hasProperty(other, property) ||
|
|
!matchersUtil.equals(this.sample[property], other[property])
|
|
) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
return true;
|
|
};
|
|
|
|
ObjectContaining.prototype.valuesForDiff_ = function(other, pp) {
|
|
if (!j$.isObject_(other)) {
|
|
return {
|
|
self: this.jasmineToString(pp),
|
|
other: other
|
|
};
|
|
}
|
|
|
|
const filteredOther = {};
|
|
Object.keys(this.sample).forEach(function(k) {
|
|
// eq short-circuits comparison of objects that have different key sets,
|
|
// so include all keys even if undefined.
|
|
filteredOther[k] = other[k];
|
|
});
|
|
|
|
return {
|
|
self: this.sample,
|
|
other: filteredOther
|
|
};
|
|
};
|
|
|
|
ObjectContaining.prototype.jasmineToString = function(pp) {
|
|
return '<jasmine.objectContaining(' + pp(this.sample) + ')>';
|
|
};
|
|
|
|
return ObjectContaining;
|
|
};
|
|
|
|
getJasmineRequireObj().SetContaining = function(j$) {
|
|
function SetContaining(sample) {
|
|
if (!j$.isSet(sample)) {
|
|
throw new Error(
|
|
'You must provide a set to `setContaining`, not ' +
|
|
j$.basicPrettyPrinter_(sample)
|
|
);
|
|
}
|
|
|
|
this.sample = sample;
|
|
}
|
|
|
|
SetContaining.prototype.asymmetricMatch = function(other, matchersUtil) {
|
|
if (!j$.isSet(other)) return false;
|
|
|
|
for (const item of this.sample) {
|
|
// for each item in `sample` there should be at least one matching item in `other`
|
|
// (not using `matchersUtil.contains` because it compares set members by reference,
|
|
// not by deep value equality)
|
|
let hasMatch = false;
|
|
for (const oItem of other) {
|
|
if (matchersUtil.equals(oItem, item)) {
|
|
hasMatch = true;
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (!hasMatch) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
return true;
|
|
};
|
|
|
|
SetContaining.prototype.jasmineToString = function(pp) {
|
|
return '<jasmine.setContaining(' + pp(this.sample) + ')>';
|
|
};
|
|
|
|
return SetContaining;
|
|
};
|
|
|
|
getJasmineRequireObj().StringContaining = function(j$) {
|
|
function StringContaining(expected) {
|
|
if (!j$.isString_(expected)) {
|
|
throw new Error('Expected is not a String');
|
|
}
|
|
|
|
this.expected = expected;
|
|
}
|
|
|
|
StringContaining.prototype.asymmetricMatch = function(other) {
|
|
if (!j$.isString_(other)) {
|
|
// Arrays, etc. don't match no matter what their indexOf returns.
|
|
return false;
|
|
}
|
|
|
|
return other.indexOf(this.expected) !== -1;
|
|
};
|
|
|
|
StringContaining.prototype.jasmineToString = function() {
|
|
return '<jasmine.stringContaining("' + this.expected + '")>';
|
|
};
|
|
|
|
return StringContaining;
|
|
};
|
|
|
|
getJasmineRequireObj().StringMatching = function(j$) {
|
|
function StringMatching(expected) {
|
|
if (!j$.isString_(expected) && !j$.isA_('RegExp', expected)) {
|
|
throw new Error('Expected is not a String or a RegExp');
|
|
}
|
|
|
|
this.regexp = new RegExp(expected);
|
|
}
|
|
|
|
StringMatching.prototype.asymmetricMatch = function(other) {
|
|
return this.regexp.test(other);
|
|
};
|
|
|
|
StringMatching.prototype.jasmineToString = function() {
|
|
return '<jasmine.stringMatching(' + this.regexp + ')>';
|
|
};
|
|
|
|
return StringMatching;
|
|
};
|
|
|
|
getJasmineRequireObj().Truthy = function(j$) {
|
|
function Truthy() {}
|
|
|
|
Truthy.prototype.asymmetricMatch = function(other) {
|
|
return !!other;
|
|
};
|
|
|
|
Truthy.prototype.jasmineToString = function() {
|
|
return '<jasmine.truthy>';
|
|
};
|
|
|
|
return Truthy;
|
|
};
|
|
|
|
//TODO: expectation result may make more sense as a presentation of an expectation.
|
|
getJasmineRequireObj().buildExpectationResult = function(j$) {
|
|
function buildExpectationResult(options) {
|
|
const exceptionFormatter = new j$.ExceptionFormatter();
|
|
|
|
/**
|
|
* @typedef Expectation
|
|
* @property {String} matcherName - The name of the matcher that was executed for this expectation.
|
|
* @property {String} message - The failure message for the expectation.
|
|
* @property {String} stack - The stack trace for the failure if available.
|
|
* @property {Boolean} passed - Whether the expectation passed or failed.
|
|
* @property {Object} expected - If the expectation failed, what was the expected value.
|
|
* @property {Object} actual - If the expectation failed, what actual value was produced.
|
|
* @property {String|undefined} globalErrorType - The type of an error that
|
|
* is reported on the top suite. Valid values are undefined, "afterAll",
|
|
* "load", "lateExpectation", and "lateError".
|
|
*/
|
|
const result = {
|
|
matcherName: options.matcherName,
|
|
message: message(),
|
|
stack: options.omitStackTrace ? '' : stack(),
|
|
passed: options.passed
|
|
};
|
|
|
|
if (!result.passed) {
|
|
result.expected = options.expected;
|
|
result.actual = options.actual;
|
|
|
|
if (options.error && !j$.isString_(options.error)) {
|
|
if ('code' in options.error) {
|
|
result.code = options.error.code;
|
|
}
|
|
|
|
if (
|
|
options.error.code === 'ERR_ASSERTION' &&
|
|
options.expected === '' &&
|
|
options.actual === ''
|
|
) {
|
|
result.expected = options.error.expected;
|
|
result.actual = options.error.actual;
|
|
result.matcherName = 'assert ' + options.error.operator;
|
|
}
|
|
}
|
|
}
|
|
|
|
return result;
|
|
|
|
function message() {
|
|
if (options.passed) {
|
|
return 'Passed.';
|
|
} else if (options.message) {
|
|
return options.message;
|
|
} else if (options.error) {
|
|
return exceptionFormatter.message(options.error);
|
|
}
|
|
return '';
|
|
}
|
|
|
|
function stack() {
|
|
if (options.passed) {
|
|
return '';
|
|
}
|
|
|
|
let error = options.error;
|
|
|
|
if (!error) {
|
|
if (options.errorForStack) {
|
|
error = options.errorForStack;
|
|
} else if (options.stack) {
|
|
error = options;
|
|
} else {
|
|
try {
|
|
throw new Error(message());
|
|
} catch (e) {
|
|
error = e;
|
|
}
|
|
}
|
|
}
|
|
// Omit the message from the stack trace because it will be
|
|
// included elsewhere.
|
|
return exceptionFormatter.stack(error, { omitMessage: true });
|
|
}
|
|
}
|
|
|
|
return buildExpectationResult;
|
|
};
|
|
|
|
getJasmineRequireObj().CallTracker = function(j$) {
|
|
/**
|
|
* @namespace Spy#calls
|
|
* @since 2.0.0
|
|
*/
|
|
function CallTracker() {
|
|
let calls = [];
|
|
const opts = {};
|
|
|
|
this.track = function(context) {
|
|
if (opts.cloneArgs) {
|
|
context.args = j$.util.cloneArgs(context.args);
|
|
}
|
|
calls.push(context);
|
|
};
|
|
|
|
/**
|
|
* Check whether this spy has been invoked.
|
|
* @name Spy#calls#any
|
|
* @since 2.0.0
|
|
* @function
|
|
* @return {Boolean}
|
|
*/
|
|
this.any = function() {
|
|
return !!calls.length;
|
|
};
|
|
|
|
/**
|
|
* Get the number of invocations of this spy.
|
|
* @name Spy#calls#count
|
|
* @since 2.0.0
|
|
* @function
|
|
* @return {Integer}
|
|
*/
|
|
this.count = function() {
|
|
return calls.length;
|
|
};
|
|
|
|
/**
|
|
* Get the arguments that were passed to a specific invocation of this spy.
|
|
* @name Spy#calls#argsFor
|
|
* @since 2.0.0
|
|
* @function
|
|
* @param {Integer} index The 0-based invocation index.
|
|
* @return {Array}
|
|
*/
|
|
this.argsFor = function(index) {
|
|
const call = calls[index];
|
|
return call ? call.args : [];
|
|
};
|
|
|
|
/**
|
|
* Get the "this" object that was passed to a specific invocation of this spy.
|
|
* @name Spy#calls#thisFor
|
|
* @since 3.8.0
|
|
* @function
|
|
* @param {Integer} index The 0-based invocation index.
|
|
* @return {Object?}
|
|
*/
|
|
this.thisFor = function(index) {
|
|
const call = calls[index];
|
|
return call ? call.object : undefined;
|
|
};
|
|
|
|
/**
|
|
* Get the raw calls array for this spy.
|
|
* @name Spy#calls#all
|
|
* @since 2.0.0
|
|
* @function
|
|
* @return {Spy.callData[]}
|
|
*/
|
|
this.all = function() {
|
|
return calls;
|
|
};
|
|
|
|
/**
|
|
* Get all of the arguments for each invocation of this spy in the order they were received.
|
|
* @name Spy#calls#allArgs
|
|
* @since 2.0.0
|
|
* @function
|
|
* @return {Array}
|
|
*/
|
|
this.allArgs = function() {
|
|
return calls.map(c => c.args);
|
|
};
|
|
|
|
/**
|
|
* Get the first invocation of this spy.
|
|
* @name Spy#calls#first
|
|
* @since 2.0.0
|
|
* @function
|
|
* @return {ObjecSpy.callData}
|
|
*/
|
|
this.first = function() {
|
|
return calls[0];
|
|
};
|
|
|
|
/**
|
|
* Get the most recent invocation of this spy.
|
|
* @name Spy#calls#mostRecent
|
|
* @since 2.0.0
|
|
* @function
|
|
* @return {ObjecSpy.callData}
|
|
*/
|
|
this.mostRecent = function() {
|
|
return calls[calls.length - 1];
|
|
};
|
|
|
|
/**
|
|
* Reset this spy as if it has never been called.
|
|
* @name Spy#calls#reset
|
|
* @since 2.0.0
|
|
* @function
|
|
*/
|
|
this.reset = function() {
|
|
calls = [];
|
|
};
|
|
|
|
/**
|
|
* Set this spy to do a shallow clone of arguments passed to each invocation.
|
|
* @name Spy#calls#saveArgumentsByValue
|
|
* @since 2.5.0
|
|
* @function
|
|
*/
|
|
this.saveArgumentsByValue = function() {
|
|
opts.cloneArgs = true;
|
|
};
|
|
}
|
|
|
|
return CallTracker;
|
|
};
|
|
|
|
getJasmineRequireObj().clearStack = function(j$) {
|
|
const maxInlineCallCount = 10;
|
|
|
|
function browserQueueMicrotaskImpl(global) {
|
|
const { setTimeout, queueMicrotask } = global;
|
|
let currentCallCount = 0;
|
|
return function clearStack(fn) {
|
|
currentCallCount++;
|
|
|
|
if (currentCallCount < maxInlineCallCount) {
|
|
queueMicrotask(fn);
|
|
} else {
|
|
currentCallCount = 0;
|
|
setTimeout(fn);
|
|
}
|
|
};
|
|
}
|
|
|
|
function nodeQueueMicrotaskImpl(global) {
|
|
const { queueMicrotask } = global;
|
|
|
|
return function(fn) {
|
|
queueMicrotask(fn);
|
|
};
|
|
}
|
|
|
|
function messageChannelImpl(global) {
|
|
const { MessageChannel, setTimeout } = global;
|
|
const channel = new MessageChannel();
|
|
let head = {};
|
|
let tail = head;
|
|
|
|
let taskRunning = false;
|
|
channel.port1.onmessage = function() {
|
|
head = head.next;
|
|
const task = head.task;
|
|
delete head.task;
|
|
|
|
if (taskRunning) {
|
|
setTimeout(task, 0);
|
|
} else {
|
|
try {
|
|
taskRunning = true;
|
|
task();
|
|
} finally {
|
|
taskRunning = false;
|
|
}
|
|
}
|
|
};
|
|
|
|
let currentCallCount = 0;
|
|
return function clearStack(fn) {
|
|
currentCallCount++;
|
|
|
|
if (currentCallCount < maxInlineCallCount) {
|
|
tail = tail.next = { task: fn };
|
|
channel.port2.postMessage(0);
|
|
} else {
|
|
currentCallCount = 0;
|
|
setTimeout(fn);
|
|
}
|
|
};
|
|
}
|
|
|
|
function getClearStack(global) {
|
|
const NODE_JS =
|
|
global.process &&
|
|
global.process.versions &&
|
|
typeof global.process.versions.node === 'string';
|
|
|
|
const SAFARI =
|
|
global.navigator &&
|
|
/^((?!chrome|android).)*safari/i.test(global.navigator.userAgent);
|
|
|
|
if (NODE_JS) {
|
|
// Unlike browsers, Node doesn't require us to do a periodic setTimeout
|
|
// so we avoid the overhead.
|
|
return nodeQueueMicrotaskImpl(global);
|
|
} else if (
|
|
SAFARI ||
|
|
j$.util.isUndefined(global.MessageChannel) /* tests */
|
|
) {
|
|
// queueMicrotask is dramatically faster than MessageChannel in Safari,
|
|
// at least through version 16.
|
|
// Some of our own integration tests provide a mock queueMicrotask in all
|
|
// environments because it's simpler to mock than MessageChannel.
|
|
return browserQueueMicrotaskImpl(global);
|
|
} else {
|
|
// MessageChannel is faster than queueMicrotask in supported browsers
|
|
// other than Safari.
|
|
return messageChannelImpl(global);
|
|
}
|
|
}
|
|
|
|
return getClearStack;
|
|
};
|
|
|
|
getJasmineRequireObj().Clock = function() {
|
|
/* global process */
|
|
const NODE_JS =
|
|
typeof process !== 'undefined' &&
|
|
process.versions &&
|
|
typeof process.versions.node === 'string';
|
|
|
|
/**
|
|
* @class Clock
|
|
* @since 1.3.0
|
|
* @classdesc Jasmine's mock clock is used when testing time dependent code.<br>
|
|
* _Note:_ Do not construct this directly. You can get the current clock with
|
|
* {@link jasmine.clock}.
|
|
* @hideconstructor
|
|
*/
|
|
function Clock(global, delayedFunctionSchedulerFactory, mockDate) {
|
|
const realTimingFunctions = {
|
|
setTimeout: global.setTimeout,
|
|
clearTimeout: global.clearTimeout,
|
|
setInterval: global.setInterval,
|
|
clearInterval: global.clearInterval
|
|
};
|
|
const fakeTimingFunctions = {
|
|
setTimeout: setTimeout,
|
|
clearTimeout: clearTimeout,
|
|
setInterval: setInterval,
|
|
clearInterval: clearInterval
|
|
};
|
|
let installed = false;
|
|
let delayedFunctionScheduler;
|
|
let timer;
|
|
|
|
this.FakeTimeout = FakeTimeout;
|
|
|
|
/**
|
|
* Install the mock clock over the built-in methods.
|
|
* @name Clock#install
|
|
* @since 2.0.0
|
|
* @function
|
|
* @return {Clock}
|
|
*/
|
|
this.install = function() {
|
|
if (!originalTimingFunctionsIntact()) {
|
|
throw new Error(
|
|
'Jasmine Clock was unable to install over custom global timer functions. Is the clock already installed?'
|
|
);
|
|
}
|
|
replace(global, fakeTimingFunctions);
|
|
timer = fakeTimingFunctions;
|
|
delayedFunctionScheduler = delayedFunctionSchedulerFactory();
|
|
installed = true;
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Uninstall the mock clock, returning the built-in methods to their places.
|
|
* @name Clock#uninstall
|
|
* @since 2.0.0
|
|
* @function
|
|
*/
|
|
this.uninstall = function() {
|
|
delayedFunctionScheduler = null;
|
|
mockDate.uninstall();
|
|
replace(global, realTimingFunctions);
|
|
|
|
timer = realTimingFunctions;
|
|
installed = false;
|
|
};
|
|
|
|
/**
|
|
* Execute a function with a mocked Clock
|
|
*
|
|
* The clock will be {@link Clock#install|install}ed before the function is called and {@link Clock#uninstall|uninstall}ed in a `finally` after the function completes.
|
|
* @name Clock#withMock
|
|
* @since 2.3.0
|
|
* @function
|
|
* @param {Function} closure The function to be called.
|
|
*/
|
|
this.withMock = function(closure) {
|
|
this.install();
|
|
try {
|
|
closure();
|
|
} finally {
|
|
this.uninstall();
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Instruct the installed Clock to also mock the date returned by `new Date()`
|
|
* @name Clock#mockDate
|
|
* @since 2.1.0
|
|
* @function
|
|
* @param {Date} [initialDate=now] The `Date` to provide.
|
|
*/
|
|
this.mockDate = function(initialDate) {
|
|
mockDate.install(initialDate);
|
|
};
|
|
|
|
this.setTimeout = function(fn, delay, params) {
|
|
return Function.prototype.apply.apply(timer.setTimeout, [
|
|
global,
|
|
arguments
|
|
]);
|
|
};
|
|
|
|
this.setInterval = function(fn, delay, params) {
|
|
return Function.prototype.apply.apply(timer.setInterval, [
|
|
global,
|
|
arguments
|
|
]);
|
|
};
|
|
|
|
this.clearTimeout = function(id) {
|
|
return Function.prototype.call.apply(timer.clearTimeout, [global, id]);
|
|
};
|
|
|
|
this.clearInterval = function(id) {
|
|
return Function.prototype.call.apply(timer.clearInterval, [global, id]);
|
|
};
|
|
|
|
/**
|
|
* Tick the Clock forward, running any enqueued timeouts along the way
|
|
* @name Clock#tick
|
|
* @since 1.3.0
|
|
* @function
|
|
* @param {int} millis The number of milliseconds to tick.
|
|
*/
|
|
this.tick = function(millis) {
|
|
if (installed) {
|
|
delayedFunctionScheduler.tick(millis, function(millis) {
|
|
mockDate.tick(millis);
|
|
});
|
|
} else {
|
|
throw new Error(
|
|
'Mock clock is not installed, use jasmine.clock().install()'
|
|
);
|
|
}
|
|
};
|
|
|
|
return this;
|
|
|
|
function originalTimingFunctionsIntact() {
|
|
return (
|
|
global.setTimeout === realTimingFunctions.setTimeout &&
|
|
global.clearTimeout === realTimingFunctions.clearTimeout &&
|
|
global.setInterval === realTimingFunctions.setInterval &&
|
|
global.clearInterval === realTimingFunctions.clearInterval
|
|
);
|
|
}
|
|
|
|
function replace(dest, source) {
|
|
for (const prop in source) {
|
|
dest[prop] = source[prop];
|
|
}
|
|
}
|
|
|
|
function setTimeout(fn, delay) {
|
|
if (!NODE_JS) {
|
|
return delayedFunctionScheduler.scheduleFunction(
|
|
fn,
|
|
delay,
|
|
argSlice(arguments, 2)
|
|
);
|
|
}
|
|
|
|
const timeout = new FakeTimeout();
|
|
|
|
delayedFunctionScheduler.scheduleFunction(
|
|
fn,
|
|
delay,
|
|
argSlice(arguments, 2),
|
|
false,
|
|
timeout
|
|
);
|
|
|
|
return timeout;
|
|
}
|
|
|
|
function clearTimeout(id) {
|
|
return delayedFunctionScheduler.removeFunctionWithId(id);
|
|
}
|
|
|
|
function setInterval(fn, interval) {
|
|
if (!NODE_JS) {
|
|
return delayedFunctionScheduler.scheduleFunction(
|
|
fn,
|
|
interval,
|
|
argSlice(arguments, 2),
|
|
true
|
|
);
|
|
}
|
|
|
|
const timeout = new FakeTimeout();
|
|
|
|
delayedFunctionScheduler.scheduleFunction(
|
|
fn,
|
|
interval,
|
|
argSlice(arguments, 2),
|
|
true,
|
|
timeout
|
|
);
|
|
|
|
return timeout;
|
|
}
|
|
|
|
function clearInterval(id) {
|
|
return delayedFunctionScheduler.removeFunctionWithId(id);
|
|
}
|
|
|
|
function argSlice(argsObj, n) {
|
|
return Array.prototype.slice.call(argsObj, n);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Mocks Node.js Timeout class
|
|
*/
|
|
function FakeTimeout() {}
|
|
|
|
FakeTimeout.prototype.ref = function() {
|
|
return this;
|
|
};
|
|
|
|
FakeTimeout.prototype.unref = function() {
|
|
return this;
|
|
};
|
|
|
|
return Clock;
|
|
};
|
|
|
|
getJasmineRequireObj().CompleteOnFirstErrorSkipPolicy = function(j$) {
|
|
function CompleteOnFirstErrorSkipPolicy(queueableFns) {
|
|
this.queueableFns_ = queueableFns;
|
|
this.erroredFnIx_ = null;
|
|
}
|
|
|
|
CompleteOnFirstErrorSkipPolicy.prototype.skipTo = function(lastRanFnIx) {
|
|
let i;
|
|
|
|
for (
|
|
i = lastRanFnIx + 1;
|
|
i < this.queueableFns_.length && this.shouldSkip_(i);
|
|
i++
|
|
) {}
|
|
return i;
|
|
};
|
|
|
|
CompleteOnFirstErrorSkipPolicy.prototype.fnErrored = function(fnIx) {
|
|
this.erroredFnIx_ = fnIx;
|
|
};
|
|
|
|
CompleteOnFirstErrorSkipPolicy.prototype.shouldSkip_ = function(fnIx) {
|
|
if (this.erroredFnIx_ === null) {
|
|
return false;
|
|
}
|
|
|
|
const fn = this.queueableFns_[fnIx];
|
|
const candidateSuite = fn.suite;
|
|
const errorSuite = this.queueableFns_[this.erroredFnIx_].suite;
|
|
const wasCleanupFn =
|
|
fn.type === 'afterEach' ||
|
|
fn.type === 'afterAll' ||
|
|
fn.type === 'specCleanup';
|
|
return (
|
|
!wasCleanupFn ||
|
|
(candidateSuite && isDescendent(candidateSuite, errorSuite))
|
|
);
|
|
};
|
|
|
|
function isDescendent(candidate, ancestor) {
|
|
if (!candidate.parentSuite) {
|
|
return false;
|
|
} else if (candidate.parentSuite === ancestor) {
|
|
return true;
|
|
} else {
|
|
return isDescendent(candidate.parentSuite, ancestor);
|
|
}
|
|
}
|
|
|
|
return CompleteOnFirstErrorSkipPolicy;
|
|
};
|
|
|
|
getJasmineRequireObj().DelayedFunctionScheduler = function(j$) {
|
|
function DelayedFunctionScheduler() {
|
|
this.scheduledLookup_ = [];
|
|
this.scheduledFunctions_ = {};
|
|
this.currentTime_ = 0;
|
|
this.delayedFnCount_ = 0;
|
|
this.deletedKeys_ = [];
|
|
|
|
this.tick = function(millis, tickDate) {
|
|
millis = millis || 0;
|
|
const endTime = this.currentTime_ + millis;
|
|
|
|
this.runScheduledFunctions_(endTime, tickDate);
|
|
};
|
|
|
|
this.scheduleFunction = function(
|
|
funcToCall,
|
|
millis,
|
|
params,
|
|
recurring,
|
|
timeoutKey,
|
|
runAtMillis
|
|
) {
|
|
let f;
|
|
if (typeof funcToCall === 'string') {
|
|
f = function() {
|
|
// eslint-disable-next-line no-eval
|
|
return eval(funcToCall);
|
|
};
|
|
} else {
|
|
f = funcToCall;
|
|
}
|
|
|
|
millis = millis || 0;
|
|
timeoutKey = timeoutKey || ++this.delayedFnCount_;
|
|
runAtMillis = runAtMillis || this.currentTime_ + millis;
|
|
|
|
const funcToSchedule = {
|
|
runAtMillis: runAtMillis,
|
|
funcToCall: f,
|
|
recurring: recurring,
|
|
params: params,
|
|
timeoutKey: timeoutKey,
|
|
millis: millis
|
|
};
|
|
|
|
if (runAtMillis in this.scheduledFunctions_) {
|
|
this.scheduledFunctions_[runAtMillis].push(funcToSchedule);
|
|
} else {
|
|
this.scheduledFunctions_[runAtMillis] = [funcToSchedule];
|
|
this.scheduledLookup_.push(runAtMillis);
|
|
this.scheduledLookup_.sort(function(a, b) {
|
|
return a - b;
|
|
});
|
|
}
|
|
|
|
return timeoutKey;
|
|
};
|
|
|
|
this.removeFunctionWithId = function(timeoutKey) {
|
|
this.deletedKeys_.push(timeoutKey);
|
|
|
|
for (const runAtMillis in this.scheduledFunctions_) {
|
|
const funcs = this.scheduledFunctions_[runAtMillis];
|
|
const i = indexOfFirstToPass(funcs, function(func) {
|
|
return func.timeoutKey === timeoutKey;
|
|
});
|
|
|
|
if (i > -1) {
|
|
if (funcs.length === 1) {
|
|
delete this.scheduledFunctions_[runAtMillis];
|
|
this.deleteFromLookup_(runAtMillis);
|
|
} else {
|
|
funcs.splice(i, 1);
|
|
}
|
|
|
|
// intervals get rescheduled when executed, so there's never more
|
|
// than a single scheduled function with a given timeoutKey
|
|
break;
|
|
}
|
|
}
|
|
};
|
|
|
|
return this;
|
|
}
|
|
|
|
DelayedFunctionScheduler.prototype.runScheduledFunctions_ = function(
|
|
endTime,
|
|
tickDate
|
|
) {
|
|
tickDate = tickDate || function() {};
|
|
if (
|
|
this.scheduledLookup_.length === 0 ||
|
|
this.scheduledLookup_[0] > endTime
|
|
) {
|
|
if (endTime >= this.currentTime_) {
|
|
tickDate(endTime - this.currentTime_);
|
|
this.currentTime_ = endTime;
|
|
}
|
|
return;
|
|
}
|
|
|
|
do {
|
|
this.deletedKeys_ = [];
|
|
const newCurrentTime = this.scheduledLookup_.shift();
|
|
if (newCurrentTime >= this.currentTime_) {
|
|
tickDate(newCurrentTime - this.currentTime_);
|
|
this.currentTime_ = newCurrentTime;
|
|
}
|
|
|
|
const funcsToRun = this.scheduledFunctions_[this.currentTime_];
|
|
|
|
delete this.scheduledFunctions_[this.currentTime_];
|
|
|
|
for (const fn of funcsToRun) {
|
|
if (fn.recurring) {
|
|
this.reschedule_(fn);
|
|
}
|
|
}
|
|
|
|
for (const fn of funcsToRun) {
|
|
if (this.deletedKeys_.includes(fn.timeoutKey)) {
|
|
// skip a timeoutKey deleted whilst we were running
|
|
return;
|
|
}
|
|
fn.funcToCall.apply(null, fn.params || []);
|
|
}
|
|
this.deletedKeys_ = [];
|
|
} while (
|
|
this.scheduledLookup_.length > 0 &&
|
|
// checking first if we're out of time prevents setTimeout(0)
|
|
// scheduled in a funcToRun from forcing an extra iteration
|
|
this.currentTime_ !== endTime &&
|
|
this.scheduledLookup_[0] <= endTime
|
|
);
|
|
|
|
// ran out of functions to call, but still time left on the clock
|
|
if (endTime >= this.currentTime_) {
|
|
tickDate(endTime - this.currentTime_);
|
|
this.currentTime_ = endTime;
|
|
}
|
|
};
|
|
|
|
DelayedFunctionScheduler.prototype.reschedule_ = function(scheduledFn) {
|
|
this.scheduleFunction(
|
|
scheduledFn.funcToCall,
|
|
scheduledFn.millis,
|
|
scheduledFn.params,
|
|
true,
|
|
scheduledFn.timeoutKey,
|
|
scheduledFn.runAtMillis + scheduledFn.millis
|
|
);
|
|
};
|
|
|
|
DelayedFunctionScheduler.prototype.deleteFromLookup_ = function(key) {
|
|
const value = Number(key);
|
|
const i = indexOfFirstToPass(this.scheduledLookup_, function(millis) {
|
|
return millis === value;
|
|
});
|
|
|
|
if (i > -1) {
|
|
this.scheduledLookup_.splice(i, 1);
|
|
}
|
|
};
|
|
|
|
function indexOfFirstToPass(array, testFn) {
|
|
let index = -1;
|
|
|
|
for (let i = 0; i < array.length; ++i) {
|
|
if (testFn(array[i])) {
|
|
index = i;
|
|
break;
|
|
}
|
|
}
|
|
|
|
return index;
|
|
}
|
|
|
|
return DelayedFunctionScheduler;
|
|
};
|
|
|
|
getJasmineRequireObj().Deprecator = function(j$) {
|
|
function Deprecator(topSuite) {
|
|
this.topSuite_ = topSuite;
|
|
this.verbose_ = false;
|
|
this.toSuppress_ = [];
|
|
}
|
|
|
|
const verboseNote =
|
|
'Note: This message will be shown only once. Set the verboseDeprecations ' +
|
|
'config property to true to see every occurrence.';
|
|
|
|
Deprecator.prototype.verboseDeprecations = function(enabled) {
|
|
this.verbose_ = enabled;
|
|
};
|
|
|
|
// runnable is a spec or a suite.
|
|
// deprecation is a string or an Error.
|
|
// See Env#deprecated for a description of the options argument.
|
|
Deprecator.prototype.addDeprecationWarning = function(
|
|
runnable,
|
|
deprecation,
|
|
options
|
|
) {
|
|
options = options || {};
|
|
|
|
if (!this.verbose_ && !j$.isError_(deprecation)) {
|
|
if (this.toSuppress_.indexOf(deprecation) !== -1) {
|
|
return;
|
|
}
|
|
this.toSuppress_.push(deprecation);
|
|
}
|
|
|
|
this.log_(runnable, deprecation, options);
|
|
this.report_(runnable, deprecation, options);
|
|
};
|
|
|
|
Deprecator.prototype.log_ = function(runnable, deprecation, options) {
|
|
if (j$.isError_(deprecation)) {
|
|
console.error(deprecation);
|
|
return;
|
|
}
|
|
|
|
let context;
|
|
|
|
if (runnable === this.topSuite_ || options.ignoreRunnable) {
|
|
context = '';
|
|
} else if (runnable.children) {
|
|
context = ' (in suite: ' + runnable.getFullName() + ')';
|
|
} else {
|
|
context = ' (in spec: ' + runnable.getFullName() + ')';
|
|
}
|
|
|
|
if (!options.omitStackTrace) {
|
|
context += '\n' + this.stackTrace_();
|
|
}
|
|
|
|
if (!this.verbose_) {
|
|
context += '\n' + verboseNote;
|
|
}
|
|
|
|
console.error('DEPRECATION: ' + deprecation + context);
|
|
};
|
|
|
|
Deprecator.prototype.stackTrace_ = function() {
|
|
const formatter = new j$.ExceptionFormatter();
|
|
return formatter.stack(j$.util.errorWithStack()).replace(/^Error\n/m, '');
|
|
};
|
|
|
|
Deprecator.prototype.report_ = function(runnable, deprecation, options) {
|
|
if (options.ignoreRunnable) {
|
|
runnable = this.topSuite_;
|
|
}
|
|
|
|
if (j$.isError_(deprecation)) {
|
|
runnable.addDeprecationWarning(deprecation);
|
|
return;
|
|
}
|
|
|
|
if (!this.verbose_) {
|
|
deprecation += '\n' + verboseNote;
|
|
}
|
|
|
|
runnable.addDeprecationWarning({
|
|
message: deprecation,
|
|
omitStackTrace: options.omitStackTrace || false
|
|
});
|
|
};
|
|
|
|
return Deprecator;
|
|
};
|
|
|
|
getJasmineRequireObj().errors = function() {
|
|
function ExpectationFailed() {}
|
|
|
|
ExpectationFailed.prototype = new Error();
|
|
ExpectationFailed.prototype.constructor = ExpectationFailed;
|
|
|
|
return {
|
|
ExpectationFailed: ExpectationFailed
|
|
};
|
|
};
|
|
|
|
getJasmineRequireObj().ExceptionFormatter = function(j$) {
|
|
const ignoredProperties = [
|
|
'name',
|
|
'message',
|
|
'stack',
|
|
'fileName',
|
|
'sourceURL',
|
|
'line',
|
|
'lineNumber',
|
|
'column',
|
|
'description',
|
|
'jasmineMessage'
|
|
];
|
|
|
|
function ExceptionFormatter(options) {
|
|
const jasmineFile =
|
|
(options && options.jasmineFile) || j$.util.jasmineFile();
|
|
this.message = function(error) {
|
|
let message = '';
|
|
|
|
if (error.jasmineMessage) {
|
|
message += error.jasmineMessage;
|
|
} else if (error.name && error.message) {
|
|
message += error.name + ': ' + error.message;
|
|
} else if (error.message) {
|
|
message += error.message;
|
|
} else {
|
|
message += error.toString() + ' thrown';
|
|
}
|
|
|
|
if (error.fileName || error.sourceURL) {
|
|
message += ' in ' + (error.fileName || error.sourceURL);
|
|
}
|
|
|
|
if (error.line || error.lineNumber) {
|
|
message += ' (line ' + (error.line || error.lineNumber) + ')';
|
|
}
|
|
|
|
return message;
|
|
};
|
|
|
|
this.stack = function(error, { omitMessage } = {}) {
|
|
if (!error || !error.stack) {
|
|
return null;
|
|
}
|
|
|
|
const lines = this.stack_(error, {
|
|
messageHandling: omitMessage ? 'omit' : undefined
|
|
});
|
|
return lines.join('\n');
|
|
};
|
|
|
|
// messageHandling can be falsy (unspecified), 'omit', or 'require'
|
|
this.stack_ = function(error, { messageHandling }) {
|
|
let lines = formatProperties(error).split('\n');
|
|
|
|
if (lines[lines.length - 1] === '') {
|
|
lines.pop();
|
|
}
|
|
|
|
const stackTrace = new j$.StackTrace(error);
|
|
lines = lines.concat(filterJasmine(stackTrace));
|
|
|
|
if (messageHandling === 'require') {
|
|
lines.unshift(stackTrace.message || 'Error: ' + error.message);
|
|
} else if (messageHandling !== 'omit' && stackTrace.message) {
|
|
lines.unshift(stackTrace.message);
|
|
}
|
|
|
|
if (error.cause) {
|
|
const substack = this.stack_(error.cause, {
|
|
messageHandling: 'require'
|
|
});
|
|
substack[0] = 'Caused by: ' + substack[0];
|
|
lines = lines.concat(substack);
|
|
}
|
|
|
|
return lines;
|
|
};
|
|
|
|
function filterJasmine(stackTrace) {
|
|
const result = [];
|
|
const jasmineMarker =
|
|
stackTrace.style === 'webkit' ? '<Jasmine>' : ' at <Jasmine>';
|
|
|
|
stackTrace.frames.forEach(function(frame) {
|
|
if (frame.file !== jasmineFile) {
|
|
result.push(frame.raw);
|
|
} else if (result[result.length - 1] !== jasmineMarker) {
|
|
result.push(jasmineMarker);
|
|
}
|
|
});
|
|
|
|
return result;
|
|
}
|
|
|
|
function formatProperties(error) {
|
|
if (!(error instanceof Object)) {
|
|
return;
|
|
}
|
|
|
|
const result = {};
|
|
let empty = true;
|
|
|
|
for (const prop in error) {
|
|
if (ignoredProperties.includes(prop)) {
|
|
continue;
|
|
}
|
|
result[prop] = error[prop];
|
|
empty = false;
|
|
}
|
|
|
|
if (!empty) {
|
|
return 'error properties: ' + j$.basicPrettyPrinter_(result) + '\n';
|
|
}
|
|
|
|
return '';
|
|
}
|
|
}
|
|
|
|
return ExceptionFormatter;
|
|
};
|
|
|
|
getJasmineRequireObj().Expectation = function(j$) {
|
|
/**
|
|
* Matchers that come with Jasmine out of the box.
|
|
* @namespace matchers
|
|
*/
|
|
function Expectation(options) {
|
|
this.expector = new j$.Expector(options);
|
|
|
|
const customMatchers = options.customMatchers || {};
|
|
for (const matcherName in customMatchers) {
|
|
this[matcherName] = wrapSyncCompare(
|
|
matcherName,
|
|
customMatchers[matcherName]
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Add some context for an {@link expect}
|
|
* @function
|
|
* @name matchers#withContext
|
|
* @since 3.3.0
|
|
* @param {String} message - Additional context to show when the matcher fails
|
|
* @return {matchers}
|
|
*/
|
|
Expectation.prototype.withContext = function withContext(message) {
|
|
return addFilter(this, new ContextAddingFilter(message));
|
|
};
|
|
|
|
/**
|
|
* Invert the matcher following this {@link expect}
|
|
* @member
|
|
* @name matchers#not
|
|
* @since 1.3.0
|
|
* @type {matchers}
|
|
* @example
|
|
* expect(something).not.toBe(true);
|
|
*/
|
|
Object.defineProperty(Expectation.prototype, 'not', {
|
|
get: function() {
|
|
return addFilter(this, syncNegatingFilter);
|
|
}
|
|
});
|
|
|
|
/**
|
|
* Asynchronous matchers that operate on an actual value which is a promise,
|
|
* and return a promise.
|
|
*
|
|
* Most async matchers will wait indefinitely for the promise to be resolved
|
|
* or rejected, resulting in a spec timeout if that never happens. If you
|
|
* expect that the promise will already be resolved or rejected at the time
|
|
* the matcher is called, you can use the {@link async-matchers#already}
|
|
* modifier to get a faster failure with a more helpful message.
|
|
*
|
|
* Note: Specs must await the result of each async matcher, return the
|
|
* promise returned by the matcher, or return a promise that's derived from
|
|
* the one returned by the matcher. Otherwise the matcher will not be
|
|
* evaluated before the spec completes.
|
|
*
|
|
* @example
|
|
* // Good
|
|
* await expectAsync(aPromise).toBeResolved();
|
|
* @example
|
|
* // Good
|
|
* return expectAsync(aPromise).toBeResolved();
|
|
* @example
|
|
* // Good
|
|
* return expectAsync(aPromise).toBeResolved()
|
|
* .then(function() {
|
|
* // more spec code
|
|
* });
|
|
* @example
|
|
* // Bad
|
|
* expectAsync(aPromise).toBeResolved();
|
|
* @namespace async-matchers
|
|
*/
|
|
function AsyncExpectation(options) {
|
|
this.expector = new j$.Expector(options);
|
|
|
|
const customAsyncMatchers = options.customAsyncMatchers || {};
|
|
for (const matcherName in customAsyncMatchers) {
|
|
this[matcherName] = wrapAsyncCompare(
|
|
matcherName,
|
|
customAsyncMatchers[matcherName]
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Add some context for an {@link expectAsync}
|
|
* @function
|
|
* @name async-matchers#withContext
|
|
* @since 3.3.0
|
|
* @param {String} message - Additional context to show when the async matcher fails
|
|
* @return {async-matchers}
|
|
*/
|
|
AsyncExpectation.prototype.withContext = function withContext(message) {
|
|
return addFilter(this, new ContextAddingFilter(message));
|
|
};
|
|
|
|
/**
|
|
* Invert the matcher following this {@link expectAsync}
|
|
* @member
|
|
* @name async-matchers#not
|
|
* @type {async-matchers}
|
|
* @example
|
|
* await expectAsync(myPromise).not.toBeResolved();
|
|
* @example
|
|
* return expectAsync(myPromise).not.toBeResolved();
|
|
*/
|
|
Object.defineProperty(AsyncExpectation.prototype, 'not', {
|
|
get: function() {
|
|
return addFilter(this, asyncNegatingFilter);
|
|
}
|
|
});
|
|
|
|
/**
|
|
* Fail as soon as possible if the actual is pending.
|
|
* Otherwise evaluate the matcher.
|
|
* @member
|
|
* @name async-matchers#already
|
|
* @since 3.8.0
|
|
* @type {async-matchers}
|
|
* @example
|
|
* await expectAsync(myPromise).already.toBeResolved();
|
|
* @example
|
|
* return expectAsync(myPromise).already.toBeResolved();
|
|
*/
|
|
Object.defineProperty(AsyncExpectation.prototype, 'already', {
|
|
get: function() {
|
|
return addFilter(this, expectSettledPromiseFilter);
|
|
}
|
|
});
|
|
|
|
function wrapSyncCompare(name, matcherFactory) {
|
|
return function() {
|
|
const result = this.expector.compare(name, matcherFactory, arguments);
|
|
this.expector.processResult(result);
|
|
};
|
|
}
|
|
|
|
function wrapAsyncCompare(name, matcherFactory) {
|
|
return function() {
|
|
// Capture the call stack here, before we go async, so that it will contain
|
|
// frames that are relevant to the user instead of just parts of Jasmine.
|
|
const errorForStack = j$.util.errorWithStack();
|
|
|
|
return this.expector
|
|
.compare(name, matcherFactory, arguments)
|
|
.then(result => {
|
|
this.expector.processResult(result, errorForStack);
|
|
});
|
|
};
|
|
}
|
|
|
|
function addCoreMatchers(prototype, matchers, wrapper) {
|
|
for (const matcherName in matchers) {
|
|
const matcher = matchers[matcherName];
|
|
prototype[matcherName] = wrapper(matcherName, matcher);
|
|
}
|
|
}
|
|
|
|
function addFilter(source, filter) {
|
|
const result = Object.create(source);
|
|
result.expector = source.expector.addFilter(filter);
|
|
return result;
|
|
}
|
|
|
|
function negatedFailureMessage(result, matcherName, args, matchersUtil) {
|
|
if (result.message) {
|
|
if (j$.isFunction_(result.message)) {
|
|
return result.message();
|
|
} else {
|
|
return result.message;
|
|
}
|
|
}
|
|
|
|
args = args.slice();
|
|
args.unshift(true);
|
|
args.unshift(matcherName);
|
|
return matchersUtil.buildFailureMessage.apply(matchersUtil, args);
|
|
}
|
|
|
|
function negate(result) {
|
|
result.pass = !result.pass;
|
|
return result;
|
|
}
|
|
|
|
const syncNegatingFilter = {
|
|
selectComparisonFunc: function(matcher) {
|
|
function defaultNegativeCompare() {
|
|
return negate(matcher.compare.apply(null, arguments));
|
|
}
|
|
|
|
return matcher.negativeCompare || defaultNegativeCompare;
|
|
},
|
|
buildFailureMessage: negatedFailureMessage
|
|
};
|
|
|
|
const asyncNegatingFilter = {
|
|
selectComparisonFunc: function(matcher) {
|
|
function defaultNegativeCompare() {
|
|
return matcher.compare.apply(this, arguments).then(negate);
|
|
}
|
|
|
|
return matcher.negativeCompare || defaultNegativeCompare;
|
|
},
|
|
buildFailureMessage: negatedFailureMessage
|
|
};
|
|
|
|
const expectSettledPromiseFilter = {
|
|
selectComparisonFunc: function(matcher) {
|
|
return function(actual) {
|
|
const matcherArgs = arguments;
|
|
|
|
return j$.isPending_(actual).then(function(isPending) {
|
|
if (isPending) {
|
|
return {
|
|
pass: false,
|
|
message:
|
|
'Expected a promise to be settled (via ' +
|
|
'expectAsync(...).already) but it was pending.'
|
|
};
|
|
} else {
|
|
return matcher.compare.apply(null, matcherArgs);
|
|
}
|
|
});
|
|
};
|
|
}
|
|
};
|
|
|
|
function ContextAddingFilter(message) {
|
|
this.message = message;
|
|
}
|
|
|
|
ContextAddingFilter.prototype.modifyFailureMessage = function(msg) {
|
|
if (msg.indexOf('\n') === -1) {
|
|
return this.message + ': ' + msg;
|
|
} else {
|
|
return this.message + ':\n' + indent(msg);
|
|
}
|
|
};
|
|
|
|
function indent(s) {
|
|
return s.replace(/^/gm, ' ');
|
|
}
|
|
|
|
return {
|
|
factory: function(options) {
|
|
return new Expectation(options || {});
|
|
},
|
|
addCoreMatchers: function(matchers) {
|
|
addCoreMatchers(Expectation.prototype, matchers, wrapSyncCompare);
|
|
},
|
|
asyncFactory: function(options) {
|
|
return new AsyncExpectation(options || {});
|
|
},
|
|
addAsyncCoreMatchers: function(matchers) {
|
|
addCoreMatchers(AsyncExpectation.prototype, matchers, wrapAsyncCompare);
|
|
}
|
|
};
|
|
};
|
|
|
|
getJasmineRequireObj().ExpectationFilterChain = function() {
|
|
function ExpectationFilterChain(maybeFilter, prev) {
|
|
this.filter_ = maybeFilter;
|
|
this.prev_ = prev;
|
|
}
|
|
|
|
ExpectationFilterChain.prototype.addFilter = function(filter) {
|
|
return new ExpectationFilterChain(filter, this);
|
|
};
|
|
|
|
ExpectationFilterChain.prototype.selectComparisonFunc = function(matcher) {
|
|
return this.callFirst_('selectComparisonFunc', arguments).result;
|
|
};
|
|
|
|
ExpectationFilterChain.prototype.buildFailureMessage = function(
|
|
result,
|
|
matcherName,
|
|
args,
|
|
matchersUtil
|
|
) {
|
|
return this.callFirst_('buildFailureMessage', arguments).result;
|
|
};
|
|
|
|
ExpectationFilterChain.prototype.modifyFailureMessage = function(msg) {
|
|
const result = this.callFirst_('modifyFailureMessage', arguments).result;
|
|
return result || msg;
|
|
};
|
|
|
|
ExpectationFilterChain.prototype.callFirst_ = function(fname, args) {
|
|
if (this.prev_) {
|
|
const prevResult = this.prev_.callFirst_(fname, args);
|
|
|
|
if (prevResult.found) {
|
|
return prevResult;
|
|
}
|
|
}
|
|
|
|
if (this.filter_ && this.filter_[fname]) {
|
|
return {
|
|
found: true,
|
|
result: this.filter_[fname].apply(this.filter_, args)
|
|
};
|
|
}
|
|
|
|
return { found: false };
|
|
};
|
|
|
|
return ExpectationFilterChain;
|
|
};
|
|
|
|
getJasmineRequireObj().Expector = function(j$) {
|
|
function Expector(options) {
|
|
this.matchersUtil = options.matchersUtil || {
|
|
buildFailureMessage: function() {}
|
|
};
|
|
this.actual = options.actual;
|
|
this.addExpectationResult = options.addExpectationResult || function() {};
|
|
this.filters = new j$.ExpectationFilterChain();
|
|
}
|
|
|
|
Expector.prototype.instantiateMatcher = function(
|
|
matcherName,
|
|
matcherFactory,
|
|
args
|
|
) {
|
|
this.matcherName = matcherName;
|
|
this.args = Array.prototype.slice.call(args, 0);
|
|
this.expected = this.args.slice(0);
|
|
|
|
this.args.unshift(this.actual);
|
|
|
|
const matcher = matcherFactory(this.matchersUtil);
|
|
|
|
const comparisonFunc = this.filters.selectComparisonFunc(matcher);
|
|
return comparisonFunc || matcher.compare;
|
|
};
|
|
|
|
Expector.prototype.buildMessage = function(result) {
|
|
if (result.pass) {
|
|
return '';
|
|
}
|
|
|
|
const defaultMessage = () => {
|
|
if (!result.message) {
|
|
const args = this.args.slice();
|
|
args.unshift(false);
|
|
args.unshift(this.matcherName);
|
|
return this.matchersUtil.buildFailureMessage.apply(
|
|
this.matchersUtil,
|
|
args
|
|
);
|
|
} else if (j$.isFunction_(result.message)) {
|
|
return result.message();
|
|
} else {
|
|
return result.message;
|
|
}
|
|
};
|
|
|
|
const msg = this.filters.buildFailureMessage(
|
|
result,
|
|
this.matcherName,
|
|
this.args,
|
|
this.matchersUtil,
|
|
defaultMessage
|
|
);
|
|
return this.filters.modifyFailureMessage(msg || defaultMessage());
|
|
};
|
|
|
|
Expector.prototype.compare = function(matcherName, matcherFactory, args) {
|
|
const matcherCompare = this.instantiateMatcher(
|
|
matcherName,
|
|
matcherFactory,
|
|
args
|
|
);
|
|
return matcherCompare.apply(null, this.args);
|
|
};
|
|
|
|
Expector.prototype.addFilter = function(filter) {
|
|
const result = Object.create(this);
|
|
result.filters = this.filters.addFilter(filter);
|
|
return result;
|
|
};
|
|
|
|
Expector.prototype.processResult = function(result, errorForStack) {
|
|
const message = this.buildMessage(result);
|
|
|
|
if (this.expected.length === 1) {
|
|
this.expected = this.expected[0];
|
|
}
|
|
|
|
this.addExpectationResult(result.pass, {
|
|
matcherName: this.matcherName,
|
|
passed: result.pass,
|
|
message: message,
|
|
error: errorForStack ? undefined : result.error,
|
|
errorForStack: errorForStack || undefined,
|
|
actual: this.actual,
|
|
expected: this.expected // TODO: this may need to be arrayified/sliced
|
|
});
|
|
};
|
|
|
|
return Expector;
|
|
};
|
|
|
|
getJasmineRequireObj().formatErrorMsg = function() {
|
|
function generateErrorMsg(domain, usage) {
|
|
const usageDefinition = usage ? '\nUsage: ' + usage : '';
|
|
|
|
return function errorMsg(msg) {
|
|
return domain + ' : ' + msg + usageDefinition;
|
|
};
|
|
}
|
|
|
|
return generateErrorMsg;
|
|
};
|
|
|
|
getJasmineRequireObj().GlobalErrors = function(j$) {
|
|
function GlobalErrors(global) {
|
|
global = global || j$.getGlobal();
|
|
|
|
const handlers = [];
|
|
let overrideHandler = null,
|
|
onRemoveOverrideHandler = null;
|
|
|
|
function onerror(message, source, lineno, colno, error) {
|
|
if (overrideHandler) {
|
|
overrideHandler(error || message);
|
|
return;
|
|
}
|
|
|
|
const handler = handlers[handlers.length - 1];
|
|
|
|
if (handler) {
|
|
handler.apply(null, Array.prototype.slice.call(arguments, 0));
|
|
} else {
|
|
throw arguments[0];
|
|
}
|
|
}
|
|
|
|
this.originalHandlers = {};
|
|
this.jasmineHandlers = {};
|
|
this.installOne_ = function installOne_(errorType, jasmineMessage) {
|
|
function taggedOnError(error) {
|
|
if (j$.isError_(error)) {
|
|
error.jasmineMessage = jasmineMessage + ': ' + error;
|
|
} else {
|
|
let substituteMsg;
|
|
|
|
if (error) {
|
|
substituteMsg = jasmineMessage + ': ' + error;
|
|
} else {
|
|
substituteMsg = jasmineMessage + ' with no error or message';
|
|
}
|
|
|
|
if (errorType === 'unhandledRejection') {
|
|
substituteMsg +=
|
|
'\n' +
|
|
'(Tip: to get a useful stack trace, use ' +
|
|
'Promise.reject(new Error(...)) instead of Promise.reject(' +
|
|
(error ? '...' : '') +
|
|
').)';
|
|
}
|
|
|
|
error = new Error(substituteMsg);
|
|
}
|
|
|
|
const handler = handlers[handlers.length - 1];
|
|
|
|
if (overrideHandler) {
|
|
overrideHandler(error);
|
|
return;
|
|
}
|
|
|
|
if (handler) {
|
|
handler(error);
|
|
} else {
|
|
throw error;
|
|
}
|
|
}
|
|
|
|
this.originalHandlers[errorType] = global.process.listeners(errorType);
|
|
this.jasmineHandlers[errorType] = taggedOnError;
|
|
|
|
global.process.removeAllListeners(errorType);
|
|
global.process.on(errorType, taggedOnError);
|
|
|
|
this.uninstall = function uninstall() {
|
|
const errorTypes = Object.keys(this.originalHandlers);
|
|
for (const errorType of errorTypes) {
|
|
global.process.removeListener(
|
|
errorType,
|
|
this.jasmineHandlers[errorType]
|
|
);
|
|
|
|
for (let i = 0; i < this.originalHandlers[errorType].length; i++) {
|
|
global.process.on(errorType, this.originalHandlers[errorType][i]);
|
|
}
|
|
delete this.originalHandlers[errorType];
|
|
delete this.jasmineHandlers[errorType];
|
|
}
|
|
};
|
|
};
|
|
|
|
this.install = function install() {
|
|
if (
|
|
global.process &&
|
|
global.process.listeners &&
|
|
j$.isFunction_(global.process.on)
|
|
) {
|
|
this.installOne_('uncaughtException', 'Uncaught exception');
|
|
this.installOne_('unhandledRejection', 'Unhandled promise rejection');
|
|
} else {
|
|
const originalHandler = global.onerror;
|
|
global.onerror = onerror;
|
|
|
|
const browserRejectionHandler = function browserRejectionHandler(
|
|
event
|
|
) {
|
|
if (j$.isError_(event.reason)) {
|
|
event.reason.jasmineMessage =
|
|
'Unhandled promise rejection: ' + event.reason;
|
|
global.onerror(event.reason);
|
|
} else {
|
|
global.onerror('Unhandled promise rejection: ' + event.reason);
|
|
}
|
|
};
|
|
|
|
global.addEventListener('unhandledrejection', browserRejectionHandler);
|
|
|
|
this.uninstall = function uninstall() {
|
|
global.onerror = originalHandler;
|
|
global.removeEventListener(
|
|
'unhandledrejection',
|
|
browserRejectionHandler
|
|
);
|
|
};
|
|
}
|
|
};
|
|
|
|
this.pushListener = function pushListener(listener) {
|
|
handlers.push(listener);
|
|
};
|
|
|
|
this.popListener = function popListener(listener) {
|
|
if (!listener) {
|
|
throw new Error('popListener expects a listener');
|
|
}
|
|
|
|
handlers.pop();
|
|
};
|
|
|
|
this.setOverrideListener = function(listener, onRemove) {
|
|
if (overrideHandler) {
|
|
throw new Error("Can't set more than one override listener at a time");
|
|
}
|
|
|
|
overrideHandler = listener;
|
|
onRemoveOverrideHandler = onRemove;
|
|
};
|
|
|
|
this.removeOverrideListener = function() {
|
|
if (onRemoveOverrideHandler) {
|
|
onRemoveOverrideHandler();
|
|
}
|
|
|
|
overrideHandler = null;
|
|
onRemoveOverrideHandler = null;
|
|
};
|
|
}
|
|
|
|
return GlobalErrors;
|
|
};
|
|
|
|
getJasmineRequireObj().toBePending = function(j$) {
|
|
/**
|
|
* Expect a promise to be pending, i.e. the promise is neither resolved nor rejected.
|
|
* @function
|
|
* @async
|
|
* @name async-matchers#toBePending
|
|
* @since 3.6
|
|
* @example
|
|
* await expectAsync(aPromise).toBePending();
|
|
*/
|
|
return function toBePending() {
|
|
return {
|
|
compare: function(actual) {
|
|
if (!j$.isPromiseLike(actual)) {
|
|
throw new Error('Expected toBePending to be called on a promise.');
|
|
}
|
|
const want = {};
|
|
return Promise.race([actual, Promise.resolve(want)]).then(
|
|
function(got) {
|
|
return { pass: want === got };
|
|
},
|
|
function() {
|
|
return { pass: false };
|
|
}
|
|
);
|
|
}
|
|
};
|
|
};
|
|
};
|
|
|
|
getJasmineRequireObj().toBeRejected = function(j$) {
|
|
/**
|
|
* Expect a promise to be rejected.
|
|
* @function
|
|
* @async
|
|
* @name async-matchers#toBeRejected
|
|
* @since 3.1.0
|
|
* @example
|
|
* await expectAsync(aPromise).toBeRejected();
|
|
* @example
|
|
* return expectAsync(aPromise).toBeRejected();
|
|
*/
|
|
return function toBeRejected() {
|
|
return {
|
|
compare: function(actual) {
|
|
if (!j$.isPromiseLike(actual)) {
|
|
throw new Error('Expected toBeRejected to be called on a promise.');
|
|
}
|
|
return actual.then(
|
|
function() {
|
|
return { pass: false };
|
|
},
|
|
function() {
|
|
return { pass: true };
|
|
}
|
|
);
|
|
}
|
|
};
|
|
};
|
|
};
|
|
|
|
getJasmineRequireObj().toBeRejectedWith = function(j$) {
|
|
/**
|
|
* Expect a promise to be rejected with a value equal to the expected, using deep equality comparison.
|
|
* @function
|
|
* @async
|
|
* @name async-matchers#toBeRejectedWith
|
|
* @since 3.3.0
|
|
* @param {Object} expected - Value that the promise is expected to be rejected with
|
|
* @example
|
|
* await expectAsync(aPromise).toBeRejectedWith({prop: 'value'});
|
|
* @example
|
|
* return expectAsync(aPromise).toBeRejectedWith({prop: 'value'});
|
|
*/
|
|
return function toBeRejectedWith(matchersUtil) {
|
|
return {
|
|
compare: function(actualPromise, expectedValue) {
|
|
if (!j$.isPromiseLike(actualPromise)) {
|
|
throw new Error(
|
|
'Expected toBeRejectedWith to be called on a promise.'
|
|
);
|
|
}
|
|
|
|
function prefix(passed) {
|
|
return (
|
|
'Expected a promise ' +
|
|
(passed ? 'not ' : '') +
|
|
'to be rejected with ' +
|
|
matchersUtil.pp(expectedValue)
|
|
);
|
|
}
|
|
|
|
return actualPromise.then(
|
|
function() {
|
|
return {
|
|
pass: false,
|
|
message: prefix(false) + ' but it was resolved.'
|
|
};
|
|
},
|
|
function(actualValue) {
|
|
if (matchersUtil.equals(actualValue, expectedValue)) {
|
|
return {
|
|
pass: true,
|
|
message: prefix(true) + '.'
|
|
};
|
|
} else {
|
|
return {
|
|
pass: false,
|
|
message:
|
|
prefix(false) +
|
|
' but it was rejected with ' +
|
|
matchersUtil.pp(actualValue) +
|
|
'.'
|
|
};
|
|
}
|
|
}
|
|
);
|
|
}
|
|
};
|
|
};
|
|
};
|
|
|
|
getJasmineRequireObj().toBeRejectedWithError = function(j$) {
|
|
/**
|
|
* Expect a promise to be rejected with a value matched to the expected
|
|
* @function
|
|
* @async
|
|
* @name async-matchers#toBeRejectedWithError
|
|
* @since 3.5.0
|
|
* @param {Error} [expected] - `Error` constructor the object that was thrown needs to be an instance of. If not provided, `Error` will be used.
|
|
* @param {RegExp|String} [message] - The message that should be set on the thrown `Error`
|
|
* @example
|
|
* await expectAsync(aPromise).toBeRejectedWithError(MyCustomError, 'Error message');
|
|
* await expectAsync(aPromise).toBeRejectedWithError(MyCustomError, /Error message/);
|
|
* await expectAsync(aPromise).toBeRejectedWithError(MyCustomError);
|
|
* await expectAsync(aPromise).toBeRejectedWithError('Error message');
|
|
* return expectAsync(aPromise).toBeRejectedWithError(/Error message/);
|
|
*/
|
|
return function toBeRejectedWithError(matchersUtil) {
|
|
return {
|
|
compare: function(actualPromise, arg1, arg2) {
|
|
if (!j$.isPromiseLike(actualPromise)) {
|
|
throw new Error(
|
|
'Expected toBeRejectedWithError to be called on a promise.'
|
|
);
|
|
}
|
|
|
|
const expected = getExpectedFromArgs(arg1, arg2, matchersUtil);
|
|
|
|
return actualPromise.then(
|
|
function() {
|
|
return {
|
|
pass: false,
|
|
message: 'Expected a promise to be rejected but it was resolved.'
|
|
};
|
|
},
|
|
function(actualValue) {
|
|
return matchError(actualValue, expected, matchersUtil);
|
|
}
|
|
);
|
|
}
|
|
};
|
|
};
|
|
|
|
function matchError(actual, expected, matchersUtil) {
|
|
if (!j$.isError_(actual)) {
|
|
return fail(expected, 'rejected with ' + matchersUtil.pp(actual));
|
|
}
|
|
|
|
if (!(actual instanceof expected.error)) {
|
|
return fail(
|
|
expected,
|
|
'rejected with type ' + j$.fnNameFor(actual.constructor)
|
|
);
|
|
}
|
|
|
|
const actualMessage = actual.message;
|
|
|
|
if (
|
|
actualMessage === expected.message ||
|
|
typeof expected.message === 'undefined'
|
|
) {
|
|
return pass(expected);
|
|
}
|
|
|
|
if (
|
|
expected.message instanceof RegExp &&
|
|
expected.message.test(actualMessage)
|
|
) {
|
|
return pass(expected);
|
|
}
|
|
|
|
return fail(expected, 'rejected with ' + matchersUtil.pp(actual));
|
|
}
|
|
|
|
function pass(expected) {
|
|
return {
|
|
pass: true,
|
|
message:
|
|
'Expected a promise not to be rejected with ' +
|
|
expected.printValue +
|
|
', but it was.'
|
|
};
|
|
}
|
|
|
|
function fail(expected, message) {
|
|
return {
|
|
pass: false,
|
|
message:
|
|
'Expected a promise to be rejected with ' +
|
|
expected.printValue +
|
|
' but it was ' +
|
|
message +
|
|
'.'
|
|
};
|
|
}
|
|
|
|
function getExpectedFromArgs(arg1, arg2, matchersUtil) {
|
|
let error, message;
|
|
|
|
if (isErrorConstructor(arg1)) {
|
|
error = arg1;
|
|
message = arg2;
|
|
} else {
|
|
error = Error;
|
|
message = arg1;
|
|
}
|
|
|
|
return {
|
|
error: error,
|
|
message: message,
|
|
printValue:
|
|
j$.fnNameFor(error) +
|
|
(typeof message === 'undefined' ? '' : ': ' + matchersUtil.pp(message))
|
|
};
|
|
}
|
|
|
|
function isErrorConstructor(value) {
|
|
return (
|
|
typeof value === 'function' &&
|
|
(value === Error || j$.isError_(value.prototype))
|
|
);
|
|
}
|
|
};
|
|
|
|
getJasmineRequireObj().toBeResolved = function(j$) {
|
|
/**
|
|
* Expect a promise to be resolved.
|
|
* @function
|
|
* @async
|
|
* @name async-matchers#toBeResolved
|
|
* @since 3.1.0
|
|
* @example
|
|
* await expectAsync(aPromise).toBeResolved();
|
|
* @example
|
|
* return expectAsync(aPromise).toBeResolved();
|
|
*/
|
|
return function toBeResolved(matchersUtil) {
|
|
return {
|
|
compare: function(actual) {
|
|
if (!j$.isPromiseLike(actual)) {
|
|
throw new Error('Expected toBeResolved to be called on a promise.');
|
|
}
|
|
|
|
return actual.then(
|
|
function() {
|
|
return { pass: true };
|
|
},
|
|
function(e) {
|
|
return {
|
|
pass: false,
|
|
message:
|
|
'Expected a promise to be resolved but it was ' +
|
|
'rejected with ' +
|
|
matchersUtil.pp(e) +
|
|
'.'
|
|
};
|
|
}
|
|
);
|
|
}
|
|
};
|
|
};
|
|
};
|
|
|
|
getJasmineRequireObj().toBeResolvedTo = function(j$) {
|
|
/**
|
|
* Expect a promise to be resolved to a value equal to the expected, using deep equality comparison.
|
|
* @function
|
|
* @async
|
|
* @name async-matchers#toBeResolvedTo
|
|
* @since 3.1.0
|
|
* @param {Object} expected - Value that the promise is expected to resolve to
|
|
* @example
|
|
* await expectAsync(aPromise).toBeResolvedTo({prop: 'value'});
|
|
* @example
|
|
* return expectAsync(aPromise).toBeResolvedTo({prop: 'value'});
|
|
*/
|
|
return function toBeResolvedTo(matchersUtil) {
|
|
return {
|
|
compare: function(actualPromise, expectedValue) {
|
|
if (!j$.isPromiseLike(actualPromise)) {
|
|
throw new Error('Expected toBeResolvedTo to be called on a promise.');
|
|
}
|
|
|
|
function prefix(passed) {
|
|
return (
|
|
'Expected a promise ' +
|
|
(passed ? 'not ' : '') +
|
|
'to be resolved to ' +
|
|
matchersUtil.pp(expectedValue)
|
|
);
|
|
}
|
|
|
|
return actualPromise.then(
|
|
function(actualValue) {
|
|
if (matchersUtil.equals(actualValue, expectedValue)) {
|
|
return {
|
|
pass: true,
|
|
message: prefix(true) + '.'
|
|
};
|
|
} else {
|
|
return {
|
|
pass: false,
|
|
message:
|
|
prefix(false) +
|
|
' but it was resolved to ' +
|
|
matchersUtil.pp(actualValue) +
|
|
'.'
|
|
};
|
|
}
|
|
},
|
|
function(e) {
|
|
return {
|
|
pass: false,
|
|
message:
|
|
prefix(false) +
|
|
' but it was rejected with ' +
|
|
matchersUtil.pp(e) +
|
|
'.'
|
|
};
|
|
}
|
|
);
|
|
}
|
|
};
|
|
};
|
|
};
|
|
|
|
getJasmineRequireObj().DiffBuilder = function(j$) {
|
|
class DiffBuilder {
|
|
constructor(config) {
|
|
this.prettyPrinter_ =
|
|
(config || {}).prettyPrinter || j$.makePrettyPrinter();
|
|
this.mismatches_ = new j$.MismatchTree();
|
|
this.path_ = new j$.ObjectPath();
|
|
this.actualRoot_ = undefined;
|
|
this.expectedRoot_ = undefined;
|
|
}
|
|
|
|
setRoots(actual, expected) {
|
|
this.actualRoot_ = actual;
|
|
this.expectedRoot_ = expected;
|
|
}
|
|
|
|
recordMismatch(formatter) {
|
|
this.mismatches_.add(this.path_, formatter);
|
|
}
|
|
|
|
getMessage() {
|
|
const messages = [];
|
|
|
|
this.mismatches_.traverse((path, isLeaf, formatter) => {
|
|
const { actual, expected } = this.dereferencePath_(path);
|
|
|
|
if (formatter) {
|
|
messages.push(formatter(actual, expected, path, this.prettyPrinter_));
|
|
return true;
|
|
}
|
|
|
|
const actualCustom = this.prettyPrinter_.customFormat_(actual);
|
|
const expectedCustom = this.prettyPrinter_.customFormat_(expected);
|
|
const useCustom = !(
|
|
j$.util.isUndefined(actualCustom) &&
|
|
j$.util.isUndefined(expectedCustom)
|
|
);
|
|
|
|
if (useCustom) {
|
|
messages.push(wrapPrettyPrinted(actualCustom, expectedCustom, path));
|
|
return false; // don't recurse further
|
|
}
|
|
|
|
if (isLeaf) {
|
|
messages.push(this.defaultFormatter_(actual, expected, path));
|
|
}
|
|
|
|
return true;
|
|
});
|
|
|
|
return messages.join('\n');
|
|
}
|
|
|
|
withPath(pathComponent, block) {
|
|
const oldPath = this.path_;
|
|
this.path_ = this.path_.add(pathComponent);
|
|
block();
|
|
this.path_ = oldPath;
|
|
}
|
|
|
|
dereferencePath_(objectPath) {
|
|
let actual = this.actualRoot_;
|
|
let expected = this.expectedRoot_;
|
|
|
|
const handleAsymmetricExpected = () => {
|
|
if (
|
|
j$.isAsymmetricEqualityTester_(expected) &&
|
|
j$.isFunction_(expected.valuesForDiff_)
|
|
) {
|
|
const asymmetricResult = expected.valuesForDiff_(
|
|
actual,
|
|
this.prettyPrinter_
|
|
);
|
|
expected = asymmetricResult.self;
|
|
actual = asymmetricResult.other;
|
|
}
|
|
};
|
|
|
|
handleAsymmetricExpected();
|
|
|
|
for (const pc of objectPath.components) {
|
|
actual = actual[pc];
|
|
expected = expected[pc];
|
|
handleAsymmetricExpected();
|
|
}
|
|
|
|
return { actual: actual, expected: expected };
|
|
}
|
|
|
|
defaultFormatter_(actual, expected, path) {
|
|
return wrapPrettyPrinted(
|
|
this.prettyPrinter_(actual),
|
|
this.prettyPrinter_(expected),
|
|
path
|
|
);
|
|
}
|
|
}
|
|
|
|
function wrapPrettyPrinted(actual, expected, path) {
|
|
return (
|
|
'Expected ' +
|
|
path +
|
|
(path.depth() ? ' = ' : '') +
|
|
actual +
|
|
' to equal ' +
|
|
expected +
|
|
'.'
|
|
);
|
|
}
|
|
|
|
return DiffBuilder;
|
|
};
|
|
|
|
getJasmineRequireObj().MatchersUtil = function(j$) {
|
|
/**
|
|
* @class MatchersUtil
|
|
* @classdesc Utilities for use in implementing matchers.<br>
|
|
* _Note:_ Do not construct this directly. Jasmine will construct one and
|
|
* pass it to matchers and asymmetric equality testers.
|
|
* @hideconstructor
|
|
*/
|
|
function MatchersUtil(options) {
|
|
options = options || {};
|
|
this.customTesters_ = options.customTesters || [];
|
|
/**
|
|
* Formats a value for use in matcher failure messages and similar contexts,
|
|
* taking into account the current set of custom value formatters.
|
|
* @function
|
|
* @name MatchersUtil#pp
|
|
* @since 3.6.0
|
|
* @param {*} value The value to pretty-print
|
|
* @return {string} The pretty-printed value
|
|
*/
|
|
this.pp = options.pp || function() {};
|
|
}
|
|
|
|
/**
|
|
* Determines whether `haystack` contains `needle`, using the same comparison
|
|
* logic as {@link MatchersUtil#equals}.
|
|
* @function
|
|
* @name MatchersUtil#contains
|
|
* @since 2.0.0
|
|
* @param {*} haystack The collection to search
|
|
* @param {*} needle The value to search for
|
|
* @returns {boolean} True if `needle` was found in `haystack`
|
|
*/
|
|
MatchersUtil.prototype.contains = function(haystack, needle) {
|
|
if (!haystack) {
|
|
return false;
|
|
}
|
|
|
|
if (j$.isSet(haystack)) {
|
|
// Try .has() first. It should be faster in cases where
|
|
// needle === something in haystack. Fall back to .equals() comparison
|
|
// if that fails.
|
|
if (haystack.has(needle)) {
|
|
return true;
|
|
}
|
|
}
|
|
|
|
if (j$.isIterable_(haystack) && !j$.isString_(haystack)) {
|
|
// Arrays, Sets, etc.
|
|
for (const candidate of haystack) {
|
|
if (this.equals(candidate, needle)) {
|
|
return true;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
if (haystack.indexOf) {
|
|
// Mainly strings
|
|
return haystack.indexOf(needle) >= 0;
|
|
}
|
|
|
|
if (j$.isNumber_(haystack.length)) {
|
|
// Objects that are shaped like arrays but aren't iterable
|
|
for (let i = 0; i < haystack.length; i++) {
|
|
if (this.equals(haystack[i], needle)) {
|
|
return true;
|
|
}
|
|
}
|
|
}
|
|
|
|
return false;
|
|
};
|
|
|
|
MatchersUtil.prototype.buildFailureMessage = function() {
|
|
const args = Array.prototype.slice.call(arguments, 0),
|
|
matcherName = args[0],
|
|
isNot = args[1],
|
|
actual = args[2],
|
|
expected = args.slice(3),
|
|
englishyPredicate = matcherName.replace(/[A-Z]/g, function(s) {
|
|
return ' ' + s.toLowerCase();
|
|
});
|
|
|
|
let message =
|
|
'Expected ' +
|
|
this.pp(actual) +
|
|
(isNot ? ' not ' : ' ') +
|
|
englishyPredicate;
|
|
|
|
if (expected.length > 0) {
|
|
for (let i = 0; i < expected.length; i++) {
|
|
if (i > 0) {
|
|
message += ',';
|
|
}
|
|
message += ' ' + this.pp(expected[i]);
|
|
}
|
|
}
|
|
|
|
return message + '.';
|
|
};
|
|
|
|
MatchersUtil.prototype.asymmetricDiff_ = function(
|
|
a,
|
|
b,
|
|
aStack,
|
|
bStack,
|
|
diffBuilder
|
|
) {
|
|
if (j$.isFunction_(b.valuesForDiff_)) {
|
|
const values = b.valuesForDiff_(a, this.pp);
|
|
this.eq_(values.other, values.self, aStack, bStack, diffBuilder);
|
|
} else {
|
|
diffBuilder.recordMismatch();
|
|
}
|
|
};
|
|
|
|
MatchersUtil.prototype.asymmetricMatch_ = function(
|
|
a,
|
|
b,
|
|
aStack,
|
|
bStack,
|
|
diffBuilder
|
|
) {
|
|
const asymmetricA = j$.isAsymmetricEqualityTester_(a);
|
|
const asymmetricB = j$.isAsymmetricEqualityTester_(b);
|
|
|
|
if (asymmetricA === asymmetricB) {
|
|
return undefined;
|
|
}
|
|
|
|
let result;
|
|
|
|
if (asymmetricA) {
|
|
result = a.asymmetricMatch(b, this);
|
|
if (!result) {
|
|
diffBuilder.recordMismatch();
|
|
}
|
|
return result;
|
|
}
|
|
|
|
if (asymmetricB) {
|
|
result = b.asymmetricMatch(a, this);
|
|
if (!result) {
|
|
this.asymmetricDiff_(a, b, aStack, bStack, diffBuilder);
|
|
}
|
|
return result;
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Determines whether two values are deeply equal to each other.
|
|
* @function
|
|
* @name MatchersUtil#equals
|
|
* @since 2.0.0
|
|
* @param {*} a The first value to compare
|
|
* @param {*} b The second value to compare
|
|
* @returns {boolean} True if the values are equal
|
|
*/
|
|
MatchersUtil.prototype.equals = function(a, b, diffBuilder) {
|
|
diffBuilder = diffBuilder || j$.NullDiffBuilder();
|
|
diffBuilder.setRoots(a, b);
|
|
|
|
return this.eq_(a, b, [], [], diffBuilder);
|
|
};
|
|
|
|
// Equality function lovingly adapted from isEqual in
|
|
// [Underscore](http://underscorejs.org)
|
|
MatchersUtil.prototype.eq_ = function(a, b, aStack, bStack, diffBuilder) {
|
|
let result = true;
|
|
|
|
const asymmetricResult = this.asymmetricMatch_(
|
|
a,
|
|
b,
|
|
aStack,
|
|
bStack,
|
|
diffBuilder
|
|
);
|
|
if (!j$.util.isUndefined(asymmetricResult)) {
|
|
return asymmetricResult;
|
|
}
|
|
|
|
for (const tester of this.customTesters_) {
|
|
const customTesterResult = tester(a, b);
|
|
if (!j$.util.isUndefined(customTesterResult)) {
|
|
if (!customTesterResult) {
|
|
diffBuilder.recordMismatch();
|
|
}
|
|
return customTesterResult;
|
|
}
|
|
}
|
|
|
|
if (a instanceof Error && b instanceof Error) {
|
|
result = a.message == b.message;
|
|
if (!result) {
|
|
diffBuilder.recordMismatch();
|
|
}
|
|
return result;
|
|
}
|
|
|
|
// Identical objects are equal. `0 === -0`, but they aren't identical.
|
|
// See the [Harmony `egal` proposal](http://wiki.ecmascript.org/doku.php?id=harmony:egal).
|
|
if (a === b) {
|
|
result = a !== 0 || 1 / a == 1 / b;
|
|
if (!result) {
|
|
diffBuilder.recordMismatch();
|
|
}
|
|
return result;
|
|
}
|
|
// A strict comparison is necessary because `null == undefined`.
|
|
if (a === null || b === null) {
|
|
result = a === b;
|
|
if (!result) {
|
|
diffBuilder.recordMismatch();
|
|
}
|
|
return result;
|
|
}
|
|
const className = Object.prototype.toString.call(a);
|
|
if (className != Object.prototype.toString.call(b)) {
|
|
diffBuilder.recordMismatch();
|
|
return false;
|
|
}
|
|
switch (className) {
|
|
// Strings, numbers, dates, and booleans are compared by value.
|
|
case '[object String]':
|
|
// Primitives and their corresponding object wrappers are equivalent; thus, `"5"` is
|
|
// equivalent to `new String("5")`.
|
|
result = a == String(b);
|
|
if (!result) {
|
|
diffBuilder.recordMismatch();
|
|
}
|
|
return result;
|
|
case '[object Number]':
|
|
// `NaN`s are equivalent, but non-reflexive. An `egal` comparison is performed for
|
|
// other numeric values.
|
|
result =
|
|
a != +a ? b != +b : a === 0 && b === 0 ? 1 / a == 1 / b : a == +b;
|
|
if (!result) {
|
|
diffBuilder.recordMismatch();
|
|
}
|
|
return result;
|
|
case '[object Date]':
|
|
case '[object Boolean]':
|
|
// Coerce dates and booleans to numeric primitive values. Dates are compared by their
|
|
// millisecond representations. Note that invalid dates with millisecond representations
|
|
// of `NaN` are not equivalent.
|
|
result = +a == +b;
|
|
if (!result) {
|
|
diffBuilder.recordMismatch();
|
|
}
|
|
return result;
|
|
case '[object ArrayBuffer]':
|
|
// If we have an instance of ArrayBuffer the Uint8Array ctor
|
|
// will be defined as well
|
|
return this.eq_(
|
|
new Uint8Array(a),
|
|
new Uint8Array(b),
|
|
aStack,
|
|
bStack,
|
|
diffBuilder
|
|
);
|
|
// RegExps are compared by their source patterns and flags.
|
|
case '[object RegExp]':
|
|
return (
|
|
a.source == b.source &&
|
|
a.global == b.global &&
|
|
a.multiline == b.multiline &&
|
|
a.ignoreCase == b.ignoreCase
|
|
);
|
|
}
|
|
if (typeof a != 'object' || typeof b != 'object') {
|
|
diffBuilder.recordMismatch();
|
|
return false;
|
|
}
|
|
|
|
const aIsDomNode = j$.isDomNode(a);
|
|
const bIsDomNode = j$.isDomNode(b);
|
|
if (aIsDomNode && bIsDomNode) {
|
|
// At first try to use DOM3 method isEqualNode
|
|
result = a.isEqualNode(b);
|
|
if (!result) {
|
|
diffBuilder.recordMismatch();
|
|
}
|
|
return result;
|
|
}
|
|
if (aIsDomNode || bIsDomNode) {
|
|
diffBuilder.recordMismatch();
|
|
return false;
|
|
}
|
|
|
|
const aIsPromise = j$.isPromise(a);
|
|
const bIsPromise = j$.isPromise(b);
|
|
if (aIsPromise && bIsPromise) {
|
|
return a === b;
|
|
}
|
|
|
|
// Assume equality for cyclic structures. The algorithm for detecting cyclic
|
|
// structures is adapted from ES 5.1 section 15.12.3, abstract operation `JO`.
|
|
let length = aStack.length;
|
|
while (length--) {
|
|
// Linear search. Performance is inversely proportional to the number of
|
|
// unique nested structures.
|
|
if (aStack[length] == a) {
|
|
return bStack[length] == b;
|
|
}
|
|
}
|
|
// Add the first object to the stack of traversed objects.
|
|
aStack.push(a);
|
|
bStack.push(b);
|
|
let size = 0;
|
|
// Recursively compare objects and arrays.
|
|
// Compare array lengths to determine if a deep comparison is necessary.
|
|
if (className == '[object Array]') {
|
|
const aLength = a.length;
|
|
const bLength = b.length;
|
|
|
|
diffBuilder.withPath('length', function() {
|
|
if (aLength !== bLength) {
|
|
diffBuilder.recordMismatch();
|
|
result = false;
|
|
}
|
|
});
|
|
|
|
for (let i = 0; i < aLength || i < bLength; i++) {
|
|
diffBuilder.withPath(i, () => {
|
|
if (i >= bLength) {
|
|
diffBuilder.recordMismatch(
|
|
actualArrayIsLongerFormatter.bind(null, this.pp)
|
|
);
|
|
result = false;
|
|
} else {
|
|
result =
|
|
this.eq_(
|
|
i < aLength ? a[i] : void 0,
|
|
i < bLength ? b[i] : void 0,
|
|
aStack,
|
|
bStack,
|
|
diffBuilder
|
|
) && result;
|
|
}
|
|
});
|
|
}
|
|
if (!result) {
|
|
return false;
|
|
}
|
|
} else if (j$.isMap(a) && j$.isMap(b)) {
|
|
if (a.size != b.size) {
|
|
diffBuilder.recordMismatch();
|
|
return false;
|
|
}
|
|
|
|
const keysA = [];
|
|
const keysB = [];
|
|
a.forEach(function(valueA, keyA) {
|
|
keysA.push(keyA);
|
|
});
|
|
b.forEach(function(valueB, keyB) {
|
|
keysB.push(keyB);
|
|
});
|
|
|
|
// For both sets of keys, check they map to equal values in both maps.
|
|
// Keep track of corresponding keys (in insertion order) in order to handle asymmetric obj keys.
|
|
const mapKeys = [keysA, keysB];
|
|
const cmpKeys = [keysB, keysA];
|
|
for (let i = 0; result && i < mapKeys.length; i++) {
|
|
const mapIter = mapKeys[i];
|
|
const cmpIter = cmpKeys[i];
|
|
|
|
for (let j = 0; result && j < mapIter.length; j++) {
|
|
const mapKey = mapIter[j];
|
|
const cmpKey = cmpIter[j];
|
|
const mapValueA = a.get(mapKey);
|
|
let mapValueB;
|
|
|
|
// Only use the cmpKey when one of the keys is asymmetric and the corresponding key matches,
|
|
// otherwise explicitly look up the mapKey in the other Map since we want keys with unique
|
|
// obj identity (that are otherwise equal) to not match.
|
|
if (
|
|
j$.isAsymmetricEqualityTester_(mapKey) ||
|
|
(j$.isAsymmetricEqualityTester_(cmpKey) &&
|
|
this.eq_(mapKey, cmpKey, aStack, bStack, j$.NullDiffBuilder()))
|
|
) {
|
|
mapValueB = b.get(cmpKey);
|
|
} else {
|
|
mapValueB = b.get(mapKey);
|
|
}
|
|
result = this.eq_(
|
|
mapValueA,
|
|
mapValueB,
|
|
aStack,
|
|
bStack,
|
|
j$.NullDiffBuilder()
|
|
);
|
|
}
|
|
}
|
|
|
|
if (!result) {
|
|
diffBuilder.recordMismatch();
|
|
return false;
|
|
}
|
|
} else if (j$.isSet(a) && j$.isSet(b)) {
|
|
if (a.size != b.size) {
|
|
diffBuilder.recordMismatch();
|
|
return false;
|
|
}
|
|
|
|
const valuesA = [];
|
|
a.forEach(function(valueA) {
|
|
valuesA.push(valueA);
|
|
});
|
|
const valuesB = [];
|
|
b.forEach(function(valueB) {
|
|
valuesB.push(valueB);
|
|
});
|
|
|
|
// For both sets, check they are all contained in the other set
|
|
const setPairs = [[valuesA, valuesB], [valuesB, valuesA]];
|
|
const stackPairs = [[aStack, bStack], [bStack, aStack]];
|
|
for (let i = 0; result && i < setPairs.length; i++) {
|
|
const baseValues = setPairs[i][0];
|
|
const otherValues = setPairs[i][1];
|
|
const baseStack = stackPairs[i][0];
|
|
const otherStack = stackPairs[i][1];
|
|
// For each value in the base set...
|
|
for (const baseValue of baseValues) {
|
|
let found = false;
|
|
// ... test that it is present in the other set
|
|
for (let j = 0; !found && j < otherValues.length; j++) {
|
|
const otherValue = otherValues[j];
|
|
const prevStackSize = baseStack.length;
|
|
// compare by value equality
|
|
found = this.eq_(
|
|
baseValue,
|
|
otherValue,
|
|
baseStack,
|
|
otherStack,
|
|
j$.NullDiffBuilder()
|
|
);
|
|
if (!found && prevStackSize !== baseStack.length) {
|
|
baseStack.splice(prevStackSize);
|
|
otherStack.splice(prevStackSize);
|
|
}
|
|
}
|
|
result = result && found;
|
|
}
|
|
}
|
|
|
|
if (!result) {
|
|
diffBuilder.recordMismatch();
|
|
return false;
|
|
}
|
|
} else if (j$.isURL(a) && j$.isURL(b)) {
|
|
// URLs have no enumrable properties, so the default object comparison
|
|
// would consider any two URLs to be equal.
|
|
return a.toString() === b.toString();
|
|
} else {
|
|
// Objects with different constructors are not equivalent, but `Object`s
|
|
// or `Array`s from different frames are.
|
|
const aCtor = a.constructor,
|
|
bCtor = b.constructor;
|
|
if (
|
|
aCtor !== bCtor &&
|
|
isFunction(aCtor) &&
|
|
isFunction(bCtor) &&
|
|
a instanceof aCtor &&
|
|
b instanceof bCtor &&
|
|
!(aCtor instanceof aCtor && bCtor instanceof bCtor)
|
|
) {
|
|
diffBuilder.recordMismatch(
|
|
constructorsAreDifferentFormatter.bind(null, this.pp)
|
|
);
|
|
return false;
|
|
}
|
|
}
|
|
|
|
// Deep compare objects.
|
|
const aKeys = MatchersUtil.keys(a, className == '[object Array]');
|
|
size = aKeys.length;
|
|
|
|
// Ensure that both objects contain the same number of properties before comparing deep equality.
|
|
if (MatchersUtil.keys(b, className == '[object Array]').length !== size) {
|
|
diffBuilder.recordMismatch(
|
|
objectKeysAreDifferentFormatter.bind(null, this.pp)
|
|
);
|
|
return false;
|
|
}
|
|
|
|
for (const key of aKeys) {
|
|
// Deep compare each member
|
|
if (!j$.util.has(b, key)) {
|
|
diffBuilder.recordMismatch(
|
|
objectKeysAreDifferentFormatter.bind(null, this.pp)
|
|
);
|
|
result = false;
|
|
continue;
|
|
}
|
|
|
|
diffBuilder.withPath(key, () => {
|
|
if (!this.eq_(a[key], b[key], aStack, bStack, diffBuilder)) {
|
|
result = false;
|
|
}
|
|
});
|
|
}
|
|
|
|
if (!result) {
|
|
return false;
|
|
}
|
|
|
|
// Remove the first object from the stack of traversed objects.
|
|
aStack.pop();
|
|
bStack.pop();
|
|
|
|
return result;
|
|
};
|
|
|
|
MatchersUtil.keys = function(obj, isArray) {
|
|
const allKeys = (function(o) {
|
|
const keys = [];
|
|
for (const key in o) {
|
|
if (j$.util.has(o, key)) {
|
|
keys.push(key);
|
|
}
|
|
}
|
|
|
|
const symbols = Object.getOwnPropertySymbols(o);
|
|
for (const sym of symbols) {
|
|
if (o.propertyIsEnumerable(sym)) {
|
|
keys.push(sym);
|
|
}
|
|
}
|
|
|
|
return keys;
|
|
})(obj);
|
|
|
|
if (!isArray) {
|
|
return allKeys;
|
|
}
|
|
|
|
if (allKeys.length === 0) {
|
|
return allKeys;
|
|
}
|
|
|
|
const extraKeys = [];
|
|
for (const k of allKeys) {
|
|
if (typeof k === 'symbol' || !/^[0-9]+$/.test(k)) {
|
|
extraKeys.push(k);
|
|
}
|
|
}
|
|
|
|
return extraKeys;
|
|
};
|
|
|
|
function isFunction(obj) {
|
|
return typeof obj === 'function';
|
|
}
|
|
|
|
// Returns an array of [k, v] pairs for eacch property that's in objA
|
|
// and not in objB.
|
|
function extraKeysAndValues(objA, objB) {
|
|
return MatchersUtil.keys(objA)
|
|
.filter(key => !j$.util.has(objB, key))
|
|
.map(key => [key, objA[key]]);
|
|
}
|
|
|
|
function objectKeysAreDifferentFormatter(pp, actual, expected, path) {
|
|
const missingProperties = extraKeysAndValues(expected, actual),
|
|
extraProperties = extraKeysAndValues(actual, expected),
|
|
missingPropertiesMessage = formatKeyValuePairs(pp, missingProperties),
|
|
extraPropertiesMessage = formatKeyValuePairs(pp, extraProperties),
|
|
messages = [];
|
|
|
|
if (!path.depth()) {
|
|
path = 'object';
|
|
}
|
|
|
|
if (missingPropertiesMessage.length) {
|
|
messages.push(
|
|
'Expected ' + path + ' to have properties' + missingPropertiesMessage
|
|
);
|
|
}
|
|
|
|
if (extraPropertiesMessage.length) {
|
|
messages.push(
|
|
'Expected ' + path + ' not to have properties' + extraPropertiesMessage
|
|
);
|
|
}
|
|
|
|
return messages.join('\n');
|
|
}
|
|
|
|
function constructorsAreDifferentFormatter(pp, actual, expected, path) {
|
|
if (!path.depth()) {
|
|
path = 'object';
|
|
}
|
|
|
|
return (
|
|
'Expected ' +
|
|
path +
|
|
' to be a kind of ' +
|
|
j$.fnNameFor(expected.constructor) +
|
|
', but was ' +
|
|
pp(actual) +
|
|
'.'
|
|
);
|
|
}
|
|
|
|
function actualArrayIsLongerFormatter(pp, actual, expected, path) {
|
|
return (
|
|
'Unexpected ' +
|
|
path +
|
|
(path.depth() ? ' = ' : '') +
|
|
pp(actual) +
|
|
' in array.'
|
|
);
|
|
}
|
|
|
|
function formatKeyValuePairs(pp, keyValuePairs) {
|
|
let formatted = '';
|
|
|
|
for (const [key, value] of keyValuePairs) {
|
|
formatted += '\n ' + key.toString() + ': ' + pp(value);
|
|
}
|
|
|
|
return formatted;
|
|
}
|
|
|
|
return MatchersUtil;
|
|
};
|
|
|
|
/**
|
|
* @interface AsymmetricEqualityTester
|
|
* @classdesc An asymmetric equality tester is an object that can match multiple
|
|
* objects. Examples include jasmine.any() and jasmine.stringMatching(). Jasmine
|
|
* includes a number of built-in asymmetric equality testers, such as
|
|
* {@link jasmine.objectContaining}. User-defined asymmetric equality testers are
|
|
* also supported.
|
|
*
|
|
* Asymmetric equality testers work with any matcher, including user-defined
|
|
* custom matchers, that uses {@link MatchersUtil#equals} or
|
|
* {@link MatchersUtil#contains}.
|
|
*
|
|
* @example
|
|
* function numberDivisibleBy(divisor) {
|
|
* return {
|
|
* asymmetricMatch: function(n) {
|
|
* return typeof n === 'number' && n % divisor === 0;
|
|
* },
|
|
* jasmineToString: function() {
|
|
* return `<a number divisible by ${divisor}>`;
|
|
* }
|
|
* };
|
|
* }
|
|
*
|
|
* const actual = {
|
|
* n: 2,
|
|
* otherFields: "don't care"
|
|
* };
|
|
*
|
|
* expect(actual).toEqual(jasmine.objectContaining({n: numberDivisibleBy(2)}));
|
|
* @see custom_asymmetric_equality_testers
|
|
* @since 2.0.0
|
|
*/
|
|
/**
|
|
* Determines whether a value matches this tester
|
|
* @function
|
|
* @name AsymmetricEqualityTester#asymmetricMatch
|
|
* @param value {any} The value to test
|
|
* @param matchersUtil {MatchersUtil} utilities for testing equality, etc
|
|
* @return {Boolean}
|
|
*/
|
|
/**
|
|
* Returns a string representation of this tester to use in matcher failure messages
|
|
* @function
|
|
* @name AsymmetricEqualityTester#jasmineToString
|
|
* @param pp {function} Function that takes a value and returns a pretty-printed representation
|
|
* @return {String}
|
|
*/
|
|
|
|
getJasmineRequireObj().MismatchTree = function(j$) {
|
|
/*
|
|
To be able to apply custom object formatters at all possible levels of an
|
|
object graph, DiffBuilder needs to be able to know not just where the
|
|
mismatch occurred but also all ancestors of the mismatched value in both
|
|
the expected and actual object graphs. MismatchTree maintains that context
|
|
and provides it via the traverse method.
|
|
*/
|
|
class MismatchTree {
|
|
constructor(path) {
|
|
this.path = path || new j$.ObjectPath([]);
|
|
this.formatter = undefined;
|
|
this.children = [];
|
|
this.isMismatch = false;
|
|
}
|
|
|
|
add(path, formatter) {
|
|
if (path.depth() === 0) {
|
|
this.formatter = formatter;
|
|
this.isMismatch = true;
|
|
} else {
|
|
const key = path.components[0];
|
|
path = path.shift();
|
|
let child = this.child(key);
|
|
|
|
if (!child) {
|
|
child = new MismatchTree(this.path.add(key));
|
|
this.children.push(child);
|
|
}
|
|
|
|
child.add(path, formatter);
|
|
}
|
|
}
|
|
|
|
traverse(visit) {
|
|
const hasChildren = this.children.length > 0;
|
|
|
|
if (this.isMismatch || hasChildren) {
|
|
if (visit(this.path, !hasChildren, this.formatter)) {
|
|
for (const child of this.children) {
|
|
child.traverse(visit);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
child(key) {
|
|
return this.children.find(child => {
|
|
const pathEls = child.path.components;
|
|
return pathEls[pathEls.length - 1] === key;
|
|
});
|
|
}
|
|
}
|
|
|
|
return MismatchTree;
|
|
};
|
|
|
|
getJasmineRequireObj().nothing = function() {
|
|
/**
|
|
* {@link expect} nothing explicitly.
|
|
* @function
|
|
* @name matchers#nothing
|
|
* @since 2.8.0
|
|
* @example
|
|
* expect().nothing();
|
|
*/
|
|
function nothing() {
|
|
return {
|
|
compare: function() {
|
|
return {
|
|
pass: true
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return nothing;
|
|
};
|
|
|
|
getJasmineRequireObj().NullDiffBuilder = function(j$) {
|
|
return function() {
|
|
return {
|
|
withPath: function(_, block) {
|
|
block();
|
|
},
|
|
setRoots: function() {},
|
|
recordMismatch: function() {}
|
|
};
|
|
};
|
|
};
|
|
|
|
getJasmineRequireObj().ObjectPath = function(j$) {
|
|
class ObjectPath {
|
|
constructor(components) {
|
|
this.components = components || [];
|
|
}
|
|
|
|
toString() {
|
|
if (this.components.length) {
|
|
return '$' + this.components.map(formatPropertyAccess).join('');
|
|
} else {
|
|
return '';
|
|
}
|
|
}
|
|
|
|
add(component) {
|
|
return new ObjectPath(this.components.concat([component]));
|
|
}
|
|
|
|
shift() {
|
|
return new ObjectPath(this.components.slice(1));
|
|
}
|
|
|
|
depth() {
|
|
return this.components.length;
|
|
}
|
|
}
|
|
|
|
function formatPropertyAccess(prop) {
|
|
if (typeof prop === 'number' || typeof prop === 'symbol') {
|
|
return '[' + prop.toString() + ']';
|
|
}
|
|
|
|
if (isValidIdentifier(prop)) {
|
|
return '.' + prop;
|
|
}
|
|
|
|
return `['${prop}']`;
|
|
}
|
|
|
|
function isValidIdentifier(string) {
|
|
return /^[A-Za-z\$_][A-Za-z0-9\$_]*$/.test(string);
|
|
}
|
|
|
|
return ObjectPath;
|
|
};
|
|
|
|
getJasmineRequireObj().requireAsyncMatchers = function(jRequire, j$) {
|
|
const availableMatchers = [
|
|
'toBePending',
|
|
'toBeResolved',
|
|
'toBeRejected',
|
|
'toBeResolvedTo',
|
|
'toBeRejectedWith',
|
|
'toBeRejectedWithError'
|
|
],
|
|
matchers = {};
|
|
|
|
for (const name of availableMatchers) {
|
|
matchers[name] = jRequire[name](j$);
|
|
}
|
|
|
|
return matchers;
|
|
};
|
|
|
|
getJasmineRequireObj().toBe = function(j$) {
|
|
/**
|
|
* {@link expect} the actual value to be `===` to the expected value.
|
|
* @function
|
|
* @name matchers#toBe
|
|
* @since 1.3.0
|
|
* @param {Object} expected - The expected value to compare against.
|
|
* @example
|
|
* expect(thing).toBe(realThing);
|
|
*/
|
|
function toBe(matchersUtil) {
|
|
const tip =
|
|
' Tip: To check for deep equality, use .toEqual() instead of .toBe().';
|
|
|
|
return {
|
|
compare: function(actual, expected) {
|
|
const result = {
|
|
pass: actual === expected
|
|
};
|
|
|
|
if (typeof expected === 'object') {
|
|
result.message =
|
|
matchersUtil.buildFailureMessage(
|
|
'toBe',
|
|
result.pass,
|
|
actual,
|
|
expected
|
|
) + tip;
|
|
}
|
|
|
|
return result;
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBe;
|
|
};
|
|
|
|
getJasmineRequireObj().toBeCloseTo = function() {
|
|
/**
|
|
* {@link expect} the actual value to be within a specified precision of the expected value.
|
|
* @function
|
|
* @name matchers#toBeCloseTo
|
|
* @since 1.3.0
|
|
* @param {Object} expected - The expected value to compare against.
|
|
* @param {Number} [precision=2] - The number of decimal points to check.
|
|
* @example
|
|
* expect(number).toBeCloseTo(42.2, 3);
|
|
*/
|
|
function toBeCloseTo() {
|
|
return {
|
|
compare: function(actual, expected, precision) {
|
|
if (precision !== 0) {
|
|
precision = precision || 2;
|
|
}
|
|
|
|
if (expected === null || actual === null) {
|
|
throw new Error(
|
|
'Cannot use toBeCloseTo with null. Arguments evaluated to: ' +
|
|
'expect(' +
|
|
actual +
|
|
').toBeCloseTo(' +
|
|
expected +
|
|
').'
|
|
);
|
|
}
|
|
|
|
// Infinity is close to Infinity and -Infinity is close to -Infinity,
|
|
// regardless of the precision.
|
|
if (expected === Infinity || expected === -Infinity) {
|
|
return {
|
|
pass: actual === expected
|
|
};
|
|
}
|
|
|
|
const pow = Math.pow(10, precision + 1);
|
|
const delta = Math.abs(expected - actual);
|
|
const maxDelta = Math.pow(10, -precision) / 2;
|
|
|
|
return {
|
|
pass: Math.round(delta * pow) <= maxDelta * pow
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBeCloseTo;
|
|
};
|
|
|
|
getJasmineRequireObj().toBeDefined = function() {
|
|
/**
|
|
* {@link expect} the actual value to be defined. (Not `undefined`)
|
|
* @function
|
|
* @name matchers#toBeDefined
|
|
* @since 1.3.0
|
|
* @example
|
|
* expect(result).toBeDefined();
|
|
*/
|
|
function toBeDefined() {
|
|
return {
|
|
compare: function(actual) {
|
|
return {
|
|
pass: void 0 !== actual
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBeDefined;
|
|
};
|
|
|
|
getJasmineRequireObj().toBeFalse = function() {
|
|
/**
|
|
* {@link expect} the actual value to be `false`.
|
|
* @function
|
|
* @name matchers#toBeFalse
|
|
* @since 3.5.0
|
|
* @example
|
|
* expect(result).toBeFalse();
|
|
*/
|
|
function toBeFalse() {
|
|
return {
|
|
compare: function(actual) {
|
|
return {
|
|
pass: actual === false
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBeFalse;
|
|
};
|
|
|
|
getJasmineRequireObj().toBeFalsy = function() {
|
|
/**
|
|
* {@link expect} the actual value to be falsy
|
|
* @function
|
|
* @name matchers#toBeFalsy
|
|
* @since 2.0.0
|
|
* @example
|
|
* expect(result).toBeFalsy();
|
|
*/
|
|
function toBeFalsy() {
|
|
return {
|
|
compare: function(actual) {
|
|
return {
|
|
pass: !actual
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBeFalsy;
|
|
};
|
|
|
|
getJasmineRequireObj().toBeGreaterThan = function() {
|
|
/**
|
|
* {@link expect} the actual value to be greater than the expected value.
|
|
* @function
|
|
* @name matchers#toBeGreaterThan
|
|
* @since 2.0.0
|
|
* @param {Number} expected - The value to compare against.
|
|
* @example
|
|
* expect(result).toBeGreaterThan(3);
|
|
*/
|
|
function toBeGreaterThan() {
|
|
return {
|
|
compare: function(actual, expected) {
|
|
return {
|
|
pass: actual > expected
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBeGreaterThan;
|
|
};
|
|
|
|
getJasmineRequireObj().toBeGreaterThanOrEqual = function() {
|
|
/**
|
|
* {@link expect} the actual value to be greater than or equal to the expected value.
|
|
* @function
|
|
* @name matchers#toBeGreaterThanOrEqual
|
|
* @since 2.0.0
|
|
* @param {Number} expected - The expected value to compare against.
|
|
* @example
|
|
* expect(result).toBeGreaterThanOrEqual(25);
|
|
*/
|
|
function toBeGreaterThanOrEqual() {
|
|
return {
|
|
compare: function(actual, expected) {
|
|
return {
|
|
pass: actual >= expected
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBeGreaterThanOrEqual;
|
|
};
|
|
|
|
getJasmineRequireObj().toBeInstanceOf = function(j$) {
|
|
const usageError = j$.formatErrorMsg(
|
|
'<toBeInstanceOf>',
|
|
'expect(value).toBeInstanceOf(<ConstructorFunction>)'
|
|
);
|
|
|
|
/**
|
|
* {@link expect} the actual to be an instance of the expected class
|
|
* @function
|
|
* @name matchers#toBeInstanceOf
|
|
* @since 3.5.0
|
|
* @param {Object} expected - The class or constructor function to check for
|
|
* @example
|
|
* expect('foo').toBeInstanceOf(String);
|
|
* expect(3).toBeInstanceOf(Number);
|
|
* expect(new Error()).toBeInstanceOf(Error);
|
|
*/
|
|
function toBeInstanceOf(matchersUtil) {
|
|
return {
|
|
compare: function(actual, expected) {
|
|
const actualType =
|
|
actual && actual.constructor
|
|
? j$.fnNameFor(actual.constructor)
|
|
: matchersUtil.pp(actual);
|
|
const expectedType = expected
|
|
? j$.fnNameFor(expected)
|
|
: matchersUtil.pp(expected);
|
|
let expectedMatcher;
|
|
let pass;
|
|
|
|
try {
|
|
expectedMatcher = new j$.Any(expected);
|
|
pass = expectedMatcher.asymmetricMatch(actual);
|
|
} catch (error) {
|
|
throw new Error(
|
|
usageError('Expected value is not a constructor function')
|
|
);
|
|
}
|
|
|
|
if (pass) {
|
|
return {
|
|
pass: true,
|
|
message:
|
|
'Expected instance of ' +
|
|
actualType +
|
|
' not to be an instance of ' +
|
|
expectedType
|
|
};
|
|
} else {
|
|
return {
|
|
pass: false,
|
|
message:
|
|
'Expected instance of ' +
|
|
actualType +
|
|
' to be an instance of ' +
|
|
expectedType
|
|
};
|
|
}
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBeInstanceOf;
|
|
};
|
|
|
|
getJasmineRequireObj().toBeLessThan = function() {
|
|
/**
|
|
* {@link expect} the actual value to be less than the expected value.
|
|
* @function
|
|
* @name matchers#toBeLessThan
|
|
* @since 2.0.0
|
|
* @param {Number} expected - The expected value to compare against.
|
|
* @example
|
|
* expect(result).toBeLessThan(0);
|
|
*/
|
|
function toBeLessThan() {
|
|
return {
|
|
compare: function(actual, expected) {
|
|
return {
|
|
pass: actual < expected
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBeLessThan;
|
|
};
|
|
|
|
getJasmineRequireObj().toBeLessThanOrEqual = function() {
|
|
/**
|
|
* {@link expect} the actual value to be less than or equal to the expected value.
|
|
* @function
|
|
* @name matchers#toBeLessThanOrEqual
|
|
* @since 2.0.0
|
|
* @param {Number} expected - The expected value to compare against.
|
|
* @example
|
|
* expect(result).toBeLessThanOrEqual(123);
|
|
*/
|
|
function toBeLessThanOrEqual() {
|
|
return {
|
|
compare: function(actual, expected) {
|
|
return {
|
|
pass: actual <= expected
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBeLessThanOrEqual;
|
|
};
|
|
|
|
getJasmineRequireObj().toBeNaN = function(j$) {
|
|
/**
|
|
* {@link expect} the actual value to be `NaN` (Not a Number).
|
|
* @function
|
|
* @name matchers#toBeNaN
|
|
* @since 1.3.0
|
|
* @example
|
|
* expect(thing).toBeNaN();
|
|
*/
|
|
function toBeNaN(matchersUtil) {
|
|
return {
|
|
compare: function(actual) {
|
|
const result = {
|
|
pass: actual !== actual
|
|
};
|
|
|
|
if (result.pass) {
|
|
result.message = 'Expected actual not to be NaN.';
|
|
} else {
|
|
result.message = function() {
|
|
return 'Expected ' + matchersUtil.pp(actual) + ' to be NaN.';
|
|
};
|
|
}
|
|
|
|
return result;
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBeNaN;
|
|
};
|
|
|
|
getJasmineRequireObj().toBeNegativeInfinity = function(j$) {
|
|
/**
|
|
* {@link expect} the actual value to be `-Infinity` (-infinity).
|
|
* @function
|
|
* @name matchers#toBeNegativeInfinity
|
|
* @since 2.6.0
|
|
* @example
|
|
* expect(thing).toBeNegativeInfinity();
|
|
*/
|
|
function toBeNegativeInfinity(matchersUtil) {
|
|
return {
|
|
compare: function(actual) {
|
|
const result = {
|
|
pass: actual === Number.NEGATIVE_INFINITY
|
|
};
|
|
|
|
if (result.pass) {
|
|
result.message = 'Expected actual not to be -Infinity.';
|
|
} else {
|
|
result.message = function() {
|
|
return 'Expected ' + matchersUtil.pp(actual) + ' to be -Infinity.';
|
|
};
|
|
}
|
|
|
|
return result;
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBeNegativeInfinity;
|
|
};
|
|
|
|
getJasmineRequireObj().toBeNull = function() {
|
|
/**
|
|
* {@link expect} the actual value to be `null`.
|
|
* @function
|
|
* @name matchers#toBeNull
|
|
* @since 1.3.0
|
|
* @example
|
|
* expect(result).toBeNull();
|
|
*/
|
|
function toBeNull() {
|
|
return {
|
|
compare: function(actual) {
|
|
return {
|
|
pass: actual === null
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBeNull;
|
|
};
|
|
|
|
getJasmineRequireObj().toBePositiveInfinity = function(j$) {
|
|
/**
|
|
* {@link expect} the actual value to be `Infinity` (infinity).
|
|
* @function
|
|
* @name matchers#toBePositiveInfinity
|
|
* @since 2.6.0
|
|
* @example
|
|
* expect(thing).toBePositiveInfinity();
|
|
*/
|
|
function toBePositiveInfinity(matchersUtil) {
|
|
return {
|
|
compare: function(actual) {
|
|
const result = {
|
|
pass: actual === Number.POSITIVE_INFINITY
|
|
};
|
|
|
|
if (result.pass) {
|
|
result.message = 'Expected actual not to be Infinity.';
|
|
} else {
|
|
result.message = function() {
|
|
return 'Expected ' + matchersUtil.pp(actual) + ' to be Infinity.';
|
|
};
|
|
}
|
|
|
|
return result;
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBePositiveInfinity;
|
|
};
|
|
|
|
getJasmineRequireObj().toBeTrue = function() {
|
|
/**
|
|
* {@link expect} the actual value to be `true`.
|
|
* @function
|
|
* @name matchers#toBeTrue
|
|
* @since 3.5.0
|
|
* @example
|
|
* expect(result).toBeTrue();
|
|
*/
|
|
function toBeTrue() {
|
|
return {
|
|
compare: function(actual) {
|
|
return {
|
|
pass: actual === true
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBeTrue;
|
|
};
|
|
|
|
getJasmineRequireObj().toBeTruthy = function() {
|
|
/**
|
|
* {@link expect} the actual value to be truthy.
|
|
* @function
|
|
* @name matchers#toBeTruthy
|
|
* @since 2.0.0
|
|
* @example
|
|
* expect(thing).toBeTruthy();
|
|
*/
|
|
function toBeTruthy() {
|
|
return {
|
|
compare: function(actual) {
|
|
return {
|
|
pass: !!actual
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBeTruthy;
|
|
};
|
|
|
|
getJasmineRequireObj().toBeUndefined = function() {
|
|
/**
|
|
* {@link expect} the actual value to be `undefined`.
|
|
* @function
|
|
* @name matchers#toBeUndefined
|
|
* @since 1.3.0
|
|
* @example
|
|
* expect(result).toBeUndefined():
|
|
*/
|
|
function toBeUndefined() {
|
|
return {
|
|
compare: function(actual) {
|
|
return {
|
|
pass: void 0 === actual
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return toBeUndefined;
|
|
};
|
|
|
|
getJasmineRequireObj().toContain = function() {
|
|
/**
|
|
* {@link expect} the actual value to contain a specific value.
|
|
* @function
|
|
* @name matchers#toContain
|
|
* @since 2.0.0
|
|
* @param {Object} expected - The value to look for.
|
|
* @example
|
|
* expect(array).toContain(anElement);
|
|
* expect(string).toContain(substring);
|
|
*/
|
|
function toContain(matchersUtil) {
|
|
return {
|
|
compare: function(actual, expected) {
|
|
return {
|
|
pass: matchersUtil.contains(actual, expected)
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return toContain;
|
|
};
|
|
|
|
getJasmineRequireObj().toEqual = function(j$) {
|
|
/**
|
|
* {@link expect} the actual value to be equal to the expected, using deep equality comparison.
|
|
* @function
|
|
* @name matchers#toEqual
|
|
* @since 1.3.0
|
|
* @param {Object} expected - Expected value
|
|
* @example
|
|
* expect(bigObject).toEqual({"foo": ['bar', 'baz']});
|
|
*/
|
|
function toEqual(matchersUtil) {
|
|
return {
|
|
compare: function(actual, expected) {
|
|
const result = {
|
|
pass: false
|
|
},
|
|
diffBuilder = new j$.DiffBuilder({ prettyPrinter: matchersUtil.pp });
|
|
|
|
result.pass = matchersUtil.equals(actual, expected, diffBuilder);
|
|
|
|
// TODO: only set error message if test fails
|
|
result.message = diffBuilder.getMessage();
|
|
|
|
return result;
|
|
}
|
|
};
|
|
}
|
|
|
|
return toEqual;
|
|
};
|
|
|
|
getJasmineRequireObj().toHaveBeenCalled = function(j$) {
|
|
const getErrorMsg = j$.formatErrorMsg(
|
|
'<toHaveBeenCalled>',
|
|
'expect(<spyObj>).toHaveBeenCalled()'
|
|
);
|
|
|
|
/**
|
|
* {@link expect} the actual (a {@link Spy}) to have been called.
|
|
* @function
|
|
* @name matchers#toHaveBeenCalled
|
|
* @since 1.3.0
|
|
* @example
|
|
* expect(mySpy).toHaveBeenCalled();
|
|
* expect(mySpy).not.toHaveBeenCalled();
|
|
*/
|
|
function toHaveBeenCalled(matchersUtil) {
|
|
return {
|
|
compare: function(actual) {
|
|
const result = {};
|
|
|
|
if (!j$.isSpy(actual)) {
|
|
throw new Error(
|
|
getErrorMsg(
|
|
'Expected a spy, but got ' + matchersUtil.pp(actual) + '.'
|
|
)
|
|
);
|
|
}
|
|
|
|
if (arguments.length > 1) {
|
|
throw new Error(
|
|
getErrorMsg('Does not take arguments, use toHaveBeenCalledWith')
|
|
);
|
|
}
|
|
|
|
result.pass = actual.calls.any();
|
|
|
|
result.message = result.pass
|
|
? 'Expected spy ' + actual.and.identity + ' not to have been called.'
|
|
: 'Expected spy ' + actual.and.identity + ' to have been called.';
|
|
|
|
return result;
|
|
}
|
|
};
|
|
}
|
|
|
|
return toHaveBeenCalled;
|
|
};
|
|
|
|
getJasmineRequireObj().toHaveBeenCalledBefore = function(j$) {
|
|
const getErrorMsg = j$.formatErrorMsg(
|
|
'<toHaveBeenCalledBefore>',
|
|
'expect(<spyObj>).toHaveBeenCalledBefore(<spyObj>)'
|
|
);
|
|
|
|
/**
|
|
* {@link expect} the actual value (a {@link Spy}) to have been called before another {@link Spy}.
|
|
* @function
|
|
* @name matchers#toHaveBeenCalledBefore
|
|
* @since 2.6.0
|
|
* @param {Spy} expected - {@link Spy} that should have been called after the `actual` {@link Spy}.
|
|
* @example
|
|
* expect(mySpy).toHaveBeenCalledBefore(otherSpy);
|
|
*/
|
|
function toHaveBeenCalledBefore(matchersUtil) {
|
|
return {
|
|
compare: function(firstSpy, latterSpy) {
|
|
if (!j$.isSpy(firstSpy)) {
|
|
throw new Error(
|
|
getErrorMsg(
|
|
'Expected a spy, but got ' + matchersUtil.pp(firstSpy) + '.'
|
|
)
|
|
);
|
|
}
|
|
if (!j$.isSpy(latterSpy)) {
|
|
throw new Error(
|
|
getErrorMsg(
|
|
'Expected a spy, but got ' + matchersUtil.pp(latterSpy) + '.'
|
|
)
|
|
);
|
|
}
|
|
|
|
const result = { pass: false };
|
|
|
|
if (!firstSpy.calls.count()) {
|
|
result.message =
|
|
'Expected spy ' + firstSpy.and.identity + ' to have been called.';
|
|
return result;
|
|
}
|
|
if (!latterSpy.calls.count()) {
|
|
result.message =
|
|
'Expected spy ' + latterSpy.and.identity + ' to have been called.';
|
|
return result;
|
|
}
|
|
|
|
const latest1stSpyCall = firstSpy.calls.mostRecent().invocationOrder;
|
|
const first2ndSpyCall = latterSpy.calls.first().invocationOrder;
|
|
|
|
result.pass = latest1stSpyCall < first2ndSpyCall;
|
|
|
|
if (result.pass) {
|
|
result.message =
|
|
'Expected spy ' +
|
|
firstSpy.and.identity +
|
|
' to not have been called before spy ' +
|
|
latterSpy.and.identity +
|
|
', but it was';
|
|
} else {
|
|
const first1stSpyCall = firstSpy.calls.first().invocationOrder;
|
|
const latest2ndSpyCall = latterSpy.calls.mostRecent().invocationOrder;
|
|
|
|
if (first1stSpyCall < first2ndSpyCall) {
|
|
result.message =
|
|
'Expected latest call to spy ' +
|
|
firstSpy.and.identity +
|
|
' to have been called before first call to spy ' +
|
|
latterSpy.and.identity +
|
|
' (no interleaved calls)';
|
|
} else if (latest2ndSpyCall > latest1stSpyCall) {
|
|
result.message =
|
|
'Expected first call to spy ' +
|
|
latterSpy.and.identity +
|
|
' to have been called after latest call to spy ' +
|
|
firstSpy.and.identity +
|
|
' (no interleaved calls)';
|
|
} else {
|
|
result.message =
|
|
'Expected spy ' +
|
|
firstSpy.and.identity +
|
|
' to have been called before spy ' +
|
|
latterSpy.and.identity;
|
|
}
|
|
}
|
|
|
|
return result;
|
|
}
|
|
};
|
|
}
|
|
|
|
return toHaveBeenCalledBefore;
|
|
};
|
|
|
|
getJasmineRequireObj().toHaveBeenCalledOnceWith = function(j$) {
|
|
const getErrorMsg = j$.formatErrorMsg(
|
|
'<toHaveBeenCalledOnceWith>',
|
|
'expect(<spyObj>).toHaveBeenCalledOnceWith(...arguments)'
|
|
);
|
|
|
|
/**
|
|
* {@link expect} the actual (a {@link Spy}) to have been called exactly once, and exactly with the particular arguments.
|
|
* @function
|
|
* @name matchers#toHaveBeenCalledOnceWith
|
|
* @since 3.6.0
|
|
* @param {...Object} - The arguments to look for
|
|
* @example
|
|
* expect(mySpy).toHaveBeenCalledOnceWith('foo', 'bar', 2);
|
|
*/
|
|
function toHaveBeenCalledOnceWith(util) {
|
|
return {
|
|
compare: function() {
|
|
const args = Array.prototype.slice.call(arguments, 0),
|
|
actual = args[0],
|
|
expectedArgs = args.slice(1);
|
|
|
|
if (!j$.isSpy(actual)) {
|
|
throw new Error(
|
|
getErrorMsg('Expected a spy, but got ' + util.pp(actual) + '.')
|
|
);
|
|
}
|
|
|
|
const prettyPrintedCalls = actual.calls
|
|
.allArgs()
|
|
.map(function(argsForCall) {
|
|
return ' ' + util.pp(argsForCall);
|
|
});
|
|
|
|
if (
|
|
actual.calls.count() === 1 &&
|
|
util.contains(actual.calls.allArgs(), expectedArgs)
|
|
) {
|
|
return {
|
|
pass: true,
|
|
message:
|
|
'Expected spy ' +
|
|
actual.and.identity +
|
|
' to have been called 0 times, multiple times, or once, but with arguments different from:\n' +
|
|
' ' +
|
|
util.pp(expectedArgs) +
|
|
'\n' +
|
|
'But the actual call was:\n' +
|
|
prettyPrintedCalls.join(',\n') +
|
|
'.\n\n'
|
|
};
|
|
}
|
|
|
|
function getDiffs() {
|
|
return actual.calls.allArgs().map(function(argsForCall, callIx) {
|
|
const diffBuilder = new j$.DiffBuilder();
|
|
util.equals(argsForCall, expectedArgs, diffBuilder);
|
|
return diffBuilder.getMessage();
|
|
});
|
|
}
|
|
|
|
function butString() {
|
|
switch (actual.calls.count()) {
|
|
case 0:
|
|
return 'But it was never called.\n\n';
|
|
case 1:
|
|
return (
|
|
'But the actual call was:\n' +
|
|
prettyPrintedCalls.join(',\n') +
|
|
'.\n' +
|
|
getDiffs().join('\n') +
|
|
'\n\n'
|
|
);
|
|
default:
|
|
return (
|
|
'But the actual calls were:\n' +
|
|
prettyPrintedCalls.join(',\n') +
|
|
'.\n\n'
|
|
);
|
|
}
|
|
}
|
|
|
|
return {
|
|
pass: false,
|
|
message:
|
|
'Expected spy ' +
|
|
actual.and.identity +
|
|
' to have been called only once, and with given args:\n' +
|
|
' ' +
|
|
util.pp(expectedArgs) +
|
|
'\n' +
|
|
butString()
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return toHaveBeenCalledOnceWith;
|
|
};
|
|
|
|
getJasmineRequireObj().toHaveBeenCalledTimes = function(j$) {
|
|
const getErrorMsg = j$.formatErrorMsg(
|
|
'<toHaveBeenCalledTimes>',
|
|
'expect(<spyObj>).toHaveBeenCalledTimes(<Number>)'
|
|
);
|
|
|
|
/**
|
|
* {@link expect} the actual (a {@link Spy}) to have been called the specified number of times.
|
|
* @function
|
|
* @name matchers#toHaveBeenCalledTimes
|
|
* @since 2.4.0
|
|
* @param {Number} expected - The number of invocations to look for.
|
|
* @example
|
|
* expect(mySpy).toHaveBeenCalledTimes(3);
|
|
*/
|
|
function toHaveBeenCalledTimes(matchersUtil) {
|
|
return {
|
|
compare: function(actual, expected) {
|
|
if (!j$.isSpy(actual)) {
|
|
throw new Error(
|
|
getErrorMsg(
|
|
'Expected a spy, but got ' + matchersUtil.pp(actual) + '.'
|
|
)
|
|
);
|
|
}
|
|
|
|
const args = Array.prototype.slice.call(arguments, 0),
|
|
result = { pass: false };
|
|
|
|
if (!j$.isNumber_(expected)) {
|
|
throw new Error(
|
|
getErrorMsg(
|
|
'The expected times failed is a required argument and must be a number.'
|
|
)
|
|
);
|
|
}
|
|
|
|
actual = args[0];
|
|
const calls = actual.calls.count();
|
|
const timesMessage = expected === 1 ? 'once' : expected + ' times';
|
|
result.pass = calls === expected;
|
|
result.message = result.pass
|
|
? 'Expected spy ' +
|
|
actual.and.identity +
|
|
' not to have been called ' +
|
|
timesMessage +
|
|
'. It was called ' +
|
|
calls +
|
|
' times.'
|
|
: 'Expected spy ' +
|
|
actual.and.identity +
|
|
' to have been called ' +
|
|
timesMessage +
|
|
'. It was called ' +
|
|
calls +
|
|
' times.';
|
|
return result;
|
|
}
|
|
};
|
|
}
|
|
|
|
return toHaveBeenCalledTimes;
|
|
};
|
|
|
|
getJasmineRequireObj().toHaveBeenCalledWith = function(j$) {
|
|
const getErrorMsg = j$.formatErrorMsg(
|
|
'<toHaveBeenCalledWith>',
|
|
'expect(<spyObj>).toHaveBeenCalledWith(...arguments)'
|
|
);
|
|
|
|
/**
|
|
* {@link expect} the actual (a {@link Spy}) to have been called with particular arguments at least once.
|
|
* @function
|
|
* @name matchers#toHaveBeenCalledWith
|
|
* @since 1.3.0
|
|
* @param {...Object} - The arguments to look for
|
|
* @example
|
|
* expect(mySpy).toHaveBeenCalledWith('foo', 'bar', 2);
|
|
*/
|
|
function toHaveBeenCalledWith(matchersUtil) {
|
|
return {
|
|
compare: function() {
|
|
const args = Array.prototype.slice.call(arguments, 0),
|
|
actual = args[0],
|
|
expectedArgs = args.slice(1),
|
|
result = { pass: false };
|
|
|
|
if (!j$.isSpy(actual)) {
|
|
throw new Error(
|
|
getErrorMsg(
|
|
'Expected a spy, but got ' + matchersUtil.pp(actual) + '.'
|
|
)
|
|
);
|
|
}
|
|
|
|
if (!actual.calls.any()) {
|
|
result.message = function() {
|
|
return (
|
|
'Expected spy ' +
|
|
actual.and.identity +
|
|
' to have been called with:\n' +
|
|
' ' +
|
|
matchersUtil.pp(expectedArgs) +
|
|
'\nbut it was never called.'
|
|
);
|
|
};
|
|
return result;
|
|
}
|
|
|
|
if (matchersUtil.contains(actual.calls.allArgs(), expectedArgs)) {
|
|
result.pass = true;
|
|
result.message = function() {
|
|
return (
|
|
'Expected spy ' +
|
|
actual.and.identity +
|
|
' not to have been called with:\n' +
|
|
' ' +
|
|
matchersUtil.pp(expectedArgs) +
|
|
'\nbut it was.'
|
|
);
|
|
};
|
|
} else {
|
|
result.message = function() {
|
|
const prettyPrintedCalls = actual.calls
|
|
.allArgs()
|
|
.map(function(argsForCall) {
|
|
return ' ' + matchersUtil.pp(argsForCall);
|
|
});
|
|
|
|
const diffs = actual.calls
|
|
.allArgs()
|
|
.map(function(argsForCall, callIx) {
|
|
const diffBuilder = new j$.DiffBuilder();
|
|
matchersUtil.equals(argsForCall, expectedArgs, diffBuilder);
|
|
return (
|
|
'Call ' +
|
|
callIx +
|
|
':\n' +
|
|
diffBuilder.getMessage().replace(/^/gm, ' ')
|
|
);
|
|
});
|
|
|
|
return (
|
|
'Expected spy ' +
|
|
actual.and.identity +
|
|
' to have been called with:\n' +
|
|
' ' +
|
|
matchersUtil.pp(expectedArgs) +
|
|
'\n' +
|
|
'' +
|
|
'but actual calls were:\n' +
|
|
prettyPrintedCalls.join(',\n') +
|
|
'.\n\n' +
|
|
diffs.join('\n')
|
|
);
|
|
};
|
|
}
|
|
|
|
return result;
|
|
}
|
|
};
|
|
}
|
|
|
|
return toHaveBeenCalledWith;
|
|
};
|
|
|
|
getJasmineRequireObj().toHaveClass = function(j$) {
|
|
/**
|
|
* {@link expect} the actual value to be a DOM element that has the expected class
|
|
* @function
|
|
* @name matchers#toHaveClass
|
|
* @since 3.0.0
|
|
* @param {Object} expected - The class name to test for
|
|
* @example
|
|
* const el = document.createElement('div');
|
|
* el.className = 'foo bar baz';
|
|
* expect(el).toHaveClass('bar');
|
|
*/
|
|
function toHaveClass(matchersUtil) {
|
|
return {
|
|
compare: function(actual, expected) {
|
|
if (!isElement(actual)) {
|
|
throw new Error(matchersUtil.pp(actual) + ' is not a DOM element');
|
|
}
|
|
|
|
return {
|
|
pass: actual.classList.contains(expected)
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
function isElement(maybeEl) {
|
|
return (
|
|
maybeEl && maybeEl.classList && j$.isFunction_(maybeEl.classList.contains)
|
|
);
|
|
}
|
|
|
|
return toHaveClass;
|
|
};
|
|
|
|
getJasmineRequireObj().toHaveSize = function(j$) {
|
|
/**
|
|
* {@link expect} the actual size to be equal to the expected, using array-like length or object keys size.
|
|
* @function
|
|
* @name matchers#toHaveSize
|
|
* @since 3.6.0
|
|
* @param {Object} expected - Expected size
|
|
* @example
|
|
* array = [1,2];
|
|
* expect(array).toHaveSize(2);
|
|
*/
|
|
function toHaveSize() {
|
|
return {
|
|
compare: function(actual, expected) {
|
|
const result = {
|
|
pass: false
|
|
};
|
|
|
|
if (
|
|
j$.isA_('WeakSet', actual) ||
|
|
j$.isWeakMap(actual) ||
|
|
j$.isDataView(actual)
|
|
) {
|
|
throw new Error('Cannot get size of ' + actual + '.');
|
|
}
|
|
|
|
if (j$.isSet(actual) || j$.isMap(actual)) {
|
|
result.pass = actual.size === expected;
|
|
} else if (isLength(actual.length)) {
|
|
result.pass = actual.length === expected;
|
|
} else {
|
|
result.pass = Object.keys(actual).length === expected;
|
|
}
|
|
|
|
return result;
|
|
}
|
|
};
|
|
}
|
|
|
|
const MAX_SAFE_INTEGER = Number.MAX_SAFE_INTEGER || 9007199254740991;
|
|
function isLength(value) {
|
|
return (
|
|
typeof value == 'number' &&
|
|
value > -1 &&
|
|
value % 1 === 0 &&
|
|
value <= MAX_SAFE_INTEGER
|
|
);
|
|
}
|
|
|
|
return toHaveSize;
|
|
};
|
|
|
|
getJasmineRequireObj().toHaveSpyInteractions = function(j$) {
|
|
const getErrorMsg = j$.formatErrorMsg(
|
|
'<toHaveSpyInteractions>',
|
|
'expect(<spyObj>).toHaveSpyInteractions()'
|
|
);
|
|
|
|
/**
|
|
* {@link expect} the actual (a {@link SpyObj}) spies to have been called.
|
|
* @function
|
|
* @name matchers#toHaveSpyInteractions
|
|
* @since 4.1.0
|
|
* @example
|
|
* expect(mySpyObj).toHaveSpyInteractions();
|
|
* expect(mySpyObj).not.toHaveSpyInteractions();
|
|
*/
|
|
function toHaveSpyInteractions(matchersUtil) {
|
|
return {
|
|
compare: function(actual) {
|
|
const result = {};
|
|
|
|
if (!j$.isObject_(actual)) {
|
|
throw new Error(
|
|
getErrorMsg('Expected a spy object, but got ' + typeof actual + '.')
|
|
);
|
|
}
|
|
|
|
if (arguments.length > 1) {
|
|
throw new Error(getErrorMsg('Does not take arguments'));
|
|
}
|
|
|
|
result.pass = false;
|
|
let hasSpy = false;
|
|
const calledSpies = [];
|
|
for (const spy of Object.values(actual)) {
|
|
if (!j$.isSpy(spy)) continue;
|
|
hasSpy = true;
|
|
|
|
if (spy.calls.any()) {
|
|
result.pass = true;
|
|
calledSpies.push([spy.and.identity, spy.calls.count()]);
|
|
}
|
|
}
|
|
|
|
if (!hasSpy) {
|
|
throw new Error(
|
|
getErrorMsg(
|
|
'Expected a spy object with spies, but object has no spies.'
|
|
)
|
|
);
|
|
}
|
|
|
|
let resultMessage;
|
|
if (result.pass) {
|
|
resultMessage =
|
|
'Expected spy object spies not to have been called, ' +
|
|
'but the following spies were called: ';
|
|
resultMessage += calledSpies
|
|
.map(([spyName, spyCount]) => {
|
|
return `${spyName} called ${spyCount} time(s)`;
|
|
})
|
|
.join(', ');
|
|
} else {
|
|
resultMessage =
|
|
'Expected spy object spies to have been called, ' +
|
|
'but no spies were called.';
|
|
}
|
|
result.message = resultMessage;
|
|
|
|
return result;
|
|
}
|
|
};
|
|
}
|
|
|
|
return toHaveSpyInteractions;
|
|
};
|
|
|
|
getJasmineRequireObj().toMatch = function(j$) {
|
|
const getErrorMsg = j$.formatErrorMsg(
|
|
'<toMatch>',
|
|
'expect(<expectation>).toMatch(<string> || <regexp>)'
|
|
);
|
|
|
|
/**
|
|
* {@link expect} the actual value to match a regular expression
|
|
* @function
|
|
* @name matchers#toMatch
|
|
* @since 1.3.0
|
|
* @param {RegExp|String} expected - Value to look for in the string.
|
|
* @example
|
|
* expect("my string").toMatch(/string$/);
|
|
* expect("other string").toMatch("her");
|
|
*/
|
|
function toMatch() {
|
|
return {
|
|
compare: function(actual, expected) {
|
|
if (!j$.isString_(expected) && !j$.isA_('RegExp', expected)) {
|
|
throw new Error(getErrorMsg('Expected is not a String or a RegExp'));
|
|
}
|
|
|
|
const regexp = new RegExp(expected);
|
|
|
|
return {
|
|
pass: regexp.test(actual)
|
|
};
|
|
}
|
|
};
|
|
}
|
|
|
|
return toMatch;
|
|
};
|
|
|
|
getJasmineRequireObj().toThrow = function(j$) {
|
|
const getErrorMsg = j$.formatErrorMsg(
|
|
'<toThrow>',
|
|
'expect(function() {<expectation>}).toThrow()'
|
|
);
|
|
|
|
/**
|
|
* {@link expect} a function to `throw` something.
|
|
* @function
|
|
* @name matchers#toThrow
|
|
* @since 2.0.0
|
|
* @param {Object} [expected] - Value that should be thrown. If not provided, simply the fact that something was thrown will be checked.
|
|
* @example
|
|
* expect(function() { return 'things'; }).toThrow('foo');
|
|
* expect(function() { return 'stuff'; }).toThrow();
|
|
*/
|
|
function toThrow(matchersUtil) {
|
|
return {
|
|
compare: function(actual, expected) {
|
|
const result = { pass: false };
|
|
let threw = false;
|
|
let thrown;
|
|
|
|
if (typeof actual != 'function') {
|
|
throw new Error(getErrorMsg('Actual is not a Function'));
|
|
}
|
|
|
|
try {
|
|
actual();
|
|
} catch (e) {
|
|
threw = true;
|
|
thrown = e;
|
|
}
|
|
|
|
if (!threw) {
|
|
result.message = 'Expected function to throw an exception.';
|
|
return result;
|
|
}
|
|
|
|
if (arguments.length == 1) {
|
|
result.pass = true;
|
|
result.message = function() {
|
|
return (
|
|
'Expected function not to throw, but it threw ' +
|
|
matchersUtil.pp(thrown) +
|
|
'.'
|
|
);
|
|
};
|
|
|
|
return result;
|
|
}
|
|
|
|
if (matchersUtil.equals(thrown, expected)) {
|
|
result.pass = true;
|
|
result.message = function() {
|
|
return (
|
|
'Expected function not to throw ' +
|
|
matchersUtil.pp(expected) +
|
|
'.'
|
|
);
|
|
};
|
|
} else {
|
|
result.message = function() {
|
|
return (
|
|
'Expected function to throw ' +
|
|
matchersUtil.pp(expected) +
|
|
', but it threw ' +
|
|
matchersUtil.pp(thrown) +
|
|
'.'
|
|
);
|
|
};
|
|
}
|
|
|
|
return result;
|
|
}
|
|
};
|
|
}
|
|
|
|
return toThrow;
|
|
};
|
|
|
|
getJasmineRequireObj().toThrowError = function(j$) {
|
|
const getErrorMsg = j$.formatErrorMsg(
|
|
'<toThrowError>',
|
|
'expect(function() {<expectation>}).toThrowError(<ErrorConstructor>, <message>)'
|
|
);
|
|
|
|
/**
|
|
* {@link expect} a function to `throw` an `Error`.
|
|
* @function
|
|
* @name matchers#toThrowError
|
|
* @since 2.0.0
|
|
* @param {Error} [expected] - `Error` constructor the object that was thrown needs to be an instance of. If not provided, `Error` will be used.
|
|
* @param {RegExp|String} [message] - The message that should be set on the thrown `Error`
|
|
* @example
|
|
* expect(function() { return 'things'; }).toThrowError(MyCustomError, 'message');
|
|
* expect(function() { return 'things'; }).toThrowError(MyCustomError, /bar/);
|
|
* expect(function() { return 'stuff'; }).toThrowError(MyCustomError);
|
|
* expect(function() { return 'other'; }).toThrowError(/foo/);
|
|
* expect(function() { return 'other'; }).toThrowError();
|
|
*/
|
|
function toThrowError(matchersUtil) {
|
|
return {
|
|
compare: function(actual) {
|
|
const errorMatcher = getMatcher.apply(null, arguments);
|
|
|
|
if (typeof actual != 'function') {
|
|
throw new Error(getErrorMsg('Actual is not a Function'));
|
|
}
|
|
|
|
let thrown;
|
|
|
|
try {
|
|
actual();
|
|
return fail('Expected function to throw an Error.');
|
|
} catch (e) {
|
|
thrown = e;
|
|
}
|
|
|
|
if (!j$.isError_(thrown)) {
|
|
return fail(function() {
|
|
return (
|
|
'Expected function to throw an Error, but it threw ' +
|
|
matchersUtil.pp(thrown) +
|
|
'.'
|
|
);
|
|
});
|
|
}
|
|
|
|
return errorMatcher.match(thrown);
|
|
}
|
|
};
|
|
|
|
function getMatcher() {
|
|
let expected, errorType;
|
|
|
|
if (arguments[2]) {
|
|
errorType = arguments[1];
|
|
expected = arguments[2];
|
|
if (!isAnErrorType(errorType)) {
|
|
throw new Error(getErrorMsg('Expected error type is not an Error.'));
|
|
}
|
|
|
|
return exactMatcher(expected, errorType);
|
|
} else if (arguments[1]) {
|
|
expected = arguments[1];
|
|
|
|
if (isAnErrorType(arguments[1])) {
|
|
return exactMatcher(null, arguments[1]);
|
|
} else {
|
|
return exactMatcher(arguments[1], null);
|
|
}
|
|
} else {
|
|
return anyMatcher();
|
|
}
|
|
}
|
|
|
|
function anyMatcher() {
|
|
return {
|
|
match: function(error) {
|
|
return pass(
|
|
'Expected function not to throw an Error, but it threw ' +
|
|
j$.fnNameFor(error) +
|
|
'.'
|
|
);
|
|
}
|
|
};
|
|
}
|
|
|
|
function exactMatcher(expected, errorType) {
|
|
if (expected && !isStringOrRegExp(expected)) {
|
|
if (errorType) {
|
|
throw new Error(
|
|
getErrorMsg('Expected error message is not a string or RegExp.')
|
|
);
|
|
} else {
|
|
throw new Error(
|
|
getErrorMsg('Expected is not an Error, string, or RegExp.')
|
|
);
|
|
}
|
|
}
|
|
|
|
function messageMatch(message) {
|
|
if (typeof expected == 'string') {
|
|
return expected == message;
|
|
} else {
|
|
return expected.test(message);
|
|
}
|
|
}
|
|
|
|
const errorTypeDescription = errorType
|
|
? j$.fnNameFor(errorType)
|
|
: 'an exception';
|
|
|
|
function thrownDescription(thrown) {
|
|
const thrownName = errorType
|
|
? j$.fnNameFor(thrown.constructor)
|
|
: 'an exception';
|
|
let thrownMessage = '';
|
|
|
|
if (expected) {
|
|
thrownMessage = ' with message ' + matchersUtil.pp(thrown.message);
|
|
}
|
|
|
|
return thrownName + thrownMessage;
|
|
}
|
|
|
|
function messageDescription() {
|
|
if (expected === null) {
|
|
return '';
|
|
} else if (expected instanceof RegExp) {
|
|
return ' with a message matching ' + matchersUtil.pp(expected);
|
|
} else {
|
|
return ' with message ' + matchersUtil.pp(expected);
|
|
}
|
|
}
|
|
|
|
function matches(error) {
|
|
return (
|
|
(errorType === null || error instanceof errorType) &&
|
|
(expected === null || messageMatch(error.message))
|
|
);
|
|
}
|
|
|
|
return {
|
|
match: function(thrown) {
|
|
if (matches(thrown)) {
|
|
return pass(function() {
|
|
return (
|
|
'Expected function not to throw ' +
|
|
errorTypeDescription +
|
|
messageDescription() +
|
|
'.'
|
|
);
|
|
});
|
|
} else {
|
|
return fail(function() {
|
|
return (
|
|
'Expected function to throw ' +
|
|
errorTypeDescription +
|
|
messageDescription() +
|
|
', but it threw ' +
|
|
thrownDescription(thrown) +
|
|
'.'
|
|
);
|
|
});
|
|
}
|
|
}
|
|
};
|
|
}
|
|
|
|
function isStringOrRegExp(potential) {
|
|
return potential instanceof RegExp || typeof potential == 'string';
|
|
}
|
|
|
|
function isAnErrorType(type) {
|
|
if (typeof type !== 'function') {
|
|
return false;
|
|
}
|
|
|
|
const Surrogate = function() {};
|
|
Surrogate.prototype = type.prototype;
|
|
return j$.isError_(new Surrogate());
|
|
}
|
|
}
|
|
|
|
function pass(message) {
|
|
return {
|
|
pass: true,
|
|
message: message
|
|
};
|
|
}
|
|
|
|
function fail(message) {
|
|
return {
|
|
pass: false,
|
|
message: message
|
|
};
|
|
}
|
|
|
|
return toThrowError;
|
|
};
|
|
|
|
getJasmineRequireObj().toThrowMatching = function(j$) {
|
|
const usageError = j$.formatErrorMsg(
|
|
'<toThrowMatching>',
|
|
'expect(function() {<expectation>}).toThrowMatching(<Predicate>)'
|
|
);
|
|
|
|
/**
|
|
* {@link expect} a function to `throw` something matching a predicate.
|
|
* @function
|
|
* @name matchers#toThrowMatching
|
|
* @since 3.0.0
|
|
* @param {Function} predicate - A function that takes the thrown exception as its parameter and returns true if it matches.
|
|
* @example
|
|
* expect(function() { throw new Error('nope'); }).toThrowMatching(function(thrown) { return thrown.message === 'nope'; });
|
|
*/
|
|
function toThrowMatching(matchersUtil) {
|
|
return {
|
|
compare: function(actual, predicate) {
|
|
if (typeof actual !== 'function') {
|
|
throw new Error(usageError('Actual is not a Function'));
|
|
}
|
|
|
|
if (typeof predicate !== 'function') {
|
|
throw new Error(usageError('Predicate is not a Function'));
|
|
}
|
|
|
|
let thrown;
|
|
|
|
try {
|
|
actual();
|
|
return fail('Expected function to throw an exception.');
|
|
} catch (e) {
|
|
thrown = e;
|
|
}
|
|
|
|
if (predicate(thrown)) {
|
|
return pass(
|
|
'Expected function not to throw an exception matching a predicate.'
|
|
);
|
|
} else {
|
|
return fail(function() {
|
|
return (
|
|
'Expected function to throw an exception matching a predicate, ' +
|
|
'but it threw ' +
|
|
thrownDescription(thrown) +
|
|
'.'
|
|
);
|
|
});
|
|
}
|
|
}
|
|
};
|
|
|
|
function thrownDescription(thrown) {
|
|
if (thrown && thrown.constructor) {
|
|
return (
|
|
j$.fnNameFor(thrown.constructor) +
|
|
' with message ' +
|
|
matchersUtil.pp(thrown.message)
|
|
);
|
|
} else {
|
|
return matchersUtil.pp(thrown);
|
|
}
|
|
}
|
|
}
|
|
|
|
function pass(message) {
|
|
return {
|
|
pass: true,
|
|
message: message
|
|
};
|
|
}
|
|
|
|
function fail(message) {
|
|
return {
|
|
pass: false,
|
|
message: message
|
|
};
|
|
}
|
|
|
|
return toThrowMatching;
|
|
};
|
|
|
|
getJasmineRequireObj().MockDate = function(j$) {
|
|
function MockDate(global) {
|
|
let currentTime = 0;
|
|
|
|
if (!global || !global.Date) {
|
|
this.install = function() {};
|
|
this.tick = function() {};
|
|
this.uninstall = function() {};
|
|
return this;
|
|
}
|
|
|
|
const GlobalDate = global.Date;
|
|
|
|
this.install = function(mockDate) {
|
|
if (mockDate instanceof GlobalDate) {
|
|
currentTime = mockDate.getTime();
|
|
} else {
|
|
if (!j$.util.isUndefined(mockDate)) {
|
|
throw new Error(
|
|
'The argument to jasmine.clock().mockDate(), if specified, ' +
|
|
'should be a Date instance.'
|
|
);
|
|
}
|
|
|
|
currentTime = new GlobalDate().getTime();
|
|
}
|
|
|
|
global.Date = FakeDate;
|
|
};
|
|
|
|
this.tick = function(millis) {
|
|
millis = millis || 0;
|
|
currentTime = currentTime + millis;
|
|
};
|
|
|
|
this.uninstall = function() {
|
|
currentTime = 0;
|
|
global.Date = GlobalDate;
|
|
};
|
|
|
|
createDateProperties();
|
|
|
|
return this;
|
|
|
|
function FakeDate() {
|
|
switch (arguments.length) {
|
|
case 0:
|
|
return new GlobalDate(currentTime);
|
|
case 1:
|
|
return new GlobalDate(arguments[0]);
|
|
case 2:
|
|
return new GlobalDate(arguments[0], arguments[1]);
|
|
case 3:
|
|
return new GlobalDate(arguments[0], arguments[1], arguments[2]);
|
|
case 4:
|
|
return new GlobalDate(
|
|
arguments[0],
|
|
arguments[1],
|
|
arguments[2],
|
|
arguments[3]
|
|
);
|
|
case 5:
|
|
return new GlobalDate(
|
|
arguments[0],
|
|
arguments[1],
|
|
arguments[2],
|
|
arguments[3],
|
|
arguments[4]
|
|
);
|
|
case 6:
|
|
return new GlobalDate(
|
|
arguments[0],
|
|
arguments[1],
|
|
arguments[2],
|
|
arguments[3],
|
|
arguments[4],
|
|
arguments[5]
|
|
);
|
|
default:
|
|
return new GlobalDate(
|
|
arguments[0],
|
|
arguments[1],
|
|
arguments[2],
|
|
arguments[3],
|
|
arguments[4],
|
|
arguments[5],
|
|
arguments[6]
|
|
);
|
|
}
|
|
}
|
|
|
|
function createDateProperties() {
|
|
FakeDate.prototype = GlobalDate.prototype;
|
|
|
|
FakeDate.now = function() {
|
|
return currentTime;
|
|
};
|
|
|
|
FakeDate.toSource = GlobalDate.toSource;
|
|
FakeDate.toString = GlobalDate.toString;
|
|
FakeDate.parse = GlobalDate.parse;
|
|
FakeDate.UTC = GlobalDate.UTC;
|
|
}
|
|
}
|
|
|
|
return MockDate;
|
|
};
|
|
|
|
getJasmineRequireObj().NeverSkipPolicy = function(j$) {
|
|
function NeverSkipPolicy(queueableFns) {}
|
|
|
|
NeverSkipPolicy.prototype.skipTo = function(lastRanFnIx) {
|
|
return lastRanFnIx + 1;
|
|
};
|
|
|
|
NeverSkipPolicy.prototype.fnErrored = function(fnIx) {};
|
|
|
|
return NeverSkipPolicy;
|
|
};
|
|
|
|
getJasmineRequireObj().makePrettyPrinter = function(j$) {
|
|
class SinglePrettyPrintRun {
|
|
constructor(customObjectFormatters, pp) {
|
|
this.customObjectFormatters_ = customObjectFormatters;
|
|
this.ppNestLevel_ = 0;
|
|
this.seen = [];
|
|
this.length = 0;
|
|
this.stringParts = [];
|
|
this.pp_ = pp;
|
|
}
|
|
|
|
format(value) {
|
|
this.ppNestLevel_++;
|
|
try {
|
|
const customFormatResult = this.applyCustomFormatters_(value);
|
|
|
|
if (customFormatResult) {
|
|
this.emitScalar(customFormatResult);
|
|
} else if (j$.util.isUndefined(value)) {
|
|
this.emitScalar('undefined');
|
|
} else if (value === null) {
|
|
this.emitScalar('null');
|
|
} else if (value === 0 && 1 / value === -Infinity) {
|
|
this.emitScalar('-0');
|
|
} else if (value === j$.getGlobal()) {
|
|
this.emitScalar('<global>');
|
|
} else if (value.jasmineToString) {
|
|
this.emitScalar(value.jasmineToString(this.pp_));
|
|
} else if (j$.isString_(value)) {
|
|
this.emitString(value);
|
|
} else if (j$.isSpy(value)) {
|
|
this.emitScalar('spy on ' + value.and.identity);
|
|
} else if (j$.isSpy(value.toString)) {
|
|
this.emitScalar('spy on ' + value.toString.and.identity);
|
|
} else if (value instanceof RegExp) {
|
|
this.emitScalar(value.toString());
|
|
} else if (typeof value === 'function') {
|
|
this.emitScalar('Function');
|
|
} else if (j$.isDomNode(value)) {
|
|
if (value.tagName) {
|
|
this.emitDomElement(value);
|
|
} else {
|
|
this.emitScalar('HTMLNode');
|
|
}
|
|
} else if (value instanceof Date) {
|
|
this.emitScalar('Date(' + value + ')');
|
|
} else if (j$.isSet(value)) {
|
|
this.emitSet(value);
|
|
} else if (j$.isMap(value)) {
|
|
this.emitMap(value);
|
|
} else if (j$.isTypedArray_(value)) {
|
|
this.emitTypedArray(value);
|
|
} else if (
|
|
value.toString &&
|
|
typeof value === 'object' &&
|
|
!j$.isArray_(value) &&
|
|
hasCustomToString(value)
|
|
) {
|
|
try {
|
|
this.emitScalar(value.toString());
|
|
} catch (e) {
|
|
this.emitScalar('has-invalid-toString-method');
|
|
}
|
|
} else if (this.seen.includes(value)) {
|
|
this.emitScalar(
|
|
'<circular reference: ' +
|
|
(j$.isArray_(value) ? 'Array' : 'Object') +
|
|
'>'
|
|
);
|
|
} else if (j$.isArray_(value) || j$.isA_('Object', value)) {
|
|
this.seen.push(value);
|
|
if (j$.isArray_(value)) {
|
|
this.emitArray(value);
|
|
} else {
|
|
this.emitObject(value);
|
|
}
|
|
this.seen.pop();
|
|
} else {
|
|
this.emitScalar(value.toString());
|
|
}
|
|
} catch (e) {
|
|
if (this.ppNestLevel_ > 1 || !(e instanceof MaxCharsReachedError)) {
|
|
throw e;
|
|
}
|
|
} finally {
|
|
this.ppNestLevel_--;
|
|
}
|
|
}
|
|
|
|
applyCustomFormatters_(value) {
|
|
return customFormat(value, this.customObjectFormatters_);
|
|
}
|
|
|
|
iterateObject(obj, fn) {
|
|
const objKeys = j$.MatchersUtil.keys(obj, j$.isArray_(obj));
|
|
const length = Math.min(objKeys.length, j$.MAX_PRETTY_PRINT_ARRAY_LENGTH);
|
|
|
|
for (let i = 0; i < length; i++) {
|
|
fn(objKeys[i]);
|
|
}
|
|
|
|
return objKeys.length > length;
|
|
}
|
|
|
|
emitScalar(value) {
|
|
this.append(value);
|
|
}
|
|
|
|
emitString(value) {
|
|
this.append("'" + value + "'");
|
|
}
|
|
|
|
emitArray(array) {
|
|
if (this.ppNestLevel_ > j$.MAX_PRETTY_PRINT_DEPTH) {
|
|
this.append('Array');
|
|
return;
|
|
}
|
|
|
|
const length = Math.min(array.length, j$.MAX_PRETTY_PRINT_ARRAY_LENGTH);
|
|
this.append('[ ');
|
|
|
|
for (let i = 0; i < length; i++) {
|
|
if (i > 0) {
|
|
this.append(', ');
|
|
}
|
|
this.format(array[i]);
|
|
}
|
|
if (array.length > length) {
|
|
this.append(', ...');
|
|
}
|
|
|
|
let first = array.length === 0;
|
|
const wasTruncated = this.iterateObject(array, property => {
|
|
if (first) {
|
|
first = false;
|
|
} else {
|
|
this.append(', ');
|
|
}
|
|
|
|
this.formatProperty(array, property);
|
|
});
|
|
|
|
if (wasTruncated) {
|
|
this.append(', ...');
|
|
}
|
|
|
|
this.append(' ]');
|
|
}
|
|
|
|
emitSet(set) {
|
|
if (this.ppNestLevel_ > j$.MAX_PRETTY_PRINT_DEPTH) {
|
|
this.append('Set');
|
|
return;
|
|
}
|
|
this.append('Set( ');
|
|
const size = Math.min(set.size, j$.MAX_PRETTY_PRINT_ARRAY_LENGTH);
|
|
let i = 0;
|
|
set.forEach(function(value, key) {
|
|
if (i >= size) {
|
|
return;
|
|
}
|
|
if (i > 0) {
|
|
this.append(', ');
|
|
}
|
|
this.format(value);
|
|
|
|
i++;
|
|
}, this);
|
|
if (set.size > size) {
|
|
this.append(', ...');
|
|
}
|
|
this.append(' )');
|
|
}
|
|
|
|
emitMap(map) {
|
|
if (this.ppNestLevel_ > j$.MAX_PRETTY_PRINT_DEPTH) {
|
|
this.append('Map');
|
|
return;
|
|
}
|
|
this.append('Map( ');
|
|
const size = Math.min(map.size, j$.MAX_PRETTY_PRINT_ARRAY_LENGTH);
|
|
let i = 0;
|
|
map.forEach(function(value, key) {
|
|
if (i >= size) {
|
|
return;
|
|
}
|
|
if (i > 0) {
|
|
this.append(', ');
|
|
}
|
|
this.format([key, value]);
|
|
|
|
i++;
|
|
}, this);
|
|
if (map.size > size) {
|
|
this.append(', ...');
|
|
}
|
|
this.append(' )');
|
|
}
|
|
|
|
emitObject(obj) {
|
|
const ctor = obj.constructor;
|
|
const constructorName =
|
|
typeof ctor === 'function' && obj instanceof ctor
|
|
? j$.fnNameFor(obj.constructor)
|
|
: 'null';
|
|
|
|
this.append(constructorName);
|
|
|
|
if (this.ppNestLevel_ > j$.MAX_PRETTY_PRINT_DEPTH) {
|
|
return;
|
|
}
|
|
|
|
this.append('({ ');
|
|
let first = true;
|
|
|
|
const wasTruncated = this.iterateObject(obj, property => {
|
|
if (first) {
|
|
first = false;
|
|
} else {
|
|
this.append(', ');
|
|
}
|
|
|
|
this.formatProperty(obj, property);
|
|
});
|
|
|
|
if (wasTruncated) {
|
|
this.append(', ...');
|
|
}
|
|
|
|
this.append(' })');
|
|
}
|
|
|
|
emitTypedArray(arr) {
|
|
const constructorName = j$.fnNameFor(arr.constructor);
|
|
const limitedArray = Array.prototype.slice.call(
|
|
arr,
|
|
0,
|
|
j$.MAX_PRETTY_PRINT_ARRAY_LENGTH
|
|
);
|
|
let itemsString = Array.prototype.join.call(limitedArray, ', ');
|
|
|
|
if (limitedArray.length !== arr.length) {
|
|
itemsString += ', ...';
|
|
}
|
|
|
|
this.append(constructorName + ' [ ' + itemsString + ' ]');
|
|
}
|
|
|
|
emitDomElement(el) {
|
|
const tagName = el.tagName.toLowerCase();
|
|
let out = '<' + tagName;
|
|
|
|
for (const attr of el.attributes) {
|
|
out += ' ' + attr.name;
|
|
|
|
if (attr.value !== '') {
|
|
out += '="' + attr.value + '"';
|
|
}
|
|
}
|
|
|
|
out += '>';
|
|
|
|
if (el.childElementCount !== 0 || el.textContent !== '') {
|
|
out += '...</' + tagName + '>';
|
|
}
|
|
|
|
this.append(out);
|
|
}
|
|
|
|
formatProperty(obj, property) {
|
|
if (typeof property === 'symbol') {
|
|
this.append(property.toString());
|
|
} else {
|
|
this.append(property);
|
|
}
|
|
|
|
this.append(': ');
|
|
this.format(obj[property]);
|
|
}
|
|
|
|
append(value) {
|
|
// This check protects us from the rare case where an object has overriden
|
|
// `toString()` with an invalid implementation (returning a non-string).
|
|
if (typeof value !== 'string') {
|
|
value = Object.prototype.toString.call(value);
|
|
}
|
|
|
|
const result = truncate(value, j$.MAX_PRETTY_PRINT_CHARS - this.length);
|
|
this.length += result.value.length;
|
|
this.stringParts.push(result.value);
|
|
|
|
if (result.truncated) {
|
|
throw new MaxCharsReachedError();
|
|
}
|
|
}
|
|
}
|
|
|
|
function hasCustomToString(value) {
|
|
// value.toString !== Object.prototype.toString if value has no custom toString but is from another context (e.g.
|
|
// iframe, web worker)
|
|
try {
|
|
return (
|
|
j$.isFunction_(value.toString) &&
|
|
value.toString !== Object.prototype.toString &&
|
|
value.toString() !== Object.prototype.toString.call(value)
|
|
);
|
|
} catch (e) {
|
|
// The custom toString() threw.
|
|
return true;
|
|
}
|
|
}
|
|
|
|
function truncate(s, maxlen) {
|
|
if (s.length <= maxlen) {
|
|
return { value: s, truncated: false };
|
|
}
|
|
|
|
s = s.substring(0, maxlen - 4) + ' ...';
|
|
return { value: s, truncated: true };
|
|
}
|
|
|
|
function MaxCharsReachedError() {
|
|
this.message =
|
|
'Exceeded ' +
|
|
j$.MAX_PRETTY_PRINT_CHARS +
|
|
' characters while pretty-printing a value';
|
|
}
|
|
|
|
MaxCharsReachedError.prototype = new Error();
|
|
|
|
function customFormat(value, customObjectFormatters) {
|
|
for (const formatter of customObjectFormatters) {
|
|
const result = formatter(value);
|
|
|
|
if (result !== undefined) {
|
|
return result;
|
|
}
|
|
}
|
|
}
|
|
|
|
return function(customObjectFormatters) {
|
|
customObjectFormatters = customObjectFormatters || [];
|
|
|
|
const pp = function(value) {
|
|
const prettyPrinter = new SinglePrettyPrintRun(
|
|
customObjectFormatters,
|
|
pp
|
|
);
|
|
prettyPrinter.format(value);
|
|
return prettyPrinter.stringParts.join('');
|
|
};
|
|
|
|
pp.customFormat_ = function(value) {
|
|
return customFormat(value, customObjectFormatters);
|
|
};
|
|
|
|
return pp;
|
|
};
|
|
};
|
|
|
|
getJasmineRequireObj().QueueRunner = function(j$) {
|
|
let nextid = 1;
|
|
|
|
function StopExecutionError() {}
|
|
StopExecutionError.prototype = new Error();
|
|
j$.StopExecutionError = StopExecutionError;
|
|
|
|
function once(fn, onTwice) {
|
|
let called = false;
|
|
return function(arg) {
|
|
if (called) {
|
|
if (onTwice) {
|
|
onTwice();
|
|
}
|
|
} else {
|
|
called = true;
|
|
// Direct call using single parameter, because cleanup/next does not need more
|
|
fn(arg);
|
|
}
|
|
return null;
|
|
};
|
|
}
|
|
|
|
function fallbackOnMultipleDone() {
|
|
console.error(
|
|
new Error(
|
|
"An asynchronous function called its 'done' " +
|
|
'callback more than once, in a QueueRunner without a onMultipleDone ' +
|
|
'handler.'
|
|
)
|
|
);
|
|
}
|
|
|
|
function emptyFn() {}
|
|
|
|
function QueueRunner(attrs) {
|
|
this.id_ = nextid++;
|
|
this.queueableFns = attrs.queueableFns || [];
|
|
this.onComplete = attrs.onComplete || emptyFn;
|
|
this.clearStack =
|
|
attrs.clearStack ||
|
|
function(fn) {
|
|
fn();
|
|
};
|
|
this.onException = attrs.onException || emptyFn;
|
|
this.onMultipleDone = attrs.onMultipleDone || fallbackOnMultipleDone;
|
|
this.userContext = attrs.userContext || new j$.UserContext();
|
|
this.timeout = attrs.timeout || {
|
|
setTimeout: setTimeout,
|
|
clearTimeout: clearTimeout
|
|
};
|
|
this.fail = attrs.fail || emptyFn;
|
|
this.globalErrors = attrs.globalErrors || {
|
|
pushListener: emptyFn,
|
|
popListener: emptyFn
|
|
};
|
|
|
|
const SkipPolicy = attrs.SkipPolicy || j$.NeverSkipPolicy;
|
|
this.skipPolicy_ = new SkipPolicy(this.queueableFns);
|
|
this.errored_ = false;
|
|
|
|
if (typeof this.onComplete !== 'function') {
|
|
throw new Error('invalid onComplete ' + JSON.stringify(this.onComplete));
|
|
}
|
|
this.deprecated = attrs.deprecated;
|
|
}
|
|
|
|
QueueRunner.prototype.execute = function() {
|
|
this.handleFinalError = (message, source, lineno, colno, error) => {
|
|
// Older browsers would send the error as the first parameter. HTML5
|
|
// specifies the the five parameters above. The error instance should
|
|
// be preffered, otherwise the call stack would get lost.
|
|
this.onException(error || message);
|
|
};
|
|
this.globalErrors.pushListener(this.handleFinalError);
|
|
this.run(0);
|
|
};
|
|
|
|
QueueRunner.prototype.clearTimeout = function(timeoutId) {
|
|
Function.prototype.apply.apply(this.timeout.clearTimeout, [
|
|
j$.getGlobal(),
|
|
[timeoutId]
|
|
]);
|
|
};
|
|
|
|
QueueRunner.prototype.setTimeout = function(fn, timeout) {
|
|
return Function.prototype.apply.apply(this.timeout.setTimeout, [
|
|
j$.getGlobal(),
|
|
[fn, timeout]
|
|
]);
|
|
};
|
|
|
|
QueueRunner.prototype.attempt = function attempt(iterativeIndex) {
|
|
let timeoutId;
|
|
let timedOut;
|
|
let completedSynchronously = true;
|
|
|
|
const onException = e => {
|
|
this.onException(e);
|
|
this.recordError_(iterativeIndex);
|
|
};
|
|
|
|
function handleError(error) {
|
|
// TODO probably shouldn't next() right away here.
|
|
// That makes debugging async failures much more confusing.
|
|
onException(error);
|
|
}
|
|
const cleanup = once(() => {
|
|
if (timeoutId !== void 0) {
|
|
this.clearTimeout(timeoutId);
|
|
}
|
|
this.globalErrors.popListener(handleError);
|
|
});
|
|
const next = once(
|
|
err => {
|
|
cleanup();
|
|
|
|
if (typeof err !== 'undefined') {
|
|
if (!(err instanceof StopExecutionError) && !err.jasmineMessage) {
|
|
this.fail(err);
|
|
}
|
|
this.recordError_(iterativeIndex);
|
|
}
|
|
|
|
const runNext = () => {
|
|
this.run(this.nextFnIx_(iterativeIndex));
|
|
};
|
|
|
|
if (completedSynchronously) {
|
|
this.setTimeout(runNext);
|
|
} else {
|
|
runNext();
|
|
}
|
|
},
|
|
() => {
|
|
try {
|
|
if (!timedOut) {
|
|
this.onMultipleDone();
|
|
}
|
|
} catch (error) {
|
|
// Any error we catch here is probably due to a bug in Jasmine,
|
|
// and it's not likely to end up anywhere useful if we let it
|
|
// propagate. Log it so it can at least show up when debugging.
|
|
console.error(error);
|
|
}
|
|
}
|
|
);
|
|
timedOut = false;
|
|
const queueableFn = this.queueableFns[iterativeIndex];
|
|
|
|
next.fail = function nextFail() {
|
|
this.fail.apply(null, arguments);
|
|
this.recordError_(iterativeIndex);
|
|
next();
|
|
}.bind(this);
|
|
|
|
this.globalErrors.pushListener(handleError);
|
|
|
|
if (queueableFn.timeout !== undefined) {
|
|
const timeoutInterval =
|
|
queueableFn.timeout || j$.DEFAULT_TIMEOUT_INTERVAL;
|
|
timeoutId = this.setTimeout(function() {
|
|
timedOut = true;
|
|
const error = new Error(
|
|
'Timeout - Async function did not complete within ' +
|
|
timeoutInterval +
|
|
'ms ' +
|
|
(queueableFn.timeout
|
|
? '(custom timeout)'
|
|
: '(set by jasmine.DEFAULT_TIMEOUT_INTERVAL)')
|
|
);
|
|
// TODO Need to decide what to do about a successful completion after a
|
|
// timeout. That should probably not be a deprecation, and maybe not
|
|
// an error in 4.0. (But a diagnostic of some sort might be helpful.)
|
|
onException(error);
|
|
next();
|
|
}, timeoutInterval);
|
|
}
|
|
|
|
try {
|
|
let maybeThenable;
|
|
|
|
if (queueableFn.fn.length === 0) {
|
|
maybeThenable = queueableFn.fn.call(this.userContext);
|
|
|
|
if (maybeThenable && j$.isFunction_(maybeThenable.then)) {
|
|
maybeThenable.then(
|
|
wrapInPromiseResolutionHandler(next),
|
|
onPromiseRejection
|
|
);
|
|
completedSynchronously = false;
|
|
return { completedSynchronously: false };
|
|
}
|
|
} else {
|
|
maybeThenable = queueableFn.fn.call(this.userContext, next);
|
|
this.diagnoseConflictingAsync_(queueableFn.fn, maybeThenable);
|
|
completedSynchronously = false;
|
|
return { completedSynchronously: false };
|
|
}
|
|
} catch (e) {
|
|
onException(e);
|
|
this.recordError_(iterativeIndex);
|
|
}
|
|
|
|
cleanup();
|
|
return { completedSynchronously: true };
|
|
|
|
function onPromiseRejection(e) {
|
|
onException(e);
|
|
next();
|
|
}
|
|
};
|
|
|
|
QueueRunner.prototype.run = function(recursiveIndex) {
|
|
const length = this.queueableFns.length;
|
|
|
|
for (
|
|
let iterativeIndex = recursiveIndex;
|
|
iterativeIndex < length;
|
|
iterativeIndex = this.nextFnIx_(iterativeIndex)
|
|
) {
|
|
const result = this.attempt(iterativeIndex);
|
|
|
|
if (!result.completedSynchronously) {
|
|
return;
|
|
}
|
|
}
|
|
|
|
this.clearStack(() => {
|
|
this.globalErrors.popListener(this.handleFinalError);
|
|
|
|
if (this.errored_) {
|
|
this.onComplete(new StopExecutionError());
|
|
} else {
|
|
this.onComplete();
|
|
}
|
|
});
|
|
};
|
|
|
|
QueueRunner.prototype.nextFnIx_ = function(currentFnIx) {
|
|
const result = this.skipPolicy_.skipTo(currentFnIx);
|
|
|
|
if (result === currentFnIx) {
|
|
throw new Error("Can't skip to the same queueable fn that just finished");
|
|
}
|
|
|
|
return result;
|
|
};
|
|
|
|
QueueRunner.prototype.recordError_ = function(currentFnIx) {
|
|
this.errored_ = true;
|
|
this.skipPolicy_.fnErrored(currentFnIx);
|
|
};
|
|
|
|
QueueRunner.prototype.diagnoseConflictingAsync_ = function(fn, retval) {
|
|
if (retval && j$.isFunction_(retval.then)) {
|
|
// Issue a warning that matches the user's code.
|
|
// Omit the stack trace because there's almost certainly no user code
|
|
// on the stack at this point.
|
|
if (j$.isAsyncFunction_(fn)) {
|
|
this.onException(
|
|
'An asynchronous before/it/after ' +
|
|
'function was defined with the async keyword but also took a ' +
|
|
'done callback. Either remove the done callback (recommended) or ' +
|
|
'remove the async keyword.'
|
|
);
|
|
} else {
|
|
this.onException(
|
|
'An asynchronous before/it/after ' +
|
|
'function took a done callback but also returned a promise. ' +
|
|
'Either remove the done callback (recommended) or change the ' +
|
|
'function to not return a promise.'
|
|
);
|
|
}
|
|
}
|
|
};
|
|
|
|
function wrapInPromiseResolutionHandler(fn) {
|
|
return function(maybeArg) {
|
|
if (j$.isError_(maybeArg)) {
|
|
fn(maybeArg);
|
|
} else {
|
|
fn();
|
|
}
|
|
};
|
|
}
|
|
|
|
return QueueRunner;
|
|
};
|
|
|
|
getJasmineRequireObj().ReportDispatcher = function(j$) {
|
|
function ReportDispatcher(methods, queueRunnerFactory, onLateError) {
|
|
const dispatchedMethods = methods || [];
|
|
|
|
for (const method of dispatchedMethods) {
|
|
this[method] = (function(m) {
|
|
return function() {
|
|
return dispatch(m, arguments);
|
|
};
|
|
})(method);
|
|
}
|
|
|
|
let reporters = [];
|
|
let fallbackReporter = null;
|
|
|
|
this.addReporter = function(reporter) {
|
|
reporters.push(reporter);
|
|
};
|
|
|
|
this.provideFallbackReporter = function(reporter) {
|
|
fallbackReporter = reporter;
|
|
};
|
|
|
|
this.clearReporters = function() {
|
|
reporters = [];
|
|
};
|
|
|
|
return this;
|
|
|
|
function dispatch(method, args) {
|
|
if (reporters.length === 0 && fallbackReporter !== null) {
|
|
reporters.push(fallbackReporter);
|
|
}
|
|
const fns = [];
|
|
for (const reporter of reporters) {
|
|
addFn(fns, reporter, method, args);
|
|
}
|
|
|
|
return new Promise(function(resolve) {
|
|
queueRunnerFactory({
|
|
queueableFns: fns,
|
|
onComplete: resolve,
|
|
isReporter: true,
|
|
onMultipleDone: function() {
|
|
onLateError(
|
|
new Error(
|
|
"An asynchronous reporter callback called its 'done' callback " +
|
|
'more than once.'
|
|
)
|
|
);
|
|
}
|
|
});
|
|
});
|
|
}
|
|
|
|
function addFn(fns, reporter, method, args) {
|
|
const fn = reporter[method];
|
|
if (!fn) {
|
|
return;
|
|
}
|
|
|
|
const thisArgs = j$.util.cloneArgs(args);
|
|
if (fn.length <= 1) {
|
|
fns.push({
|
|
fn: function() {
|
|
return fn.apply(reporter, thisArgs);
|
|
}
|
|
});
|
|
} else {
|
|
fns.push({
|
|
fn: function(done) {
|
|
return fn.apply(reporter, thisArgs.concat([done]));
|
|
}
|
|
});
|
|
}
|
|
}
|
|
}
|
|
|
|
return ReportDispatcher;
|
|
};
|
|
|
|
getJasmineRequireObj().interface = function(jasmine, env) {
|
|
const jasmineInterface = {
|
|
/**
|
|
* Callback passed to parts of the Jasmine base interface.
|
|
*
|
|
* By default Jasmine assumes this function completes synchronously.
|
|
* If you have code that you need to test asynchronously, you can declare that you receive a `done` callback, return a Promise, or use the `async` keyword if it is supported in your environment.
|
|
* @callback implementationCallback
|
|
* @param {Function} [done] Used to specify to Jasmine that this callback is asynchronous and Jasmine should wait until it has been called before moving on.
|
|
* @returns {} Optionally return a Promise instead of using `done` to cause Jasmine to wait for completion.
|
|
*/
|
|
|
|
/**
|
|
* Create a group of specs (often called a suite).
|
|
*
|
|
* Calls to `describe` can be nested within other calls to compose your suite as a tree.
|
|
* @name describe
|
|
* @since 1.3.0
|
|
* @function
|
|
* @global
|
|
* @param {String} description Textual description of the group
|
|
* @param {Function} specDefinitions Function for Jasmine to invoke that will define inner suites and specs
|
|
*/
|
|
describe: function(description, specDefinitions) {
|
|
return env.describe(description, specDefinitions);
|
|
},
|
|
|
|
/**
|
|
* A temporarily disabled [`describe`]{@link describe}
|
|
*
|
|
* Specs within an `xdescribe` will be marked pending and not executed
|
|
* @name xdescribe
|
|
* @since 1.3.0
|
|
* @function
|
|
* @global
|
|
* @param {String} description Textual description of the group
|
|
* @param {Function} specDefinitions Function for Jasmine to invoke that will define inner suites and specs
|
|
*/
|
|
xdescribe: function(description, specDefinitions) {
|
|
return env.xdescribe(description, specDefinitions);
|
|
},
|
|
|
|
/**
|
|
* A focused [`describe`]{@link describe}
|
|
*
|
|
* If suites or specs are focused, only those that are focused will be executed
|
|
* @see fit
|
|
* @name fdescribe
|
|
* @since 2.1.0
|
|
* @function
|
|
* @global
|
|
* @param {String} description Textual description of the group
|
|
* @param {Function} specDefinitions Function for Jasmine to invoke that will define inner suites and specs
|
|
*/
|
|
fdescribe: function(description, specDefinitions) {
|
|
return env.fdescribe(description, specDefinitions);
|
|
},
|
|
|
|
/**
|
|
* Define a single spec. A spec should contain one or more {@link expect|expectations} that test the state of the code.
|
|
*
|
|
* A spec whose expectations all succeed will be passing and a spec with any failures will fail.
|
|
* The name `it` is a pronoun for the test target, not an abbreviation of anything. It makes the
|
|
* spec more readable by connecting the function name `it` and the argument `description` as a
|
|
* complete sentence.
|
|
* @name it
|
|
* @since 1.3.0
|
|
* @function
|
|
* @global
|
|
* @param {String} description Textual description of what this spec is checking
|
|
* @param {implementationCallback} [testFunction] Function that contains the code of your test. If not provided the test will be `pending`.
|
|
* @param {Int} [timeout={@link jasmine.DEFAULT_TIMEOUT_INTERVAL}] Custom timeout for an async spec.
|
|
* @see async
|
|
*/
|
|
it: function() {
|
|
return env.it.apply(env, arguments);
|
|
},
|
|
|
|
/**
|
|
* A temporarily disabled [`it`]{@link it}
|
|
*
|
|
* The spec will report as `pending` and will not be executed.
|
|
* @name xit
|
|
* @since 1.3.0
|
|
* @function
|
|
* @global
|
|
* @param {String} description Textual description of what this spec is checking.
|
|
* @param {implementationCallback} [testFunction] Function that contains the code of your test. Will not be executed.
|
|
*/
|
|
xit: function() {
|
|
return env.xit.apply(env, arguments);
|
|
},
|
|
|
|
/**
|
|
* A focused [`it`]{@link it}
|
|
*
|
|
* If suites or specs are focused, only those that are focused will be executed.
|
|
* @name fit
|
|
* @since 2.1.0
|
|
* @function
|
|
* @global
|
|
* @param {String} description Textual description of what this spec is checking.
|
|
* @param {implementationCallback} testFunction Function that contains the code of your test.
|
|
* @param {Int} [timeout={@link jasmine.DEFAULT_TIMEOUT_INTERVAL}] Custom timeout for an async spec.
|
|
* @see async
|
|
*/
|
|
fit: function() {
|
|
return env.fit.apply(env, arguments);
|
|
},
|
|
|
|
/**
|
|
* Run some shared setup before each of the specs in the {@link describe} in which it is called.
|
|
* @name beforeEach
|
|
* @since 1.3.0
|
|
* @function
|
|
* @global
|
|
* @param {implementationCallback} [function] Function that contains the code to setup your specs.
|
|
* @param {Int} [timeout={@link jasmine.DEFAULT_TIMEOUT_INTERVAL}] Custom timeout for an async beforeEach.
|
|
* @see async
|
|
*/
|
|
beforeEach: function() {
|
|
return env.beforeEach.apply(env, arguments);
|
|
},
|
|
|
|
/**
|
|
* Run some shared teardown after each of the specs in the {@link describe} in which it is called.
|
|
* @name afterEach
|
|
* @since 1.3.0
|
|
* @function
|
|
* @global
|
|
* @param {implementationCallback} [function] Function that contains the code to teardown your specs.
|
|
* @param {Int} [timeout={@link jasmine.DEFAULT_TIMEOUT_INTERVAL}] Custom timeout for an async afterEach.
|
|
* @see async
|
|
*/
|
|
afterEach: function() {
|
|
return env.afterEach.apply(env, arguments);
|
|
},
|
|
|
|
/**
|
|
* Run some shared setup once before all of the specs in the {@link describe} are run.
|
|
*
|
|
* _Note:_ Be careful, sharing the setup from a beforeAll makes it easy to accidentally leak state between your specs so that they erroneously pass or fail.
|
|
* @name beforeAll
|
|
* @since 2.1.0
|
|
* @function
|
|
* @global
|
|
* @param {implementationCallback} [function] Function that contains the code to setup your specs.
|
|
* @param {Int} [timeout={@link jasmine.DEFAULT_TIMEOUT_INTERVAL}] Custom timeout for an async beforeAll.
|
|
* @see async
|
|
*/
|
|
beforeAll: function() {
|
|
return env.beforeAll.apply(env, arguments);
|
|
},
|
|
|
|
/**
|
|
* Run some shared teardown once after all of the specs in the {@link describe} are run.
|
|
*
|
|
* _Note:_ Be careful, sharing the teardown from a afterAll makes it easy to accidentally leak state between your specs so that they erroneously pass or fail.
|
|
* @name afterAll
|
|
* @since 2.1.0
|
|
* @function
|
|
* @global
|
|
* @param {implementationCallback} [function] Function that contains the code to teardown your specs.
|
|
* @param {Int} [timeout={@link jasmine.DEFAULT_TIMEOUT_INTERVAL}] Custom timeout for an async afterAll.
|
|
* @see async
|
|
*/
|
|
afterAll: function() {
|
|
return env.afterAll.apply(env, arguments);
|
|
},
|
|
|
|
/**
|
|
* Sets a user-defined property that will be provided to reporters as part of the properties field of {@link SpecResult}
|
|
* @name setSpecProperty
|
|
* @since 3.6.0
|
|
* @function
|
|
* @param {String} key The name of the property
|
|
* @param {*} value The value of the property
|
|
*/
|
|
setSpecProperty: function(key, value) {
|
|
return env.setSpecProperty(key, value);
|
|
},
|
|
|
|
/**
|
|
* Sets a user-defined property that will be provided to reporters as part of the properties field of {@link SuiteResult}
|
|
* @name setSuiteProperty
|
|
* @since 3.6.0
|
|
* @function
|
|
* @param {String} key The name of the property
|
|
* @param {*} value The value of the property
|
|
*/
|
|
setSuiteProperty: function(key, value) {
|
|
return env.setSuiteProperty(key, value);
|
|
},
|
|
|
|
/**
|
|
* Create an expectation for a spec.
|
|
* @name expect
|
|
* @since 1.3.0
|
|
* @function
|
|
* @global
|
|
* @param {Object} actual - Actual computed value to test expectations against.
|
|
* @return {matchers}
|
|
*/
|
|
expect: function(actual) {
|
|
return env.expect(actual);
|
|
},
|
|
|
|
/**
|
|
* Create an asynchronous expectation for a spec. Note that the matchers
|
|
* that are provided by an asynchronous expectation all return promises
|
|
* which must be either returned from the spec or waited for using `await`
|
|
* in order for Jasmine to associate them with the correct spec.
|
|
* @name expectAsync
|
|
* @since 3.3.0
|
|
* @function
|
|
* @global
|
|
* @param {Object} actual - Actual computed value to test expectations against.
|
|
* @return {async-matchers}
|
|
* @example
|
|
* await expectAsync(somePromise).toBeResolved();
|
|
* @example
|
|
* return expectAsync(somePromise).toBeResolved();
|
|
*/
|
|
expectAsync: function(actual) {
|
|
return env.expectAsync(actual);
|
|
},
|
|
|
|
/**
|
|
* Mark a spec as pending, expectation results will be ignored.
|
|
* @name pending
|
|
* @since 2.0.0
|
|
* @function
|
|
* @global
|
|
* @param {String} [message] - Reason the spec is pending.
|
|
*/
|
|
pending: function() {
|
|
return env.pending.apply(env, arguments);
|
|
},
|
|
|
|
/**
|
|
* Explicitly mark a spec as failed.
|
|
* @name fail
|
|
* @since 2.1.0
|
|
* @function
|
|
* @global
|
|
* @param {String|Error} [error] - Reason for the failure.
|
|
*/
|
|
fail: function() {
|
|
return env.fail.apply(env, arguments);
|
|
},
|
|
|
|
/**
|
|
* Install a spy onto an existing object.
|
|
* @name spyOn
|
|
* @since 1.3.0
|
|
* @function
|
|
* @global
|
|
* @param {Object} obj - The object upon which to install the {@link Spy}.
|
|
* @param {String} methodName - The name of the method to replace with a {@link Spy}.
|
|
* @returns {Spy}
|
|
*/
|
|
spyOn: function(obj, methodName) {
|
|
return env.spyOn(obj, methodName);
|
|
},
|
|
|
|
/**
|
|
* Install a spy on a property installed with `Object.defineProperty` onto an existing object.
|
|
* @name spyOnProperty
|
|
* @since 2.6.0
|
|
* @function
|
|
* @global
|
|
* @param {Object} obj - The object upon which to install the {@link Spy}
|
|
* @param {String} propertyName - The name of the property to replace with a {@link Spy}.
|
|
* @param {String} [accessType=get] - The access type (get|set) of the property to {@link Spy} on.
|
|
* @returns {Spy}
|
|
*/
|
|
spyOnProperty: function(obj, methodName, accessType) {
|
|
return env.spyOnProperty(obj, methodName, accessType);
|
|
},
|
|
|
|
/**
|
|
* Installs spies on all writable and configurable properties of an object.
|
|
* @name spyOnAllFunctions
|
|
* @since 3.2.1
|
|
* @function
|
|
* @global
|
|
* @param {Object} obj - The object upon which to install the {@link Spy}s
|
|
* @param {boolean} includeNonEnumerable - Whether or not to add spies to non-enumerable properties
|
|
* @returns {Object} the spied object
|
|
*/
|
|
spyOnAllFunctions: function(obj, includeNonEnumerable) {
|
|
return env.spyOnAllFunctions(obj, includeNonEnumerable);
|
|
},
|
|
|
|
jsApiReporter: new jasmine.JsApiReporter({
|
|
timer: new jasmine.Timer()
|
|
}),
|
|
|
|
/**
|
|
* @namespace jasmine
|
|
*/
|
|
jasmine: jasmine
|
|
};
|
|
|
|
/**
|
|
* Add a custom equality tester for the current scope of specs.
|
|
*
|
|
* _Note:_ This is only callable from within a {@link beforeEach}, {@link it}, or {@link beforeAll}.
|
|
* @name jasmine.addCustomEqualityTester
|
|
* @since 2.0.0
|
|
* @function
|
|
* @param {Function} tester - A function which takes two arguments to compare and returns a `true` or `false` comparison result if it knows how to compare them, and `undefined` otherwise.
|
|
* @see custom_equality
|
|
*/
|
|
jasmine.addCustomEqualityTester = function(tester) {
|
|
env.addCustomEqualityTester(tester);
|
|
};
|
|
|
|
/**
|
|
* Add custom matchers for the current scope of specs.
|
|
*
|
|
* _Note:_ This is only callable from within a {@link beforeEach}, {@link it}, or {@link beforeAll}.
|
|
* @name jasmine.addMatchers
|
|
* @since 2.0.0
|
|
* @function
|
|
* @param {Object} matchers - Keys from this object will be the new matcher names.
|
|
* @see custom_matcher
|
|
*/
|
|
jasmine.addMatchers = function(matchers) {
|
|
return env.addMatchers(matchers);
|
|
};
|
|
|
|
/**
|
|
* Add custom async matchers for the current scope of specs.
|
|
*
|
|
* _Note:_ This is only callable from within a {@link beforeEach}, {@link it}, or {@link beforeAll}.
|
|
* @name jasmine.addAsyncMatchers
|
|
* @since 3.5.0
|
|
* @function
|
|
* @param {Object} matchers - Keys from this object will be the new async matcher names.
|
|
* @see custom_matcher
|
|
*/
|
|
jasmine.addAsyncMatchers = function(matchers) {
|
|
return env.addAsyncMatchers(matchers);
|
|
};
|
|
|
|
/**
|
|
* Add a custom object formatter for the current scope of specs.
|
|
*
|
|
* _Note:_ This is only callable from within a {@link beforeEach}, {@link it}, or {@link beforeAll}.
|
|
* @name jasmine.addCustomObjectFormatter
|
|
* @since 3.6.0
|
|
* @function
|
|
* @param {Function} formatter - A function which takes a value to format and returns a string if it knows how to format it, and `undefined` otherwise.
|
|
* @see custom_object_formatters
|
|
*/
|
|
jasmine.addCustomObjectFormatter = function(formatter) {
|
|
return env.addCustomObjectFormatter(formatter);
|
|
};
|
|
|
|
/**
|
|
* Get the currently booted mock {Clock} for this Jasmine environment.
|
|
* @name jasmine.clock
|
|
* @since 2.0.0
|
|
* @function
|
|
* @returns {Clock}
|
|
*/
|
|
jasmine.clock = function() {
|
|
return env.clock;
|
|
};
|
|
|
|
/**
|
|
* Create a bare {@link Spy} object. This won't be installed anywhere and will not have any implementation behind it.
|
|
* @name jasmine.createSpy
|
|
* @since 1.3.0
|
|
* @function
|
|
* @param {String} [name] - Name to give the spy. This will be displayed in failure messages.
|
|
* @param {Function} [originalFn] - Function to act as the real implementation.
|
|
* @return {Spy}
|
|
*/
|
|
jasmine.createSpy = function(name, originalFn) {
|
|
return env.createSpy(name, originalFn);
|
|
};
|
|
|
|
/**
|
|
* Create an object with multiple {@link Spy}s as its members.
|
|
* @name jasmine.createSpyObj
|
|
* @since 1.3.0
|
|
* @function
|
|
* @param {String} [baseName] - Base name for the spies in the object.
|
|
* @param {String[]|Object} methodNames - Array of method names to create spies for, or Object whose keys will be method names and values the {@link Spy#and#returnValue|returnValue}.
|
|
* @param {String[]|Object} [propertyNames] - Array of property names to create spies for, or Object whose keys will be propertynames and values the {@link Spy#and#returnValue|returnValue}.
|
|
* @return {Object}
|
|
*/
|
|
jasmine.createSpyObj = function(baseName, methodNames, propertyNames) {
|
|
return env.createSpyObj(baseName, methodNames, propertyNames);
|
|
};
|
|
|
|
/**
|
|
* Add a custom spy strategy for the current scope of specs.
|
|
*
|
|
* _Note:_ This is only callable from within a {@link beforeEach}, {@link it}, or {@link beforeAll}.
|
|
* @name jasmine.addSpyStrategy
|
|
* @since 3.5.0
|
|
* @function
|
|
* @param {String} name - The name of the strategy (i.e. what you call from `and`)
|
|
* @param {Function} factory - Factory function that returns the plan to be executed.
|
|
*/
|
|
jasmine.addSpyStrategy = function(name, factory) {
|
|
return env.addSpyStrategy(name, factory);
|
|
};
|
|
|
|
/**
|
|
* Set the default spy strategy for the current scope of specs.
|
|
*
|
|
* _Note:_ This is only callable from within a {@link beforeEach}, {@link it}, or {@link beforeAll}.
|
|
* @name jasmine.setDefaultSpyStrategy
|
|
* @function
|
|
* @param {Function} defaultStrategyFn - a function that assigns a strategy
|
|
* @example
|
|
* beforeEach(function() {
|
|
* jasmine.setDefaultSpyStrategy(and => and.returnValue(true));
|
|
* });
|
|
*/
|
|
jasmine.setDefaultSpyStrategy = function(defaultStrategyFn) {
|
|
return env.setDefaultSpyStrategy(defaultStrategyFn);
|
|
};
|
|
|
|
return jasmineInterface;
|
|
};
|
|
|
|
getJasmineRequireObj().RunableResources = function(j$) {
|
|
class RunableResources {
|
|
constructor(options) {
|
|
this.byRunableId_ = {};
|
|
this.getCurrentRunableId_ = options.getCurrentRunableId;
|
|
this.globalErrors_ = options.globalErrors;
|
|
|
|
this.spyFactory = new j$.SpyFactory(
|
|
() => {
|
|
if (this.getCurrentRunableId_()) {
|
|
return this.customSpyStrategies();
|
|
} else {
|
|
return {};
|
|
}
|
|
},
|
|
() => this.defaultSpyStrategy(),
|
|
() => this.makeMatchersUtil()
|
|
);
|
|
|
|
this.spyRegistry = new j$.SpyRegistry({
|
|
currentSpies: () => this.spies(),
|
|
createSpy: (name, originalFn) =>
|
|
this.spyFactory.createSpy(name, originalFn)
|
|
});
|
|
}
|
|
|
|
initForRunable(runableId, parentId) {
|
|
const newRes = (this.byRunableId_[runableId] = {
|
|
customEqualityTesters: [],
|
|
customMatchers: {},
|
|
customAsyncMatchers: {},
|
|
customSpyStrategies: {},
|
|
customObjectFormatters: [],
|
|
defaultSpyStrategy: undefined,
|
|
spies: []
|
|
});
|
|
|
|
const parentRes = this.byRunableId_[parentId];
|
|
|
|
if (parentRes) {
|
|
newRes.defaultSpyStrategy = parentRes.defaultSpyStrategy;
|
|
const toClone = [
|
|
'customEqualityTesters',
|
|
'customMatchers',
|
|
'customAsyncMatchers',
|
|
'customObjectFormatters',
|
|
'customSpyStrategies'
|
|
];
|
|
|
|
for (const k of toClone) {
|
|
newRes[k] = j$.util.clone(parentRes[k]);
|
|
}
|
|
}
|
|
}
|
|
|
|
clearForRunable(runableId) {
|
|
this.globalErrors_.removeOverrideListener();
|
|
this.spyRegistry.clearSpies();
|
|
delete this.byRunableId_[runableId];
|
|
}
|
|
|
|
spies() {
|
|
return this.forCurrentRunable_(
|
|
'Spies must be created in a before function or a spec'
|
|
).spies;
|
|
}
|
|
|
|
defaultSpyStrategy() {
|
|
if (!this.getCurrentRunableId_()) {
|
|
return undefined;
|
|
}
|
|
|
|
return this.byRunableId_[this.getCurrentRunableId_()].defaultSpyStrategy;
|
|
}
|
|
|
|
setDefaultSpyStrategy(fn) {
|
|
this.forCurrentRunable_(
|
|
'Default spy strategy must be set in a before function or a spec'
|
|
).defaultSpyStrategy = fn;
|
|
}
|
|
|
|
customSpyStrategies() {
|
|
return this.forCurrentRunable_(
|
|
'Custom spy strategies must be added in a before function or a spec'
|
|
).customSpyStrategies;
|
|
}
|
|
|
|
customEqualityTesters() {
|
|
return this.forCurrentRunable_(
|
|
'Custom Equalities must be added in a before function or a spec'
|
|
).customEqualityTesters;
|
|
}
|
|
|
|
customMatchers() {
|
|
return this.forCurrentRunable_(
|
|
'Matchers must be added in a before function or a spec'
|
|
).customMatchers;
|
|
}
|
|
|
|
addCustomMatchers(matchersToAdd) {
|
|
const matchers = this.customMatchers();
|
|
|
|
for (const name in matchersToAdd) {
|
|
matchers[name] = matchersToAdd[name];
|
|
}
|
|
}
|
|
|
|
customAsyncMatchers() {
|
|
return this.forCurrentRunable_(
|
|
'Async Matchers must be added in a before function or a spec'
|
|
).customAsyncMatchers;
|
|
}
|
|
|
|
addCustomAsyncMatchers(matchersToAdd) {
|
|
const matchers = this.customAsyncMatchers();
|
|
|
|
for (const name in matchersToAdd) {
|
|
matchers[name] = matchersToAdd[name];
|
|
}
|
|
}
|
|
|
|
customObjectFormatters() {
|
|
return this.forCurrentRunable_(
|
|
'Custom object formatters must be added in a before function or a spec'
|
|
).customObjectFormatters;
|
|
}
|
|
|
|
makePrettyPrinter() {
|
|
return j$.makePrettyPrinter(this.customObjectFormatters());
|
|
}
|
|
|
|
makeMatchersUtil() {
|
|
if (this.getCurrentRunableId_()) {
|
|
return new j$.MatchersUtil({
|
|
customTesters: this.customEqualityTesters(),
|
|
pp: this.makePrettyPrinter()
|
|
});
|
|
} else {
|
|
return new j$.MatchersUtil({ pp: j$.basicPrettyPrinter_ });
|
|
}
|
|
}
|
|
|
|
forCurrentRunable_(errorMsg) {
|
|
const resources = this.byRunableId_[this.getCurrentRunableId_()];
|
|
|
|
if (!resources && errorMsg) {
|
|
throw new Error(errorMsg);
|
|
}
|
|
|
|
return resources;
|
|
}
|
|
}
|
|
|
|
return RunableResources;
|
|
};
|
|
|
|
getJasmineRequireObj().Runner = function(j$) {
|
|
class Runner {
|
|
constructor(options) {
|
|
this.topSuite_ = options.topSuite;
|
|
this.totalSpecsDefined_ = options.totalSpecsDefined;
|
|
this.focusedRunables_ = options.focusedRunables;
|
|
this.runableResources_ = options.runableResources;
|
|
this.queueRunnerFactory_ = options.queueRunnerFactory;
|
|
this.reporter_ = options.reporter;
|
|
this.getConfig_ = options.getConfig;
|
|
this.reportSpecDone_ = options.reportSpecDone;
|
|
this.hasFailures = false;
|
|
this.executedBefore_ = false;
|
|
|
|
this.currentlyExecutingSuites_ = [];
|
|
this.currentSpec = null;
|
|
}
|
|
|
|
currentRunable() {
|
|
return this.currentSpec || this.currentSuite();
|
|
}
|
|
|
|
currentSuite() {
|
|
return this.currentlyExecutingSuites_[
|
|
this.currentlyExecutingSuites_.length - 1
|
|
];
|
|
}
|
|
|
|
// Although execute returns a promise, it isn't async for backwards
|
|
// compatibility: The "Invalid order" exception needs to be propagated
|
|
// synchronously from Env#execute.
|
|
// TODO: make this and Env#execute async in the next major release
|
|
execute(runablesToRun) {
|
|
if (this.executedBefore_) {
|
|
this.topSuite_.reset();
|
|
}
|
|
this.executedBefore_ = true;
|
|
|
|
this.hasFailures = false;
|
|
const focusedRunables = this.focusedRunables_();
|
|
const config = this.getConfig_();
|
|
|
|
if (!runablesToRun) {
|
|
if (focusedRunables.length) {
|
|
runablesToRun = focusedRunables;
|
|
} else {
|
|
runablesToRun = [this.topSuite_.id];
|
|
}
|
|
}
|
|
|
|
const order = new j$.Order({
|
|
random: config.random,
|
|
seed: j$.isNumber_(config.seed) ? config.seed + '' : config.seed
|
|
});
|
|
|
|
const processor = new j$.TreeProcessor({
|
|
tree: this.topSuite_,
|
|
runnableIds: runablesToRun,
|
|
queueRunnerFactory: options => {
|
|
if (options.isLeaf) {
|
|
// A spec
|
|
options.SkipPolicy = j$.CompleteOnFirstErrorSkipPolicy;
|
|
} else {
|
|
// A suite
|
|
if (config.stopOnSpecFailure) {
|
|
options.SkipPolicy = j$.CompleteOnFirstErrorSkipPolicy;
|
|
} else {
|
|
options.SkipPolicy = j$.SkipAfterBeforeAllErrorPolicy;
|
|
}
|
|
}
|
|
|
|
return this.queueRunnerFactory_(options);
|
|
},
|
|
failSpecWithNoExpectations: config.failSpecWithNoExpectations,
|
|
nodeStart: (suite, next) => {
|
|
this.currentlyExecutingSuites_.push(suite);
|
|
this.runableResources_.initForRunable(suite.id, suite.parentSuite.id);
|
|
this.reporter_.suiteStarted(suite.result).then(next);
|
|
suite.startTimer();
|
|
},
|
|
nodeComplete: (suite, result, next) => {
|
|
if (suite !== this.currentSuite()) {
|
|
throw new Error('Tried to complete the wrong suite');
|
|
}
|
|
|
|
this.runableResources_.clearForRunable(suite.id);
|
|
this.currentlyExecutingSuites_.pop();
|
|
|
|
if (result.status === 'failed') {
|
|
this.hasFailures = true;
|
|
}
|
|
suite.endTimer();
|
|
|
|
if (suite.hadBeforeAllFailure) {
|
|
this.reportChildrenOfBeforeAllFailure_(suite).then(() => {
|
|
this.reportSuiteDone_(suite, result, next);
|
|
});
|
|
} else {
|
|
this.reportSuiteDone_(suite, result, next);
|
|
}
|
|
},
|
|
orderChildren: function(node) {
|
|
return order.sort(node.children);
|
|
},
|
|
excludeNode: function(spec) {
|
|
return !config.specFilter(spec);
|
|
}
|
|
});
|
|
|
|
if (!processor.processTree().valid) {
|
|
throw new Error(
|
|
'Invalid order: would cause a beforeAll or afterAll to be run multiple times'
|
|
);
|
|
}
|
|
|
|
return this.execute2_(runablesToRun, order, processor);
|
|
}
|
|
|
|
async execute2_(runablesToRun, order, processor) {
|
|
const totalSpecsDefined = this.totalSpecsDefined_();
|
|
|
|
this.runableResources_.initForRunable(this.topSuite_.id);
|
|
const jasmineTimer = new j$.Timer();
|
|
jasmineTimer.start();
|
|
|
|
/**
|
|
* Information passed to the {@link Reporter#jasmineStarted} event.
|
|
* @typedef JasmineStartedInfo
|
|
* @property {Int} totalSpecsDefined - The total number of specs defined in this suite.
|
|
* @property {Order} order - Information about the ordering (random or not) of this execution of the suite.
|
|
* @since 2.0.0
|
|
*/
|
|
await this.reporter_.jasmineStarted({
|
|
totalSpecsDefined,
|
|
order: order
|
|
});
|
|
|
|
this.currentlyExecutingSuites_.push(this.topSuite_);
|
|
await processor.execute();
|
|
|
|
if (this.topSuite_.hadBeforeAllFailure) {
|
|
await this.reportChildrenOfBeforeAllFailure_(this.topSuite_);
|
|
}
|
|
|
|
this.runableResources_.clearForRunable(this.topSuite_.id);
|
|
this.currentlyExecutingSuites_.pop();
|
|
let overallStatus, incompleteReason;
|
|
|
|
if (
|
|
this.hasFailures ||
|
|
this.topSuite_.result.failedExpectations.length > 0
|
|
) {
|
|
overallStatus = 'failed';
|
|
} else if (this.focusedRunables_().length > 0) {
|
|
overallStatus = 'incomplete';
|
|
incompleteReason = 'fit() or fdescribe() was found';
|
|
} else if (totalSpecsDefined === 0) {
|
|
overallStatus = 'incomplete';
|
|
incompleteReason = 'No specs found';
|
|
} else {
|
|
overallStatus = 'passed';
|
|
}
|
|
|
|
/**
|
|
* Information passed to the {@link Reporter#jasmineDone} event.
|
|
* @typedef JasmineDoneInfo
|
|
* @property {OverallStatus} overallStatus - The overall result of the suite: 'passed', 'failed', or 'incomplete'.
|
|
* @property {Int} totalTime - The total time (in ms) that it took to execute the suite
|
|
* @property {IncompleteReason} incompleteReason - Explanation of why the suite was incomplete.
|
|
* @property {Order} order - Information about the ordering (random or not) of this execution of the suite.
|
|
* @property {Expectation[]} failedExpectations - List of expectations that failed in an {@link afterAll} at the global level.
|
|
* @property {Expectation[]} deprecationWarnings - List of deprecation warnings that occurred at the global level.
|
|
* @since 2.4.0
|
|
*/
|
|
const jasmineDoneInfo = {
|
|
overallStatus: overallStatus,
|
|
totalTime: jasmineTimer.elapsed(),
|
|
incompleteReason: incompleteReason,
|
|
order: order,
|
|
failedExpectations: this.topSuite_.result.failedExpectations,
|
|
deprecationWarnings: this.topSuite_.result.deprecationWarnings
|
|
};
|
|
this.topSuite_.reportedDone = true;
|
|
await this.reporter_.jasmineDone(jasmineDoneInfo);
|
|
return jasmineDoneInfo;
|
|
}
|
|
|
|
reportSuiteDone_(suite, result, next) {
|
|
suite.reportedDone = true;
|
|
this.reporter_.suiteDone(result).then(next);
|
|
}
|
|
|
|
async reportChildrenOfBeforeAllFailure_(suite) {
|
|
for (const child of suite.children) {
|
|
if (child instanceof j$.Suite) {
|
|
await this.reporter_.suiteStarted(child.result);
|
|
await this.reportChildrenOfBeforeAllFailure_(child);
|
|
|
|
// Marking the suite passed is consistent with how suites that
|
|
// contain failed specs but no suite-level failures are reported.
|
|
child.result.status = 'passed';
|
|
|
|
await this.reporter_.suiteDone(child.result);
|
|
} else {
|
|
/* a spec */
|
|
await this.reporter_.specStarted(child.result);
|
|
|
|
child.addExpectationResult(
|
|
false,
|
|
{
|
|
passed: false,
|
|
message:
|
|
'Not run because a beforeAll function failed. The ' +
|
|
'beforeAll failure will be reported on the suite that ' +
|
|
'caused it.'
|
|
},
|
|
true
|
|
);
|
|
child.result.status = 'failed';
|
|
|
|
await new Promise(resolve => {
|
|
this.reportSpecDone_(child, child.result, resolve);
|
|
});
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
return Runner;
|
|
};
|
|
|
|
getJasmineRequireObj().SkipAfterBeforeAllErrorPolicy = function(j$) {
|
|
function SkipAfterBeforeAllErrorPolicy(queueableFns) {
|
|
this.queueableFns_ = queueableFns;
|
|
this.skipping_ = false;
|
|
}
|
|
|
|
SkipAfterBeforeAllErrorPolicy.prototype.skipTo = function(lastRanFnIx) {
|
|
if (this.skipping_) {
|
|
return this.nextAfterAllAfter_(lastRanFnIx);
|
|
} else {
|
|
return lastRanFnIx + 1;
|
|
}
|
|
};
|
|
|
|
SkipAfterBeforeAllErrorPolicy.prototype.nextAfterAllAfter_ = function(i) {
|
|
for (
|
|
i++;
|
|
i < this.queueableFns_.length &&
|
|
this.queueableFns_[i].type !== 'afterAll';
|
|
i++
|
|
) {}
|
|
return i;
|
|
};
|
|
|
|
SkipAfterBeforeAllErrorPolicy.prototype.fnErrored = function(fnIx) {
|
|
if (this.queueableFns_[fnIx].type === 'beforeAll') {
|
|
this.skipping_ = true;
|
|
// Failures need to be reported for each contained spec. But we can't do
|
|
// that from here because reporting is async. This function isn't async
|
|
// (and can't be without greatly complicating QueueRunner). Mark the
|
|
// failure so that the code that reports the suite result (which is
|
|
// already async) can detect the failure and report the specs.
|
|
this.queueableFns_[fnIx].suite.hadBeforeAllFailure = true;
|
|
}
|
|
};
|
|
|
|
return SkipAfterBeforeAllErrorPolicy;
|
|
};
|
|
|
|
getJasmineRequireObj().Spy = function(j$) {
|
|
const nextOrder = (function() {
|
|
let order = 0;
|
|
|
|
return function() {
|
|
return order++;
|
|
};
|
|
})();
|
|
|
|
/**
|
|
* @classdesc _Note:_ Do not construct this directly. Use {@link spyOn},
|
|
* {@link spyOnProperty}, {@link jasmine.createSpy}, or
|
|
* {@link jasmine.createSpyObj} instead.
|
|
* @class Spy
|
|
* @hideconstructor
|
|
*/
|
|
function Spy(name, matchersUtil, optionals) {
|
|
const spy = function(context, args, invokeNew) {
|
|
/**
|
|
* @name Spy.callData
|
|
* @property {object} object - `this` context for the invocation.
|
|
* @property {number} invocationOrder - Order of the invocation.
|
|
* @property {Array} args - The arguments passed for this invocation.
|
|
* @property returnValue - The value that was returned from this invocation.
|
|
*/
|
|
const callData = {
|
|
object: context,
|
|
invocationOrder: nextOrder(),
|
|
args: Array.prototype.slice.apply(args)
|
|
};
|
|
|
|
callTracker.track(callData);
|
|
const returnValue = strategyDispatcher.exec(context, args, invokeNew);
|
|
callData.returnValue = returnValue;
|
|
|
|
return returnValue;
|
|
};
|
|
const { originalFn, customStrategies, defaultStrategyFn } = optionals || {};
|
|
|
|
const numArgs = typeof originalFn === 'function' ? originalFn.length : 0,
|
|
wrapper = makeFunc(numArgs, function(context, args, invokeNew) {
|
|
return spy(context, args, invokeNew);
|
|
}),
|
|
strategyDispatcher = new SpyStrategyDispatcher(
|
|
{
|
|
name: name,
|
|
fn: originalFn,
|
|
getSpy: function() {
|
|
return wrapper;
|
|
},
|
|
customStrategies: customStrategies
|
|
},
|
|
matchersUtil
|
|
),
|
|
callTracker = new j$.CallTracker();
|
|
|
|
function makeFunc(length, fn) {
|
|
switch (length) {
|
|
case 1:
|
|
return function wrap1(a) {
|
|
return fn(this, arguments, this instanceof wrap1);
|
|
};
|
|
case 2:
|
|
return function wrap2(a, b) {
|
|
return fn(this, arguments, this instanceof wrap2);
|
|
};
|
|
case 3:
|
|
return function wrap3(a, b, c) {
|
|
return fn(this, arguments, this instanceof wrap3);
|
|
};
|
|
case 4:
|
|
return function wrap4(a, b, c, d) {
|
|
return fn(this, arguments, this instanceof wrap4);
|
|
};
|
|
case 5:
|
|
return function wrap5(a, b, c, d, e) {
|
|
return fn(this, arguments, this instanceof wrap5);
|
|
};
|
|
case 6:
|
|
return function wrap6(a, b, c, d, e, f) {
|
|
return fn(this, arguments, this instanceof wrap6);
|
|
};
|
|
case 7:
|
|
return function wrap7(a, b, c, d, e, f, g) {
|
|
return fn(this, arguments, this instanceof wrap7);
|
|
};
|
|
case 8:
|
|
return function wrap8(a, b, c, d, e, f, g, h) {
|
|
return fn(this, arguments, this instanceof wrap8);
|
|
};
|
|
case 9:
|
|
return function wrap9(a, b, c, d, e, f, g, h, i) {
|
|
return fn(this, arguments, this instanceof wrap9);
|
|
};
|
|
default:
|
|
return function wrap() {
|
|
return fn(this, arguments, this instanceof wrap);
|
|
};
|
|
}
|
|
}
|
|
|
|
for (const prop in originalFn) {
|
|
if (prop === 'and' || prop === 'calls') {
|
|
throw new Error(
|
|
"Jasmine spies would overwrite the 'and' and 'calls' properties on the object being spied upon"
|
|
);
|
|
}
|
|
|
|
wrapper[prop] = originalFn[prop];
|
|
}
|
|
|
|
/**
|
|
* @member {SpyStrategy} - Accesses the default strategy for the spy. This strategy will be used
|
|
* whenever the spy is called with arguments that don't match any strategy
|
|
* created with {@link Spy#withArgs}.
|
|
* @name Spy#and
|
|
* @since 2.0.0
|
|
* @example
|
|
* spyOn(someObj, 'func').and.returnValue(42);
|
|
*/
|
|
wrapper.and = strategyDispatcher.and;
|
|
/**
|
|
* Specifies a strategy to be used for calls to the spy that have the
|
|
* specified arguments.
|
|
* @name Spy#withArgs
|
|
* @since 3.0.0
|
|
* @function
|
|
* @param {...*} args - The arguments to match
|
|
* @type {SpyStrategy}
|
|
* @example
|
|
* spyOn(someObj, 'func').withArgs(1, 2, 3).and.returnValue(42);
|
|
* someObj.func(1, 2, 3); // returns 42
|
|
*/
|
|
wrapper.withArgs = function() {
|
|
return strategyDispatcher.withArgs.apply(strategyDispatcher, arguments);
|
|
};
|
|
wrapper.calls = callTracker;
|
|
|
|
if (defaultStrategyFn) {
|
|
defaultStrategyFn(wrapper.and);
|
|
}
|
|
|
|
return wrapper;
|
|
}
|
|
|
|
function SpyStrategyDispatcher(strategyArgs, matchersUtil) {
|
|
const baseStrategy = new j$.SpyStrategy(strategyArgs);
|
|
const argsStrategies = new StrategyDict(function() {
|
|
return new j$.SpyStrategy(strategyArgs);
|
|
}, matchersUtil);
|
|
|
|
this.and = baseStrategy;
|
|
|
|
this.exec = function(spy, args, invokeNew) {
|
|
let strategy = argsStrategies.get(args);
|
|
|
|
if (!strategy) {
|
|
if (argsStrategies.any() && !baseStrategy.isConfigured()) {
|
|
throw new Error(
|
|
"Spy '" +
|
|
strategyArgs.name +
|
|
"' received a call with arguments " +
|
|
j$.basicPrettyPrinter_(Array.prototype.slice.call(args)) +
|
|
' but all configured strategies specify other arguments.'
|
|
);
|
|
} else {
|
|
strategy = baseStrategy;
|
|
}
|
|
}
|
|
|
|
return strategy.exec(spy, args, invokeNew);
|
|
};
|
|
|
|
this.withArgs = function() {
|
|
return { and: argsStrategies.getOrCreate(arguments) };
|
|
};
|
|
}
|
|
|
|
function StrategyDict(strategyFactory, matchersUtil) {
|
|
this.strategies = [];
|
|
this.strategyFactory = strategyFactory;
|
|
this.matchersUtil = matchersUtil;
|
|
}
|
|
|
|
StrategyDict.prototype.any = function() {
|
|
return this.strategies.length > 0;
|
|
};
|
|
|
|
StrategyDict.prototype.getOrCreate = function(args) {
|
|
let strategy = this.get(args);
|
|
|
|
if (!strategy) {
|
|
strategy = this.strategyFactory();
|
|
this.strategies.push({
|
|
args: args,
|
|
strategy: strategy
|
|
});
|
|
}
|
|
|
|
return strategy;
|
|
};
|
|
|
|
StrategyDict.prototype.get = function(args) {
|
|
for (let i = 0; i < this.strategies.length; i++) {
|
|
if (this.matchersUtil.equals(args, this.strategies[i].args)) {
|
|
return this.strategies[i].strategy;
|
|
}
|
|
}
|
|
};
|
|
|
|
return Spy;
|
|
};
|
|
|
|
getJasmineRequireObj().SpyFactory = function(j$) {
|
|
function SpyFactory(
|
|
getCustomStrategies,
|
|
getDefaultStrategyFn,
|
|
getMatchersUtil
|
|
) {
|
|
this.createSpy = function(name, originalFn) {
|
|
if (j$.isFunction_(name) && originalFn === undefined) {
|
|
originalFn = name;
|
|
name = originalFn.name;
|
|
}
|
|
|
|
return j$.Spy(name, getMatchersUtil(), {
|
|
originalFn,
|
|
customStrategies: getCustomStrategies(),
|
|
defaultStrategyFn: getDefaultStrategyFn()
|
|
});
|
|
};
|
|
|
|
this.createSpyObj = function(baseName, methodNames, propertyNames) {
|
|
const baseNameIsCollection =
|
|
j$.isObject_(baseName) || j$.isArray_(baseName);
|
|
|
|
if (baseNameIsCollection) {
|
|
propertyNames = methodNames;
|
|
methodNames = baseName;
|
|
baseName = 'unknown';
|
|
}
|
|
|
|
const obj = {};
|
|
|
|
const methods = normalizeKeyValues(methodNames);
|
|
for (let i = 0; i < methods.length; i++) {
|
|
const spy = (obj[methods[i][0]] = this.createSpy(
|
|
baseName + '.' + methods[i][0]
|
|
));
|
|
if (methods[i].length > 1) {
|
|
spy.and.returnValue(methods[i][1]);
|
|
}
|
|
}
|
|
|
|
const properties = normalizeKeyValues(propertyNames);
|
|
for (let i = 0; i < properties.length; i++) {
|
|
const descriptor = {
|
|
enumerable: true,
|
|
get: this.createSpy(baseName + '.' + properties[i][0] + '.get'),
|
|
set: this.createSpy(baseName + '.' + properties[i][0] + '.set')
|
|
};
|
|
if (properties[i].length > 1) {
|
|
descriptor.get.and.returnValue(properties[i][1]);
|
|
descriptor.set.and.returnValue(properties[i][1]);
|
|
}
|
|
Object.defineProperty(obj, properties[i][0], descriptor);
|
|
}
|
|
|
|
if (methods.length === 0 && properties.length === 0) {
|
|
throw 'createSpyObj requires a non-empty array or object of method names to create spies for';
|
|
}
|
|
|
|
return obj;
|
|
};
|
|
}
|
|
|
|
function normalizeKeyValues(object) {
|
|
const result = [];
|
|
if (j$.isArray_(object)) {
|
|
for (let i = 0; i < object.length; i++) {
|
|
result.push([object[i]]);
|
|
}
|
|
} else if (j$.isObject_(object)) {
|
|
for (const key in object) {
|
|
if (object.hasOwnProperty(key)) {
|
|
result.push([key, object[key]]);
|
|
}
|
|
}
|
|
}
|
|
return result;
|
|
}
|
|
|
|
return SpyFactory;
|
|
};
|
|
|
|
getJasmineRequireObj().SpyRegistry = function(j$) {
|
|
const spyOnMsg = j$.formatErrorMsg(
|
|
'<spyOn>',
|
|
'spyOn(<object>, <methodName>)'
|
|
);
|
|
const spyOnPropertyMsg = j$.formatErrorMsg(
|
|
'<spyOnProperty>',
|
|
'spyOnProperty(<object>, <propName>, [accessType])'
|
|
);
|
|
|
|
function SpyRegistry(options) {
|
|
options = options || {};
|
|
const global = options.global || j$.getGlobal();
|
|
const createSpy = options.createSpy;
|
|
const currentSpies =
|
|
options.currentSpies ||
|
|
function() {
|
|
return [];
|
|
};
|
|
|
|
this.allowRespy = function(allow) {
|
|
this.respy = allow;
|
|
};
|
|
|
|
this.spyOn = function(obj, methodName) {
|
|
const getErrorMsg = spyOnMsg;
|
|
|
|
if (j$.util.isUndefined(obj) || obj === null) {
|
|
throw new Error(
|
|
getErrorMsg(
|
|
'could not find an object to spy upon for ' + methodName + '()'
|
|
)
|
|
);
|
|
}
|
|
|
|
if (j$.util.isUndefined(methodName) || methodName === null) {
|
|
throw new Error(getErrorMsg('No method name supplied'));
|
|
}
|
|
|
|
if (j$.util.isUndefined(obj[methodName])) {
|
|
throw new Error(getErrorMsg(methodName + '() method does not exist'));
|
|
}
|
|
|
|
if (obj[methodName] && j$.isSpy(obj[methodName])) {
|
|
if (this.respy) {
|
|
return obj[methodName];
|
|
} else {
|
|
throw new Error(
|
|
getErrorMsg(methodName + ' has already been spied upon')
|
|
);
|
|
}
|
|
}
|
|
|
|
const descriptor = Object.getOwnPropertyDescriptor(obj, methodName);
|
|
|
|
if (descriptor && !(descriptor.writable || descriptor.set)) {
|
|
throw new Error(
|
|
getErrorMsg(methodName + ' is not declared writable or has no setter')
|
|
);
|
|
}
|
|
|
|
const originalMethod = obj[methodName];
|
|
const spiedMethod = createSpy(methodName, originalMethod);
|
|
let restoreStrategy;
|
|
|
|
if (
|
|
Object.prototype.hasOwnProperty.call(obj, methodName) ||
|
|
(obj === global && methodName === 'onerror')
|
|
) {
|
|
restoreStrategy = function() {
|
|
obj[methodName] = originalMethod;
|
|
};
|
|
} else {
|
|
restoreStrategy = function() {
|
|
if (!delete obj[methodName]) {
|
|
obj[methodName] = originalMethod;
|
|
}
|
|
};
|
|
}
|
|
|
|
currentSpies().push({
|
|
restoreObjectToOriginalState: restoreStrategy
|
|
});
|
|
|
|
obj[methodName] = spiedMethod;
|
|
|
|
return spiedMethod;
|
|
};
|
|
|
|
this.spyOnProperty = function(obj, propertyName, accessType) {
|
|
const getErrorMsg = spyOnPropertyMsg;
|
|
|
|
accessType = accessType || 'get';
|
|
|
|
if (j$.util.isUndefined(obj)) {
|
|
throw new Error(
|
|
getErrorMsg(
|
|
'spyOn could not find an object to spy upon for ' +
|
|
propertyName +
|
|
''
|
|
)
|
|
);
|
|
}
|
|
|
|
if (j$.util.isUndefined(propertyName)) {
|
|
throw new Error(getErrorMsg('No property name supplied'));
|
|
}
|
|
|
|
const descriptor = j$.util.getPropertyDescriptor(obj, propertyName);
|
|
|
|
if (!descriptor) {
|
|
throw new Error(getErrorMsg(propertyName + ' property does not exist'));
|
|
}
|
|
|
|
if (!descriptor.configurable) {
|
|
throw new Error(
|
|
getErrorMsg(propertyName + ' is not declared configurable')
|
|
);
|
|
}
|
|
|
|
if (!descriptor[accessType]) {
|
|
throw new Error(
|
|
getErrorMsg(
|
|
'Property ' +
|
|
propertyName +
|
|
' does not have access type ' +
|
|
accessType
|
|
)
|
|
);
|
|
}
|
|
|
|
if (j$.isSpy(descriptor[accessType])) {
|
|
if (this.respy) {
|
|
return descriptor[accessType];
|
|
} else {
|
|
throw new Error(
|
|
getErrorMsg(
|
|
propertyName + '#' + accessType + ' has already been spied upon'
|
|
)
|
|
);
|
|
}
|
|
}
|
|
|
|
const originalDescriptor = j$.util.clone(descriptor);
|
|
const spy = createSpy(propertyName, descriptor[accessType]);
|
|
let restoreStrategy;
|
|
|
|
if (Object.prototype.hasOwnProperty.call(obj, propertyName)) {
|
|
restoreStrategy = function() {
|
|
Object.defineProperty(obj, propertyName, originalDescriptor);
|
|
};
|
|
} else {
|
|
restoreStrategy = function() {
|
|
delete obj[propertyName];
|
|
};
|
|
}
|
|
|
|
currentSpies().push({
|
|
restoreObjectToOriginalState: restoreStrategy
|
|
});
|
|
|
|
descriptor[accessType] = spy;
|
|
|
|
Object.defineProperty(obj, propertyName, descriptor);
|
|
|
|
return spy;
|
|
};
|
|
|
|
this.spyOnAllFunctions = function(obj, includeNonEnumerable) {
|
|
if (j$.util.isUndefined(obj)) {
|
|
throw new Error(
|
|
'spyOnAllFunctions could not find an object to spy upon'
|
|
);
|
|
}
|
|
|
|
let pointer = obj,
|
|
propsToSpyOn = [],
|
|
properties,
|
|
propertiesToSkip = [];
|
|
|
|
while (
|
|
pointer &&
|
|
(!includeNonEnumerable || pointer !== Object.prototype)
|
|
) {
|
|
properties = getProps(pointer, includeNonEnumerable);
|
|
properties = properties.filter(function(prop) {
|
|
return propertiesToSkip.indexOf(prop) === -1;
|
|
});
|
|
propertiesToSkip = propertiesToSkip.concat(properties);
|
|
propsToSpyOn = propsToSpyOn.concat(
|
|
getSpyableFunctionProps(pointer, properties)
|
|
);
|
|
pointer = Object.getPrototypeOf(pointer);
|
|
}
|
|
|
|
for (const prop of propsToSpyOn) {
|
|
this.spyOn(obj, prop);
|
|
}
|
|
|
|
return obj;
|
|
};
|
|
|
|
this.clearSpies = function() {
|
|
const spies = currentSpies();
|
|
for (let i = spies.length - 1; i >= 0; i--) {
|
|
const spyEntry = spies[i];
|
|
spyEntry.restoreObjectToOriginalState();
|
|
}
|
|
};
|
|
}
|
|
|
|
function getProps(obj, includeNonEnumerable) {
|
|
const enumerableProperties = Object.keys(obj);
|
|
|
|
if (!includeNonEnumerable) {
|
|
return enumerableProperties;
|
|
}
|
|
|
|
return Object.getOwnPropertyNames(obj).filter(function(prop) {
|
|
return (
|
|
prop !== 'constructor' ||
|
|
enumerableProperties.indexOf('constructor') > -1
|
|
);
|
|
});
|
|
}
|
|
|
|
function getSpyableFunctionProps(obj, propertiesToCheck) {
|
|
const props = [];
|
|
|
|
for (const prop of propertiesToCheck) {
|
|
if (
|
|
Object.prototype.hasOwnProperty.call(obj, prop) &&
|
|
isSpyableProp(obj, prop)
|
|
) {
|
|
props.push(prop);
|
|
}
|
|
}
|
|
return props;
|
|
}
|
|
|
|
function isSpyableProp(obj, prop) {
|
|
let value;
|
|
try {
|
|
value = obj[prop];
|
|
} catch (e) {
|
|
return false;
|
|
}
|
|
|
|
if (value instanceof Function) {
|
|
const descriptor = Object.getOwnPropertyDescriptor(obj, prop);
|
|
return (descriptor.writable || descriptor.set) && descriptor.configurable;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
return SpyRegistry;
|
|
};
|
|
|
|
getJasmineRequireObj().SpyStrategy = function(j$) {
|
|
/**
|
|
* @interface SpyStrategy
|
|
*/
|
|
function SpyStrategy(options) {
|
|
options = options || {};
|
|
|
|
/**
|
|
* Get the identifying information for the spy.
|
|
* @name SpyStrategy#identity
|
|
* @since 3.0.0
|
|
* @member
|
|
* @type {String}
|
|
*/
|
|
this.identity = options.name || 'unknown';
|
|
this.originalFn = options.fn || function() {};
|
|
this.getSpy = options.getSpy || function() {};
|
|
this.plan = this._defaultPlan = function() {};
|
|
|
|
const cs = options.customStrategies || {};
|
|
for (const k in cs) {
|
|
if (j$.util.has(cs, k) && !this[k]) {
|
|
this[k] = createCustomPlan(cs[k]);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Tell the spy to return a promise resolving to the specified value when invoked.
|
|
* @name SpyStrategy#resolveTo
|
|
* @since 3.5.0
|
|
* @function
|
|
* @param {*} value The value to return.
|
|
*/
|
|
this.resolveTo = function(value) {
|
|
this.plan = function() {
|
|
return Promise.resolve(value);
|
|
};
|
|
return this.getSpy();
|
|
};
|
|
|
|
/**
|
|
* Tell the spy to return a promise rejecting with the specified value when invoked.
|
|
* @name SpyStrategy#rejectWith
|
|
* @since 3.5.0
|
|
* @function
|
|
* @param {*} value The value to return.
|
|
*/
|
|
this.rejectWith = function(value) {
|
|
this.plan = function() {
|
|
return Promise.reject(value);
|
|
};
|
|
return this.getSpy();
|
|
};
|
|
}
|
|
|
|
function createCustomPlan(factory) {
|
|
return function() {
|
|
const plan = factory.apply(null, arguments);
|
|
|
|
if (!j$.isFunction_(plan)) {
|
|
throw new Error('Spy strategy must return a function');
|
|
}
|
|
|
|
this.plan = plan;
|
|
return this.getSpy();
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Execute the current spy strategy.
|
|
* @name SpyStrategy#exec
|
|
* @since 2.0.0
|
|
* @function
|
|
*/
|
|
SpyStrategy.prototype.exec = function(context, args, invokeNew) {
|
|
const contextArgs = [context].concat(
|
|
args ? Array.prototype.slice.call(args) : []
|
|
);
|
|
const target = this.plan.bind.apply(this.plan, contextArgs);
|
|
|
|
return invokeNew ? new target() : target();
|
|
};
|
|
|
|
/**
|
|
* Tell the spy to call through to the real implementation when invoked.
|
|
* @name SpyStrategy#callThrough
|
|
* @since 2.0.0
|
|
* @function
|
|
*/
|
|
SpyStrategy.prototype.callThrough = function() {
|
|
this.plan = this.originalFn;
|
|
return this.getSpy();
|
|
};
|
|
|
|
/**
|
|
* Tell the spy to return the value when invoked.
|
|
* @name SpyStrategy#returnValue
|
|
* @since 2.0.0
|
|
* @function
|
|
* @param {*} value The value to return.
|
|
*/
|
|
SpyStrategy.prototype.returnValue = function(value) {
|
|
this.plan = function() {
|
|
return value;
|
|
};
|
|
return this.getSpy();
|
|
};
|
|
|
|
/**
|
|
* Tell the spy to return one of the specified values (sequentially) each time the spy is invoked.
|
|
* @name SpyStrategy#returnValues
|
|
* @since 2.1.0
|
|
* @function
|
|
* @param {...*} values - Values to be returned on subsequent calls to the spy.
|
|
*/
|
|
SpyStrategy.prototype.returnValues = function() {
|
|
const values = Array.prototype.slice.call(arguments);
|
|
this.plan = function() {
|
|
return values.shift();
|
|
};
|
|
return this.getSpy();
|
|
};
|
|
|
|
/**
|
|
* Tell the spy to throw an error when invoked.
|
|
* @name SpyStrategy#throwError
|
|
* @since 2.0.0
|
|
* @function
|
|
* @param {Error|Object|String} something Thing to throw
|
|
*/
|
|
SpyStrategy.prototype.throwError = function(something) {
|
|
const error = j$.isString_(something) ? new Error(something) : something;
|
|
this.plan = function() {
|
|
throw error;
|
|
};
|
|
return this.getSpy();
|
|
};
|
|
|
|
/**
|
|
* Tell the spy to call a fake implementation when invoked.
|
|
* @name SpyStrategy#callFake
|
|
* @since 2.0.0
|
|
* @function
|
|
* @param {Function} fn The function to invoke with the passed parameters.
|
|
*/
|
|
SpyStrategy.prototype.callFake = function(fn) {
|
|
if (
|
|
!(
|
|
j$.isFunction_(fn) ||
|
|
j$.isAsyncFunction_(fn) ||
|
|
j$.isGeneratorFunction_(fn)
|
|
)
|
|
) {
|
|
throw new Error(
|
|
'Argument passed to callFake should be a function, got ' + fn
|
|
);
|
|
}
|
|
this.plan = fn;
|
|
return this.getSpy();
|
|
};
|
|
|
|
/**
|
|
* Tell the spy to do nothing when invoked. This is the default.
|
|
* @name SpyStrategy#stub
|
|
* @since 2.0.0
|
|
* @function
|
|
*/
|
|
SpyStrategy.prototype.stub = function(fn) {
|
|
this.plan = function() {};
|
|
return this.getSpy();
|
|
};
|
|
|
|
SpyStrategy.prototype.isConfigured = function() {
|
|
return this.plan !== this._defaultPlan;
|
|
};
|
|
|
|
return SpyStrategy;
|
|
};
|
|
|
|
getJasmineRequireObj().StackTrace = function(j$) {
|
|
function StackTrace(error) {
|
|
let lines = error.stack.split('\n').filter(function(line) {
|
|
return line !== '';
|
|
});
|
|
|
|
const extractResult = extractMessage(error.message, lines);
|
|
|
|
if (extractResult) {
|
|
this.message = extractResult.message;
|
|
lines = extractResult.remainder;
|
|
}
|
|
|
|
const parseResult = tryParseFrames(lines);
|
|
this.frames = parseResult.frames;
|
|
this.style = parseResult.style;
|
|
}
|
|
|
|
const framePatterns = [
|
|
// Node, Chrome, Edge
|
|
// e.g. " at QueueRunner.run (http://localhost:8888/__jasmine__/jasmine.js:4320:20)"
|
|
// Note that the "function name" can include a surprisingly large set of
|
|
// characters, including angle brackets and square brackets.
|
|
{
|
|
re: /^\s*at ([^\)]+) \(([^\)]+)\)$/,
|
|
fnIx: 1,
|
|
fileLineColIx: 2,
|
|
style: 'v8'
|
|
},
|
|
|
|
// NodeJS alternate form, often mixed in with the Chrome style
|
|
// e.g. " at /some/path:4320:20
|
|
{ re: /\s*at (.+)$/, fileLineColIx: 1, style: 'v8' },
|
|
|
|
// PhantomJS on OS X, Safari, Firefox
|
|
// e.g. "run@http://localhost:8888/__jasmine__/jasmine.js:4320:27"
|
|
// or "http://localhost:8888/__jasmine__/jasmine.js:4320:27"
|
|
{
|
|
re: /^(?:(([^@\s]+)@)|@)?([^\s]+)$/,
|
|
fnIx: 2,
|
|
fileLineColIx: 3,
|
|
style: 'webkit'
|
|
}
|
|
];
|
|
|
|
// regexes should capture the function name (if any) as group 1
|
|
// and the file, line, and column as group 2.
|
|
function tryParseFrames(lines) {
|
|
let style = null;
|
|
const frames = lines.map(function(line) {
|
|
const convertedLine = first(framePatterns, function(pattern) {
|
|
const overallMatch = line.match(pattern.re);
|
|
if (!overallMatch) {
|
|
return null;
|
|
}
|
|
|
|
const fileLineColMatch = overallMatch[pattern.fileLineColIx].match(
|
|
/^(.*):(\d+):\d+$/
|
|
);
|
|
if (!fileLineColMatch) {
|
|
return null;
|
|
}
|
|
|
|
style = style || pattern.style;
|
|
return {
|
|
raw: line,
|
|
file: fileLineColMatch[1],
|
|
line: parseInt(fileLineColMatch[2], 10),
|
|
func: overallMatch[pattern.fnIx]
|
|
};
|
|
});
|
|
|
|
return convertedLine || { raw: line };
|
|
});
|
|
|
|
return {
|
|
style: style,
|
|
frames: frames
|
|
};
|
|
}
|
|
|
|
function first(items, fn) {
|
|
for (const item of items) {
|
|
const result = fn(item);
|
|
|
|
if (result) {
|
|
return result;
|
|
}
|
|
}
|
|
}
|
|
|
|
function extractMessage(message, stackLines) {
|
|
const len = messagePrefixLength(message, stackLines);
|
|
|
|
if (len > 0) {
|
|
return {
|
|
message: stackLines.slice(0, len).join('\n'),
|
|
remainder: stackLines.slice(len)
|
|
};
|
|
}
|
|
}
|
|
|
|
function messagePrefixLength(message, stackLines) {
|
|
if (!stackLines[0].match(/^\w*Error/)) {
|
|
return 0;
|
|
}
|
|
|
|
const messageLines = message.split('\n');
|
|
|
|
for (let i = 1; i < messageLines.length; i++) {
|
|
if (messageLines[i] !== stackLines[i]) {
|
|
return 0;
|
|
}
|
|
}
|
|
|
|
return messageLines.length;
|
|
}
|
|
|
|
return StackTrace;
|
|
};
|
|
|
|
getJasmineRequireObj().Suite = function(j$) {
|
|
function Suite(attrs) {
|
|
this.env = attrs.env;
|
|
this.id = attrs.id;
|
|
this.parentSuite = attrs.parentSuite;
|
|
this.description = attrs.description;
|
|
this.expectationFactory = attrs.expectationFactory;
|
|
this.asyncExpectationFactory = attrs.asyncExpectationFactory;
|
|
this.throwOnExpectationFailure = !!attrs.throwOnExpectationFailure;
|
|
this.autoCleanClosures =
|
|
attrs.autoCleanClosures === undefined ? true : !!attrs.autoCleanClosures;
|
|
this.onLateError = attrs.onLateError || function() {};
|
|
|
|
this.beforeFns = [];
|
|
this.afterFns = [];
|
|
this.beforeAllFns = [];
|
|
this.afterAllFns = [];
|
|
this.timer = attrs.timer || new j$.Timer();
|
|
this.children = [];
|
|
|
|
this.reset();
|
|
}
|
|
|
|
Suite.prototype.setSuiteProperty = function(key, value) {
|
|
this.result.properties = this.result.properties || {};
|
|
this.result.properties[key] = value;
|
|
};
|
|
|
|
Suite.prototype.expect = function(actual) {
|
|
return this.expectationFactory(actual, this);
|
|
};
|
|
|
|
Suite.prototype.expectAsync = function(actual) {
|
|
return this.asyncExpectationFactory(actual, this);
|
|
};
|
|
|
|
Suite.prototype.getFullName = function() {
|
|
const fullName = [];
|
|
for (
|
|
let parentSuite = this;
|
|
parentSuite;
|
|
parentSuite = parentSuite.parentSuite
|
|
) {
|
|
if (parentSuite.parentSuite) {
|
|
fullName.unshift(parentSuite.description);
|
|
}
|
|
}
|
|
return fullName.join(' ');
|
|
};
|
|
|
|
/*
|
|
* Mark the suite with "pending" status
|
|
*/
|
|
Suite.prototype.pend = function() {
|
|
this.markedPending = true;
|
|
};
|
|
|
|
/*
|
|
* Like {@link Suite#pend}, but pending state will survive {@link Spec#reset}
|
|
* Useful for fdescribe, xdescribe, where pending state should remain.
|
|
*/
|
|
Suite.prototype.exclude = function() {
|
|
this.pend();
|
|
this.markedExcluding = true;
|
|
};
|
|
|
|
Suite.prototype.beforeEach = function(fn) {
|
|
this.beforeFns.unshift({ ...fn, suite: this });
|
|
};
|
|
|
|
Suite.prototype.beforeAll = function(fn) {
|
|
this.beforeAllFns.push({ ...fn, type: 'beforeAll', suite: this });
|
|
};
|
|
|
|
Suite.prototype.afterEach = function(fn) {
|
|
this.afterFns.unshift({ ...fn, suite: this, type: 'afterEach' });
|
|
};
|
|
|
|
Suite.prototype.afterAll = function(fn) {
|
|
this.afterAllFns.unshift({ ...fn, type: 'afterAll' });
|
|
};
|
|
|
|
Suite.prototype.startTimer = function() {
|
|
this.timer.start();
|
|
};
|
|
|
|
Suite.prototype.endTimer = function() {
|
|
this.result.duration = this.timer.elapsed();
|
|
};
|
|
|
|
function removeFns(queueableFns) {
|
|
for (const qf of queueableFns) {
|
|
qf.fn = null;
|
|
}
|
|
}
|
|
|
|
Suite.prototype.cleanupBeforeAfter = function() {
|
|
if (this.autoCleanClosures) {
|
|
removeFns(this.beforeAllFns);
|
|
removeFns(this.afterAllFns);
|
|
removeFns(this.beforeFns);
|
|
removeFns(this.afterFns);
|
|
}
|
|
};
|
|
|
|
Suite.prototype.reset = function() {
|
|
/**
|
|
* @typedef SuiteResult
|
|
* @property {String} id - The unique id of this suite.
|
|
* @property {String} description - The description text passed to the {@link describe} that made this suite.
|
|
* @property {String} fullName - The full description including all ancestors of this suite.
|
|
* @property {Expectation[]} failedExpectations - The list of expectations that failed in an {@link afterAll} for this suite.
|
|
* @property {Expectation[]} deprecationWarnings - The list of deprecation warnings that occurred on this suite.
|
|
* @property {String} status - Once the suite has completed, this string represents the pass/fail status of this suite.
|
|
* @property {number} duration - The time in ms for Suite execution, including any before/afterAll, before/afterEach.
|
|
* @property {Object} properties - User-supplied properties, if any, that were set using {@link Env#setSuiteProperty}
|
|
* @since 2.0.0
|
|
*/
|
|
this.result = {
|
|
id: this.id,
|
|
description: this.description,
|
|
fullName: this.getFullName(),
|
|
failedExpectations: [],
|
|
deprecationWarnings: [],
|
|
duration: null,
|
|
properties: null
|
|
};
|
|
this.markedPending = this.markedExcluding;
|
|
this.children.forEach(function(child) {
|
|
child.reset();
|
|
});
|
|
this.reportedDone = false;
|
|
};
|
|
|
|
Suite.prototype.addChild = function(child) {
|
|
this.children.push(child);
|
|
};
|
|
|
|
Suite.prototype.status = function() {
|
|
if (this.markedPending) {
|
|
return 'pending';
|
|
}
|
|
|
|
if (this.result.failedExpectations.length > 0) {
|
|
return 'failed';
|
|
} else {
|
|
return 'passed';
|
|
}
|
|
};
|
|
|
|
Suite.prototype.canBeReentered = function() {
|
|
return this.beforeAllFns.length === 0 && this.afterAllFns.length === 0;
|
|
};
|
|
|
|
Suite.prototype.getResult = function() {
|
|
this.result.status = this.status();
|
|
return this.result;
|
|
};
|
|
|
|
Suite.prototype.sharedUserContext = function() {
|
|
if (!this.sharedContext) {
|
|
this.sharedContext = this.parentSuite
|
|
? this.parentSuite.clonedSharedUserContext()
|
|
: new j$.UserContext();
|
|
}
|
|
|
|
return this.sharedContext;
|
|
};
|
|
|
|
Suite.prototype.clonedSharedUserContext = function() {
|
|
return j$.UserContext.fromExisting(this.sharedUserContext());
|
|
};
|
|
|
|
Suite.prototype.handleException = function() {
|
|
if (arguments[0] instanceof j$.errors.ExpectationFailed) {
|
|
return;
|
|
}
|
|
|
|
const data = {
|
|
matcherName: '',
|
|
passed: false,
|
|
expected: '',
|
|
actual: '',
|
|
error: arguments[0]
|
|
};
|
|
const failedExpectation = j$.buildExpectationResult(data);
|
|
|
|
if (!this.parentSuite) {
|
|
failedExpectation.globalErrorType = 'afterAll';
|
|
}
|
|
|
|
if (this.reportedDone) {
|
|
this.onLateError(failedExpectation);
|
|
} else {
|
|
this.result.failedExpectations.push(failedExpectation);
|
|
}
|
|
};
|
|
|
|
Suite.prototype.onMultipleDone = function() {
|
|
let msg;
|
|
|
|
// Issue a deprecation. Include the context ourselves and pass
|
|
// ignoreRunnable: true, since getting here always means that we've already
|
|
// moved on and the current runnable isn't the one that caused the problem.
|
|
if (this.parentSuite) {
|
|
msg =
|
|
"An asynchronous beforeAll or afterAll function called its 'done' " +
|
|
'callback more than once.\n' +
|
|
'(in suite: ' +
|
|
this.getFullName() +
|
|
')';
|
|
} else {
|
|
msg =
|
|
'A top-level beforeAll or afterAll function called its ' +
|
|
"'done' callback more than once.";
|
|
}
|
|
|
|
this.onLateError(new Error(msg));
|
|
};
|
|
|
|
Suite.prototype.addExpectationResult = function() {
|
|
if (isFailure(arguments)) {
|
|
const data = arguments[1];
|
|
const expectationResult = j$.buildExpectationResult(data);
|
|
|
|
if (this.reportedDone) {
|
|
this.onLateError(expectationResult);
|
|
} else {
|
|
this.result.failedExpectations.push(expectationResult);
|
|
|
|
// TODO: refactor so that we don't need to override cached status
|
|
if (this.result.status) {
|
|
this.result.status = 'failed';
|
|
}
|
|
}
|
|
|
|
if (this.throwOnExpectationFailure) {
|
|
throw new j$.errors.ExpectationFailed();
|
|
}
|
|
}
|
|
};
|
|
|
|
Suite.prototype.addDeprecationWarning = function(deprecation) {
|
|
if (typeof deprecation === 'string') {
|
|
deprecation = { message: deprecation };
|
|
}
|
|
this.result.deprecationWarnings.push(
|
|
j$.buildExpectationResult(deprecation)
|
|
);
|
|
};
|
|
|
|
Object.defineProperty(Suite.prototype, 'metadata', {
|
|
get: function() {
|
|
if (!this.metadata_) {
|
|
this.metadata_ = new SuiteMetadata(this);
|
|
}
|
|
|
|
return this.metadata_;
|
|
}
|
|
});
|
|
|
|
/**
|
|
* @interface Suite
|
|
* @see Env#topSuite
|
|
* @since 2.0.0
|
|
*/
|
|
function SuiteMetadata(suite) {
|
|
this.suite_ = suite;
|
|
/**
|
|
* The unique ID of this suite.
|
|
* @name Suite#id
|
|
* @readonly
|
|
* @type {string}
|
|
* @since 2.0.0
|
|
*/
|
|
this.id = suite.id;
|
|
|
|
/**
|
|
* The parent of this suite, or null if this is the top suite.
|
|
* @name Suite#parentSuite
|
|
* @readonly
|
|
* @type {Suite}
|
|
*/
|
|
this.parentSuite = suite.parentSuite ? suite.parentSuite.metadata : null;
|
|
|
|
/**
|
|
* The description passed to the {@link describe} that created this suite.
|
|
* @name Suite#description
|
|
* @readonly
|
|
* @type {string}
|
|
* @since 2.0.0
|
|
*/
|
|
this.description = suite.description;
|
|
}
|
|
|
|
/**
|
|
* The full description including all ancestors of this suite.
|
|
* @name Suite#getFullName
|
|
* @function
|
|
* @returns {string}
|
|
* @since 2.0.0
|
|
*/
|
|
SuiteMetadata.prototype.getFullName = function() {
|
|
return this.suite_.getFullName();
|
|
};
|
|
|
|
/**
|
|
* The suite's children.
|
|
* @name Suite#children
|
|
* @type {Array.<(Spec|Suite)>}
|
|
* @since 2.0.0
|
|
*/
|
|
Object.defineProperty(SuiteMetadata.prototype, 'children', {
|
|
get: function() {
|
|
return this.suite_.children.map(child => child.metadata);
|
|
}
|
|
});
|
|
|
|
function isFailure(args) {
|
|
return !args[0];
|
|
}
|
|
|
|
return Suite;
|
|
};
|
|
|
|
getJasmineRequireObj().SuiteBuilder = function(j$) {
|
|
class SuiteBuilder {
|
|
constructor(options) {
|
|
this.env_ = options.env;
|
|
this.expectationFactory_ = options.expectationFactory;
|
|
this.suiteAsyncExpectationFactory_ = function(actual, suite) {
|
|
return options.asyncExpectationFactory(actual, suite, 'Suite');
|
|
};
|
|
this.specAsyncExpectationFactory_ = function(actual, suite) {
|
|
return options.asyncExpectationFactory(actual, suite, 'Spec');
|
|
};
|
|
this.onLateError_ = options.onLateError;
|
|
this.specResultCallback_ = options.specResultCallback;
|
|
this.specStarted_ = options.specStarted;
|
|
|
|
this.nextSuiteId_ = 0;
|
|
this.nextSpecId_ = 0;
|
|
|
|
this.topSuite = this.suiteFactory_('Jasmine__TopLevel__Suite');
|
|
this.currentDeclarationSuite_ = this.topSuite;
|
|
this.totalSpecsDefined = 0;
|
|
this.focusedRunables = [];
|
|
}
|
|
|
|
describe(description, definitionFn) {
|
|
ensureIsFunction(definitionFn, 'describe');
|
|
const suite = this.suiteFactory_(description);
|
|
if (definitionFn.length > 0) {
|
|
throw new Error('describe does not expect any arguments');
|
|
}
|
|
if (this.currentDeclarationSuite_.markedExcluding) {
|
|
suite.exclude();
|
|
}
|
|
this.addSpecsToSuite_(suite, definitionFn);
|
|
return suite;
|
|
}
|
|
|
|
fdescribe(description, definitionFn) {
|
|
ensureIsFunction(definitionFn, 'fdescribe');
|
|
const suite = this.suiteFactory_(description);
|
|
suite.isFocused = true;
|
|
|
|
this.focusedRunables.push(suite.id);
|
|
this.unfocusAncestor_();
|
|
this.addSpecsToSuite_(suite, definitionFn);
|
|
|
|
return suite;
|
|
}
|
|
|
|
xdescribe(description, definitionFn) {
|
|
ensureIsFunction(definitionFn, 'xdescribe');
|
|
const suite = this.suiteFactory_(description);
|
|
suite.exclude();
|
|
this.addSpecsToSuite_(suite, definitionFn);
|
|
|
|
return suite;
|
|
}
|
|
|
|
it(description, fn, timeout) {
|
|
// it() sometimes doesn't have a fn argument, so only check the type if
|
|
// it's given.
|
|
if (arguments.length > 1 && typeof fn !== 'undefined') {
|
|
ensureIsFunctionOrAsync(fn, 'it');
|
|
}
|
|
|
|
return this.it_(description, fn, timeout);
|
|
}
|
|
|
|
xit(description, fn, timeout) {
|
|
// xit(), like it(), doesn't always have a fn argument, so only check the
|
|
// type when needed.
|
|
if (arguments.length > 1 && typeof fn !== 'undefined') {
|
|
ensureIsFunctionOrAsync(fn, 'xit');
|
|
}
|
|
const spec = this.it_(description, fn, timeout);
|
|
spec.exclude('Temporarily disabled with xit');
|
|
return spec;
|
|
}
|
|
|
|
fit(description, fn, timeout) {
|
|
// Unlike it and xit, the function is required because it doesn't make
|
|
// sense to focus on nothing.
|
|
ensureIsFunctionOrAsync(fn, 'fit');
|
|
|
|
if (timeout) {
|
|
j$.util.validateTimeout(timeout);
|
|
}
|
|
const spec = this.specFactory_(description, fn, timeout);
|
|
this.currentDeclarationSuite_.addChild(spec);
|
|
this.focusedRunables.push(spec.id);
|
|
this.unfocusAncestor_();
|
|
return spec;
|
|
}
|
|
|
|
beforeEach(beforeEachFunction, timeout) {
|
|
ensureIsFunctionOrAsync(beforeEachFunction, 'beforeEach');
|
|
|
|
if (timeout) {
|
|
j$.util.validateTimeout(timeout);
|
|
}
|
|
|
|
this.currentDeclarationSuite_.beforeEach({
|
|
fn: beforeEachFunction,
|
|
timeout: timeout || 0
|
|
});
|
|
}
|
|
|
|
beforeAll(beforeAllFunction, timeout) {
|
|
ensureIsFunctionOrAsync(beforeAllFunction, 'beforeAll');
|
|
|
|
if (timeout) {
|
|
j$.util.validateTimeout(timeout);
|
|
}
|
|
|
|
this.currentDeclarationSuite_.beforeAll({
|
|
fn: beforeAllFunction,
|
|
timeout: timeout || 0
|
|
});
|
|
}
|
|
|
|
afterEach(afterEachFunction, timeout) {
|
|
ensureIsFunctionOrAsync(afterEachFunction, 'afterEach');
|
|
|
|
if (timeout) {
|
|
j$.util.validateTimeout(timeout);
|
|
}
|
|
|
|
afterEachFunction.isCleanup = true;
|
|
this.currentDeclarationSuite_.afterEach({
|
|
fn: afterEachFunction,
|
|
timeout: timeout || 0
|
|
});
|
|
}
|
|
|
|
afterAll(afterAllFunction, timeout) {
|
|
ensureIsFunctionOrAsync(afterAllFunction, 'afterAll');
|
|
|
|
if (timeout) {
|
|
j$.util.validateTimeout(timeout);
|
|
}
|
|
|
|
this.currentDeclarationSuite_.afterAll({
|
|
fn: afterAllFunction,
|
|
timeout: timeout || 0
|
|
});
|
|
}
|
|
|
|
it_(description, fn, timeout) {
|
|
if (timeout) {
|
|
j$.util.validateTimeout(timeout);
|
|
}
|
|
|
|
const spec = this.specFactory_(description, fn, timeout);
|
|
if (this.currentDeclarationSuite_.markedExcluding) {
|
|
spec.exclude();
|
|
}
|
|
this.currentDeclarationSuite_.addChild(spec);
|
|
|
|
return spec;
|
|
}
|
|
|
|
suiteFactory_(description) {
|
|
const config = this.env_.configuration();
|
|
return new j$.Suite({
|
|
id: 'suite' + this.nextSuiteId_++,
|
|
description,
|
|
parentSuite: this.currentDeclarationSuite_,
|
|
timer: new j$.Timer(),
|
|
expectationFactory: this.expectationFactory_,
|
|
asyncExpectationFactory: this.suiteAsyncExpectationFactory_,
|
|
throwOnExpectationFailure: config.stopSpecOnExpectationFailure,
|
|
autoCleanClosures: config.autoCleanClosures,
|
|
onLateError: this.onLateError_
|
|
});
|
|
}
|
|
|
|
addSpecsToSuite_(suite, definitionFn) {
|
|
const parentSuite = this.currentDeclarationSuite_;
|
|
parentSuite.addChild(suite);
|
|
this.currentDeclarationSuite_ = suite;
|
|
let threw = false;
|
|
|
|
try {
|
|
definitionFn();
|
|
} catch (e) {
|
|
suite.handleException(e);
|
|
threw = true;
|
|
}
|
|
|
|
if (suite.parentSuite && !suite.children.length && !threw) {
|
|
throw new Error(
|
|
`describe with no children (describe() or it()): ${suite.getFullName()}`
|
|
);
|
|
}
|
|
|
|
this.currentDeclarationSuite_ = parentSuite;
|
|
}
|
|
|
|
specFactory_(description, fn, timeout) {
|
|
this.totalSpecsDefined++;
|
|
const config = this.env_.configuration();
|
|
const suite = this.currentDeclarationSuite_;
|
|
const spec = new j$.Spec({
|
|
id: 'spec' + this.nextSpecId_++,
|
|
beforeAndAfterFns: beforeAndAfterFns(suite),
|
|
expectationFactory: this.expectationFactory_,
|
|
asyncExpectationFactory: this.specAsyncExpectationFactory_,
|
|
onLateError: this.onLateError_,
|
|
resultCallback: (result, next) => {
|
|
this.specResultCallback_(spec, result, next);
|
|
},
|
|
getSpecName: function(spec) {
|
|
return getSpecName(spec, suite);
|
|
},
|
|
onStart: (spec, next) => this.specStarted_(spec, suite, next),
|
|
description: description,
|
|
userContext: function() {
|
|
return suite.clonedSharedUserContext();
|
|
},
|
|
queueableFn: {
|
|
fn: fn,
|
|
timeout: timeout || 0
|
|
},
|
|
throwOnExpectationFailure: config.stopSpecOnExpectationFailure,
|
|
autoCleanClosures: config.autoCleanClosures,
|
|
timer: new j$.Timer()
|
|
});
|
|
return spec;
|
|
}
|
|
|
|
unfocusAncestor_() {
|
|
const focusedAncestor = findFocusedAncestor(
|
|
this.currentDeclarationSuite_
|
|
);
|
|
|
|
if (focusedAncestor) {
|
|
for (let i = 0; i < this.focusedRunables.length; i++) {
|
|
if (this.focusedRunables[i] === focusedAncestor) {
|
|
this.focusedRunables.splice(i, 1);
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
function findFocusedAncestor(suite) {
|
|
while (suite) {
|
|
if (suite.isFocused) {
|
|
return suite.id;
|
|
}
|
|
suite = suite.parentSuite;
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
function ensureIsFunction(fn, caller) {
|
|
if (!j$.isFunction_(fn)) {
|
|
throw new Error(
|
|
caller + ' expects a function argument; received ' + j$.getType_(fn)
|
|
);
|
|
}
|
|
}
|
|
|
|
function ensureIsFunctionOrAsync(fn, caller) {
|
|
if (!j$.isFunction_(fn) && !j$.isAsyncFunction_(fn)) {
|
|
throw new Error(
|
|
caller + ' expects a function argument; received ' + j$.getType_(fn)
|
|
);
|
|
}
|
|
}
|
|
|
|
function beforeAndAfterFns(targetSuite) {
|
|
return function() {
|
|
let befores = [],
|
|
afters = [],
|
|
suite = targetSuite;
|
|
|
|
while (suite) {
|
|
befores = befores.concat(suite.beforeFns);
|
|
afters = afters.concat(suite.afterFns);
|
|
|
|
suite = suite.parentSuite;
|
|
}
|
|
|
|
return {
|
|
befores: befores.reverse(),
|
|
afters: afters
|
|
};
|
|
};
|
|
}
|
|
|
|
function getSpecName(spec, suite) {
|
|
const fullName = [spec.description],
|
|
suiteFullName = suite.getFullName();
|
|
|
|
if (suiteFullName !== '') {
|
|
fullName.unshift(suiteFullName);
|
|
}
|
|
return fullName.join(' ');
|
|
}
|
|
|
|
return SuiteBuilder;
|
|
};
|
|
|
|
getJasmineRequireObj().Timer = function() {
|
|
const defaultNow = (function(Date) {
|
|
return function() {
|
|
return new Date().getTime();
|
|
};
|
|
})(Date);
|
|
|
|
function Timer(options) {
|
|
options = options || {};
|
|
|
|
const now = options.now || defaultNow;
|
|
let startTime;
|
|
|
|
this.start = function() {
|
|
startTime = now();
|
|
};
|
|
|
|
this.elapsed = function() {
|
|
return now() - startTime;
|
|
};
|
|
}
|
|
|
|
return Timer;
|
|
};
|
|
|
|
getJasmineRequireObj().TreeProcessor = function() {
|
|
function TreeProcessor(attrs) {
|
|
const tree = attrs.tree;
|
|
const runnableIds = attrs.runnableIds;
|
|
const queueRunnerFactory = attrs.queueRunnerFactory;
|
|
const nodeStart = attrs.nodeStart || function() {};
|
|
const nodeComplete = attrs.nodeComplete || function() {};
|
|
const failSpecWithNoExpectations = !!attrs.failSpecWithNoExpectations;
|
|
const orderChildren =
|
|
attrs.orderChildren ||
|
|
function(node) {
|
|
return node.children;
|
|
};
|
|
const excludeNode =
|
|
attrs.excludeNode ||
|
|
function(node) {
|
|
return false;
|
|
};
|
|
let stats = { valid: true };
|
|
let processed = false;
|
|
const defaultMin = Infinity;
|
|
const defaultMax = 1 - Infinity;
|
|
|
|
this.processTree = function() {
|
|
processNode(tree, true);
|
|
processed = true;
|
|
return stats;
|
|
};
|
|
|
|
this.execute = async function() {
|
|
if (!processed) {
|
|
this.processTree();
|
|
}
|
|
|
|
if (!stats.valid) {
|
|
throw 'invalid order';
|
|
}
|
|
|
|
const childFns = wrapChildren(tree, 0);
|
|
|
|
await new Promise(function(resolve) {
|
|
queueRunnerFactory({
|
|
queueableFns: childFns,
|
|
userContext: tree.sharedUserContext(),
|
|
onException: function() {
|
|
tree.handleException.apply(tree, arguments);
|
|
},
|
|
onComplete: resolve,
|
|
onMultipleDone: tree.onMultipleDone
|
|
? tree.onMultipleDone.bind(tree)
|
|
: null
|
|
});
|
|
});
|
|
};
|
|
|
|
function runnableIndex(id) {
|
|
for (let i = 0; i < runnableIds.length; i++) {
|
|
if (runnableIds[i] === id) {
|
|
return i;
|
|
}
|
|
}
|
|
}
|
|
|
|
function processNode(node, parentExcluded) {
|
|
const executableIndex = runnableIndex(node.id);
|
|
|
|
if (executableIndex !== undefined) {
|
|
parentExcluded = false;
|
|
}
|
|
|
|
if (!node.children) {
|
|
const excluded = parentExcluded || excludeNode(node);
|
|
stats[node.id] = {
|
|
excluded: excluded,
|
|
willExecute: !excluded && !node.markedPending,
|
|
segments: [
|
|
{
|
|
index: 0,
|
|
owner: node,
|
|
nodes: [node],
|
|
min: startingMin(executableIndex),
|
|
max: startingMax(executableIndex)
|
|
}
|
|
]
|
|
};
|
|
} else {
|
|
let hasExecutableChild = false;
|
|
|
|
const orderedChildren = orderChildren(node);
|
|
|
|
for (let i = 0; i < orderedChildren.length; i++) {
|
|
const child = orderedChildren[i];
|
|
|
|
processNode(child, parentExcluded);
|
|
|
|
if (!stats.valid) {
|
|
return;
|
|
}
|
|
|
|
const childStats = stats[child.id];
|
|
|
|
hasExecutableChild = hasExecutableChild || childStats.willExecute;
|
|
}
|
|
|
|
stats[node.id] = {
|
|
excluded: parentExcluded,
|
|
willExecute: hasExecutableChild
|
|
};
|
|
|
|
segmentChildren(node, orderedChildren, stats[node.id], executableIndex);
|
|
|
|
if (!node.canBeReentered() && stats[node.id].segments.length > 1) {
|
|
stats = { valid: false };
|
|
}
|
|
}
|
|
}
|
|
|
|
function startingMin(executableIndex) {
|
|
return executableIndex === undefined ? defaultMin : executableIndex;
|
|
}
|
|
|
|
function startingMax(executableIndex) {
|
|
return executableIndex === undefined ? defaultMax : executableIndex;
|
|
}
|
|
|
|
function segmentChildren(
|
|
node,
|
|
orderedChildren,
|
|
nodeStats,
|
|
executableIndex
|
|
) {
|
|
let currentSegment = {
|
|
index: 0,
|
|
owner: node,
|
|
nodes: [],
|
|
min: startingMin(executableIndex),
|
|
max: startingMax(executableIndex)
|
|
},
|
|
result = [currentSegment],
|
|
lastMax = defaultMax,
|
|
orderedChildSegments = orderChildSegments(orderedChildren);
|
|
|
|
function isSegmentBoundary(minIndex) {
|
|
return (
|
|
lastMax !== defaultMax &&
|
|
minIndex !== defaultMin &&
|
|
lastMax < minIndex - 1
|
|
);
|
|
}
|
|
|
|
for (let i = 0; i < orderedChildSegments.length; i++) {
|
|
const childSegment = orderedChildSegments[i],
|
|
maxIndex = childSegment.max,
|
|
minIndex = childSegment.min;
|
|
|
|
if (isSegmentBoundary(minIndex)) {
|
|
currentSegment = {
|
|
index: result.length,
|
|
owner: node,
|
|
nodes: [],
|
|
min: defaultMin,
|
|
max: defaultMax
|
|
};
|
|
result.push(currentSegment);
|
|
}
|
|
|
|
currentSegment.nodes.push(childSegment);
|
|
currentSegment.min = Math.min(currentSegment.min, minIndex);
|
|
currentSegment.max = Math.max(currentSegment.max, maxIndex);
|
|
lastMax = maxIndex;
|
|
}
|
|
|
|
nodeStats.segments = result;
|
|
}
|
|
|
|
function orderChildSegments(children) {
|
|
const specifiedOrder = [],
|
|
unspecifiedOrder = [];
|
|
|
|
for (let i = 0; i < children.length; i++) {
|
|
const child = children[i],
|
|
segments = stats[child.id].segments;
|
|
|
|
for (let j = 0; j < segments.length; j++) {
|
|
const seg = segments[j];
|
|
|
|
if (seg.min === defaultMin) {
|
|
unspecifiedOrder.push(seg);
|
|
} else {
|
|
specifiedOrder.push(seg);
|
|
}
|
|
}
|
|
}
|
|
|
|
specifiedOrder.sort(function(a, b) {
|
|
return a.min - b.min;
|
|
});
|
|
|
|
return specifiedOrder.concat(unspecifiedOrder);
|
|
}
|
|
|
|
function executeNode(node, segmentNumber) {
|
|
if (node.children) {
|
|
return {
|
|
fn: function(done) {
|
|
const onStart = {
|
|
fn: function(next) {
|
|
nodeStart(node, next);
|
|
}
|
|
};
|
|
|
|
queueRunnerFactory({
|
|
onComplete: function() {
|
|
const args = Array.prototype.slice.call(arguments, [0]);
|
|
node.cleanupBeforeAfter();
|
|
nodeComplete(node, node.getResult(), function() {
|
|
done.apply(undefined, args);
|
|
});
|
|
},
|
|
queueableFns: [onStart].concat(wrapChildren(node, segmentNumber)),
|
|
userContext: node.sharedUserContext(),
|
|
onException: function() {
|
|
node.handleException.apply(node, arguments);
|
|
},
|
|
onMultipleDone: node.onMultipleDone
|
|
? node.onMultipleDone.bind(node)
|
|
: null
|
|
});
|
|
}
|
|
};
|
|
} else {
|
|
return {
|
|
fn: function(done) {
|
|
node.execute(
|
|
queueRunnerFactory,
|
|
done,
|
|
stats[node.id].excluded,
|
|
failSpecWithNoExpectations
|
|
);
|
|
}
|
|
};
|
|
}
|
|
}
|
|
|
|
function wrapChildren(node, segmentNumber) {
|
|
const result = [],
|
|
segmentChildren = stats[node.id].segments[segmentNumber].nodes;
|
|
|
|
for (let i = 0; i < segmentChildren.length; i++) {
|
|
result.push(
|
|
executeNode(segmentChildren[i].owner, segmentChildren[i].index)
|
|
);
|
|
}
|
|
|
|
if (!stats[node.id].willExecute) {
|
|
return result;
|
|
}
|
|
|
|
return node.beforeAllFns.concat(result).concat(node.afterAllFns);
|
|
}
|
|
}
|
|
|
|
return TreeProcessor;
|
|
};
|
|
|
|
getJasmineRequireObj().UserContext = function(j$) {
|
|
function UserContext() {}
|
|
|
|
UserContext.fromExisting = function(oldContext) {
|
|
const context = new UserContext();
|
|
|
|
for (const prop in oldContext) {
|
|
if (oldContext.hasOwnProperty(prop)) {
|
|
context[prop] = oldContext[prop];
|
|
}
|
|
}
|
|
|
|
return context;
|
|
};
|
|
|
|
return UserContext;
|
|
};
|
|
|
|
getJasmineRequireObj().version = function() {
|
|
return '4.5.0';
|
|
};
|