diff --git a/Gruntfile.js b/Gruntfile.js index 72c0711..3c60c07 100644 --- a/Gruntfile.js +++ b/Gruntfile.js @@ -2,16 +2,30 @@ module.exports = function(grunt) { 'use strict'; + var pkg = grunt.file.readJSON('package.json'); + + function banner(buildName) { + return '/*! \n * ' + [ + pkg.name + ' v' + pkg.version + ' - ' + pkg.description, + pkg.url, + '', + 'Copyright (c) ' + grunt.template.today('yyyy') + ' ' + pkg.name + ' contributors', + pkg.licenses + ' Licensed', + '', + 'Released: ' + grunt.template.today('yyyy-mm-dd'), + '', + ].join('\n * ') + '\n' + + + //in /* */ comment due to IE's conditional compilaton comments + '//@ sourceMappingURL=Shield.' + buildName + '.map\n' + + ' */\n'; + } + grunt.initConfig({ - pkg: grunt.file.readJSON('package.json'), - // Simple config to re-run `grunt` any time a file is added, changed or deleted - watch: { - files: ['Gruntfile.js', 'package.json', 'src/**/*.js', 'test/**/*.js'], - tasks: ['default'] - }, + pkg: pkg, jshint: { - files: ['Gruntfile.js', 'src/**/*.js', 'test/**/*.js'], + files: ['src/**/*.js'], options: { bitwise: true, boss: true, @@ -48,23 +62,59 @@ module.exports = function(grunt) { } }, - jasmine: { - src: '*.js', - specs: 'spec/**/*Spec.js', - timeout: 10000, - junit: { - output: 'junit/' + lodash: { + //it'd be nice to see this configurable at some point + modifier: 'legacy', + + //not sure on the best place to put this.. src/ makes it transparent/clear for a contributor though + dest: 'lib/lodash.custom.js', + include: ['isArray', 'isString', 'isFunction', 'each'] + }, + 'closure-compiler': (function (map) { + var baseFiles = [ + 'lib/lodash.custom.js', + 'node_modules/extend-function/extendFunction.js', + 'src/Shield.js' + ]; + var closureHash = {}; + for (var build in map) { + if (map.hasOwnProperty(build)) { + closureHash[build] = { + js: baseFiles.concat(map[build]), + jsOutputFile: 'dist/' + build + '.min.js', + maxBuffer: 500, + options: { + compilation_level: 'SIMPLE_OPTIMIZATIONS', + language_in: 'ECMASCRIPT3', + output_wrapper: banner(build) + '%output%', + source_map_format: 'V3', // || V1 || V2 || DEFAULT + create_source_map: 'dist/' + build + '.min.map' + } + }; + } } - } + return closureHash; + })({ + base: [], //just use base files + historicalConsole: ['node_modules/historical-console/historicalConsole.js'], + jQuery: ['src/shield.jquery.js'], + historicalConsoleAndjQuery: ['node_modules/historical-console/historicalConsole.js', 'src/shield.jquery.js'] + }), + watch: { + files: ['Gruntfile.js', 'package.json', 'src/**/*.js', 'test/**/*.js'], + tasks: ['default'] + } }); grunt.loadNpmTasks('grunt-contrib-jshint'); + grunt.loadNpmTasks('grunt-lodashbuilder'); + grunt.loadNpmTasks('grunt-closure-compiler'); grunt.loadNpmTasks('grunt-contrib-jasmine'); grunt.loadNpmTasks('grunt-contrib-watch'); // Default task - grunt.registerTask('default', ['jshint', 'jasmine', 'watch']); + grunt.registerTask('default', ['jshint', 'lodash', 'closure-compiler', 'jasmine', 'watch']); // Travis-CI task grunt.registerTask('travis', ['jshint']); diff --git a/Makefile b/Makefile index 2941319..b10454e 100644 --- a/Makefile +++ b/Makefile @@ -1,2 +1,3 @@ yuidoc: - yuidoc --server 2000 --configfile package.json \ No newline at end of file + #yuidoc --lint --configfile package.json + yuidoc --server 2000 -c package.json \ No newline at end of file diff --git a/README.md b/README.md index 0e307bd..ae16e41 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,15 @@ ### Docs with [yuidoc](http://yui.github.com/yuidoc/) ``` -sudo npm install -g yuidocjs +cd projects +git clone devinrhode2/shield.js +cd shield.js +npm install -g yuidocjs make open http://localhost:2000/ -``` \ No newline at end of file +``` + +//focus is ease of use. for crazy efficiency, just use a try/catch block and pass exceptions to onuncaughtException + +[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/devinrhode2/shield.js/trend.png)](https://bitdeli.com/free "Bitdeli Badge") + diff --git a/component.json b/component.json new file mode 100644 index 0000000..ce18cae --- /dev/null +++ b/component.json @@ -0,0 +1,7 @@ +{ + "name": "shield.js", + "version": "0.0.0", + "dependencies": { + "extendFunction": "latest" + } +} \ No newline at end of file diff --git a/dist/base.min.js b/dist/base.min.js new file mode 100644 index 0000000..df34af4 --- /dev/null +++ b/dist/base.min.js @@ -0,0 +1,31 @@ +/*! + * shield.js v0.1.0 - Shows you how bad your JavaScript code is. + * https://github.com/shieldjs/shield.js + * + * Copyright (c) 2013 shield.js contributors + * undefined Licensed + * + * Released: 2013-03-07 + * +//@ sourceMappingURL=Shield.base.map + */ +/* + + Lo-Dash 1.0.1 (Custom Build) + Build: `lodash --silent --output /private/var/folders/_b/2zt85gnd1r71_3h3lz3jnh9m0000gn/T/lodash11324-94131-mudsgx legacy include="isArray, isString, isFunction, each"` + Copyright 2012-2013 The Dojo Foundation + Based on Underscore.js 1.4.4 + Copyright 2009-2013 Jeremy Ashkenas, DocumentCloud Inc. + Available under MIT license +*/ +(function(d,i){function b(){}function g(a,b,d){if(null==a)return p;var c=typeof a;if("function"!=c){if("object"!=c)return function(c){return c[a]};var e=keys(a);return function(c){for(var b=e.length,d=!1;b--&&(d=isEqual(c[e[b]],a[e[b]],w)););return d}}return"undefined"!=typeof b?1===d?function(c){return a.call(b,c)}:2===d?function(c,d){return a.call(b,c,d)}:4===d?function(c,d,e,v){return a.call(b,c,d,e,v)}:function(c,d,e){return a.call(b,c,d,e)}:a}function h(a){return a?q.call(a,"callee"):!1}function j(a){return"function"== +typeof a}function e(a){return"string"==typeof a||m.call(a)==x}function f(a,b,d){if(b&&"undefined"==typeof d&&n(a))for(var d=-1,c=a.length;++df;f++)c+="\n index = '"+a.shadowed[f]+"';\n if (","constructor"==a.shadowed[f]&&(c+="!(ctor && ctor.prototype === iterable) && "),c+="hasOwnProperty.call(iterable, index)) {\n "+a.loop+"\n } "}if(a.arrays||a.nonEnumArgs)c+="\n}";c+=a.bottom+";\nreturn result";return d("createCallback, hasOwnProperty, isArguments, isArray, isString, objectTypes","return function("+b+") {\n"+c+"\n}")(g,q,h,n,e,C)}({args:"collection, callback, thisArg",top:"callback = callback && typeof thisArg == 'undefined' ? callback : createCallback(callback, thisArg)", +arrays:"typeof length == 'number'",loop:"if (callback(iterable[index], index, collection) === false) return result"}),n=function(a){return A&&a instanceof Array||"[object Array]"==m.call(a)};j(/x/)&&(j=function(a){return a instanceof Function||"[object Function]"==m.call(a)});b.forEach=f;b.each=f;b.identity=p;b.isArguments=h;b.isArray=n;b.isFunction=j;b.isString=e;b.VERSION="1.0.1";"function"==typeof define&&"object"==typeof define.amd&&define.amd?(d._=b,define(function(){return b})):k?r?(r.exports= +b)._=b:k._=b:d._=b})(this);function wrapInTryCatch(d){return function(){try{var i=[].slice.call(arguments);return d.apply?d.apply(this,i):d(i[0],i[1])}catch(b){if("undefined"!==typeof onuncaughtException&&"[object Function]"==Object.prototype.toString.call(onuncaughtException))onuncaughtException(b);else throw"undefined"!==typeof console&&console.warn&&console.warn("You should define a window.onuncaughtException handler for exceptions, or use a library like Sheild.js"),b;}}} +function extendFunction(d,i){var b,g;if("[object String]"==Object.prototype.toString.call(d)){b=window||global;for(g=d.split(".");g.length;)b=b[g.shift()]}else if("[object Function]"==Object.prototype.toString.call(d))b=d;else throw Error("unknown type for first arg of extendFunction");var h=wrapInTryCatch(function(){var g=[].slice.call(arguments),e=!1,f=function(){e=!0;try{return b.apply(this,[].slice.call(arguments))}catch(f){if("[object Function]"!=Object.prototype.toString.call(b))throw Error(d+ +" is not a function. "+d+" toString is:"+b+" and is of type:"+typeof b);throw f;}},h,k=i.call(this,g,f);e||(e=!1,h=f.apply(this,g));return"undefined"===typeof k?h:k});if(g&&0===g.length)eval("(window || global)."+d+" = "+h.toString());else return h};(function(){function d(b,g){_.isString(b)&&-1 + Build: `lodash --silent --output /private/var/folders/_b/2zt85gnd1r71_3h3lz3jnh9m0000gn/T/lodash11324-94131-mudsgx legacy include="isArray, isString, isFunction, each"` + Copyright 2012-2013 The Dojo Foundation + Based on Underscore.js 1.4.4 + Copyright 2009-2013 Jeremy Ashkenas, DocumentCloud Inc. + Available under MIT license +*/ +(function(b,g){function a(){}function i(h,f,a){if(null==h)return d;var c=typeof h;if("function"!=c){if("object"!=c)return function(f){return f[h]};var b=keys(h);return function(f){for(var a=b.length,c=!1;a--&&(c=isEqual(f[b[a]],h[b[a]],l)););return c}}return"undefined"!=typeof f?1===a?function(a){return h.call(f,a)}:2===a?function(a,c){return h.call(f,a,c)}:4===a?function(a,c,b,d){return h.call(f,a,c,b,d)}:function(a,c,b){return h.call(f,a,c,b)}:h}function p(h){return h?r.call(h,"callee"):!1}function k(h){return"function"== +typeof h}function e(h){return"string"==typeof h||f.call(h)==x}function j(h,a,f){if(a&&"undefined"==typeof f&&t(h))for(var f=-1,c=h.length;++fd;d++)c+="\n index = '"+a.shadowed[d]+"';\n if (","constructor"==a.shadowed[d]&&(c+="!(ctor && ctor.prototype === iterable) && "),c+="hasOwnProperty.call(iterable, index)) {\n "+a.loop+"\n } "}if(a.arrays||a.nonEnumArgs)c+="\n}";c+=a.bottom+";\nreturn result";return b("createCallback, hasOwnProperty, isArguments, isArray, isString, objectTypes","return function("+f+") {\n"+c+"\n}")(i,r,p,t,e,B)}({args:"collection, callback, thisArg",top:"callback = callback && typeof thisArg == 'undefined' ? callback : createCallback(callback, thisArg)", +arrays:"typeof length == 'number'",loop:"if (callback(iterable[index], index, collection) === false) return result"}),t=function(a){return z&&a instanceof Array||"[object Array]"==f.call(a)};k(/x/)&&(k=function(a){return a instanceof Function||"[object Function]"==f.call(a)});a.forEach=j;a.each=j;a.identity=d;a.isArguments=p;a.isArray=t;a.isFunction=k;a.isString=e;a.VERSION="1.0.1";"function"==typeof define&&"object"==typeof define.amd&&define.amd?(b._=a,define(function(){return a})):m?s?(s.exports= +a)._=a:m._=a:b._=a})(this);function wrapInTryCatch(b){return function(){try{var g=[].slice.call(arguments);return b.apply?b.apply(this,g):b(g[0],g[1])}catch(a){if("undefined"!==typeof onuncaughtException&&"[object Function]"==Object.prototype.toString.call(onuncaughtException))onuncaughtException(a);else throw"undefined"!==typeof console&&console.warn&&console.warn("You should define a window.onuncaughtException handler for exceptions, or use a library like Sheild.js"),a;}}} +function extendFunction(b,g){var a,i;if("[object String]"==Object.prototype.toString.call(b)){a=window||global;for(i=b.split(".");i.length;)a=a[i.shift()]}else if("[object Function]"==Object.prototype.toString.call(b))a=b;else throw Error("unknown type for first arg of extendFunction");var p=wrapInTryCatch(function(){var k=[].slice.call(arguments),e=!1,j=function(){e=!0;try{return a.apply(this,[].slice.call(arguments))}catch(d){if("[object Function]"!=Object.prototype.toString.call(a))throw Error(b+ +" is not a function. "+b+" toString is:"+a+" and is of type:"+typeof a);throw d;}},d,i=g.call(this,k,j);e||(e=!1,d=j.apply(this,k));return"undefined"===typeof i?d:i});if(i&&0===i.length)eval("(window || global)."+b+" = "+p.toString());else return p};(function(){function b(a,i){_.isString(a)&&-1",a[0];);return 4l.consoleHistoryMaxLength&&d.history.shift()};for(var m,s="assert clear count debug dir dirxml error exception group groupCollapsed groupEnd info log profile profileEnd table time timeEnd timeStamp trace warn".split(" "), +n=s.length;n--;)m=s[n],d[m]=d.generateConsoleMethod(m,j[m]||j.log,a.saveHooks[m]);d.alert=d.generateConsoleMethod("alert",b.alert,function(a){"undefined"!==typeof onuncaughtException?onuncaughtException(Error(a)):d.warn("You should define a window.onuncaughtException handler or use a library like Shield.js")});var l={addCaller:!0,functionSnippetLength:40,consoleHistoryMaxLength:200},q;for(q in l)l.hasOwnProperty(q)&&(d.options[q]=d.generateOptionFunction(q));var r={}})(this); diff --git a/dist/historicalConsole.min.js.report.txt b/dist/historicalConsole.min.js.report.txt new file mode 100644 index 0000000..1cd77cd --- /dev/null +++ b/dist/historicalConsole.min.js.report.txt @@ -0,0 +1,5 @@ +node_modules/historical-console/historicalConsole.js:36: WARNING - Suspicious code. This code lacks side-effects. Is there a bug? + if (optionalName && historicalConsole[optionalName]) { + ^ + +0 error(s), 1 warning(s) diff --git a/dist/historicalConsole.min.map b/dist/historicalConsole.min.map new file mode 100644 index 0000000..bba2cc4 --- /dev/null +++ b/dist/historicalConsole.min.map @@ -0,0 +1,8 @@ +{ +"version":3, +"file":"dist/historicalConsole.min.js", +"lineCount":37, +"mappings":"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", +"sources":["lib/lodash.custom.js","node_modules/extend-function/extendFunction.js","src/Shield.js","node_modules/historical-console/historicalConsole.js"], +"names":["window","undefined","lodash","createCallback","func","thisArg","argCount","identity","type","object","props","keys","length","result","isEqual","indicatorObject","value","call","a","b","accumulator","index","isArguments","hasOwnProperty","isFunction","isString","toString","stringClass","forEach","collection","callback","isArray","each","freeExports","exports","freeModule","module","freeGlobal","global","objectRef","shadowed","hasDontEnumBug","hasEnumPrototype","nonEnumArgs","ctor","x","prototype","prop","push","arguments","test","propertyIsEnumerable","argsAreObjects","constructor","Object","noCharByIndex","objectTypes","createIterator","data","key","args","firstArg","exec","Function","__p","top","arrays","loop","useHas","k","bottom","factory","eachIteratorOptions","Array","arrayClass","funcClass","VERSION","define","amd","_","wrapInTryCatch","fn","slice","apply","e","onuncaughtException","console","warn","extendFunction","fnRef","addedFunctionality","oldOldFn","s","split","shift","Error","newFunc","called","oldFunction","oldRet","newRet","eval","shieldJS","shield","apiFn","promises","indexOf","replace","api","prevFunc","prevFnString","firstParen","secondParen","substring","historicalConsole","arg","ret","promise","pop","oldShield","shield_report","normalize","shield_normalize","location","href","shield_noConflict","ie","v","div","document","createElement","all","getElementsByTagName","innerHTML","undef","historicalConsoleJS","optionalName","alert","message","error","historicalConsoleClosure","oldConsole","trackAction","action","callee","name","JSON","stringify","setTimeout","_oldHistoricalConsole","now","Date","getTime","counters","historicalConsole_resolveFunctionName","internalOptions","functionSnippetLength","console_saveHook_assert","isOk","console_saveHook_count","title","Math","floor","random","console_saveHook_time","startTimes","console_saveHook_timeEnd","console_saveHook_timeStamp","optionalLabel","console_saveHook_trace","stack","historicalConsole_noConflict","nativeConsole","console_generateConsoleMethod","method","nativeMethod","saveHook","unshift","addCaller","resolveFunctionName","caller","history","add","console_generateOptionFunction","optionKey","optionUpdate","console.history.add","logStatement","consoleHistoryMaxLength","methods","generateConsoleMethod","log","saveHooks","console_alert_saveHook","option","options","generateOptionFunction"] +} diff --git a/lib/lodash.custom.js b/lib/lodash.custom.js new file mode 100644 index 0000000..c465750 --- /dev/null +++ b/lib/lodash.custom.js @@ -0,0 +1,11 @@ +/** + * @license + * Lo-Dash 1.0.1 (Custom Build) lodash.com/license + * Build: `lodash --silent --output /private/var/folders/_b/2zt85gnd1r71_3h3lz3jnh9m0000gn/T/lodash11324-94131-mudsgx legacy include="isArray, isString, isFunction, each"` + * Underscore.js 1.4.4 underscorejs.org/LICENSE + */ +;(function(n){function t(){}function r(n,t,r){if(null==n)return f;var e=typeof n;if("function"!=e){if("object"!=e)return function(t){return t[n]};var o=keys(n);return function(t){for(var r=o.length,e=!1;r--&&(e=isEqual(t[o[r]],n[o[r]],y)););return e}}return typeof t!="undefined"?1===r?function(r){return n.call(t,r)}:2===r?function(r,e){return n.call(t,r,e)}:4===r?function(r,e,o,i){return n.call(t,r,e,o,i)}:function(r,e,o){return n.call(t,r,e,o)}:n}function e(n){return n?v.call(n,"callee"):!1}function o(n){return typeof n=="function" +}function i(n){return typeof n=="string"||j.call(n)==b}function u(n,t,r){if(t&&typeof r=="undefined"&&k(n)){r=-1;for(var e=n.length;++rf;f++)u+="j='"+t.k[f]+"';if(","constructor"==t.k[f]&&(u+="!(g&&g.prototype===n)&&"),u+="i.call(n,j)){"+t.h+"}"}return(t.b||t.i)&&(u+="}"),u+=t.c+";return u",o("f,i,k,l,m,r","return function("+n+"){"+u+"}")(r,v,e,k,i,x)}({a:"e,d,x",l:"d=d&&typeof x=='undefined'?d:f(d,x)",b:"typeof o=='number'",h:"if(d(n[j],j,e)===false)return u"}),k=function(n){return m&&n instanceof Array||"[object Array]"==j.call(n)};o(/x/)&&(o=function(n){return n instanceof Function||"[object Function]"==j.call(n) +}),t.forEach=u,t.each=u,t.identity=f,t.isArguments=e,t.isArray=k,t.isFunction=o,t.isString=i,t.VERSION="1.0.1",typeof define=="function"&&typeof define.amd=="object"&&define.amd?(n._=t,define(function(){return t})):c?a?(a.exports=t)._=t:c._=t:n._=t})(this); \ No newline at end of file diff --git a/package.json b/package.json index 345dd1b..a71fa03 100644 --- a/package.json +++ b/package.json @@ -1,21 +1,28 @@ { "name": "shield.js", "version": "0.1.0", - "homepage": "https://github.com/shieldjs/shield.js", "url": "https://github.com/shieldjs/shield.js", "description": "Shows you how bad your JavaScript code is.", "devDependencies": { + "broccoli": "^0.16.8", + "extend-function": "latest", "grunt": "~0.4.0", - "grunt-contrib-jshint": "~0.2.0", + "grunt-closure-compiler": "latest", "grunt-contrib-jasmine": "~0.3.3", - "grunt-contrib-watch": "~0.3.1" + "grunt-contrib-jshint": "~0.2.0", + "grunt-contrib-watch": "~0.3.1", + "grunt-lodashbuilder": "~0.1.7", + "historical-console": "latest" + }, + "dependencies": { + "extend-function": "git://github.com/devinrhode2/extendFunction.js.git", + "historical-console": "git://github.com/devinrhode2/historicalConsole.js.git", + "sendUncaughtException": "devinrhode2/sendUncaughtException" }, "scripts": { "test": "grunt travis --verbose" }, - - - "comment-on-yuidoc": "yuidoc has been buggy when I put it's json inside a 'yuidoc': key. I don't exactly like having these here but it works.", + "comment-on-yuidoc": "yuidoc has been buggy when I put it's json inside a 'yuidoc': key. I don't exactly like having these yuidoc specific keys here but it works.", "logo": "http://cl.ly/image/1G113M0s1D2h/shield-logo-small.png", "options": { "linkNatives": true, diff --git a/spec/JsTestDriver-1.3.5.jar b/spec/JsTestDriver-1.3.5.jar deleted file mode 100644 index fda4866..0000000 Binary files a/spec/JsTestDriver-1.3.5.jar and /dev/null differ diff --git a/spec/SpecRunner.html b/spec/SpecRunner.html deleted file mode 100644 index 288dd3d..0000000 --- a/spec/SpecRunner.html +++ /dev/null @@ -1,45 +0,0 @@ - - - - Jasmine Spec Runner - - - - - - - - - - - - - - - diff --git a/spec/helpers/jasmine-sinon.js b/spec/helpers/jasmine-sinon.js deleted file mode 100644 index ec240be..0000000 --- a/spec/helpers/jasmine-sinon.js +++ /dev/null @@ -1,43 +0,0 @@ -(function(global) { - - var spyMatchers = "called calledOnce calledTwice calledThrice calledBefore calledAfter calledOn alwaysCalledOn calledWith alwaysCalledWith calledWithExactly alwaysCalledWithExactly calledWithMatch alwaysCalledWithMatch".split(" "), - i = spyMatchers.length, - spyMatcherHash = {}, - unusualMatchers = { - "returned": "toHaveReturned", - "alwaysReturned": "toHaveAlwaysReturned", - "threw": "toHaveThrown", - "alwaysThrew": "toHaveAlwaysThrown" - }, - - getMatcherFunction = function(sinonName) { - return function() { - var sinonProperty = this.actual[sinonName]; - return (typeof sinonProperty === 'function') ? sinonProperty.apply(this.actual, arguments) : sinonProperty; - }; - }; - - while(i--) { - var sinonName = spyMatchers[i], - matcherName = "toHaveBeen" + sinonName.charAt(0).toUpperCase() + sinonName.slice(1); - - spyMatcherHash[matcherName] = getMatcherFunction(sinonName); - }; - - for (var j in unusualMatchers) { - spyMatcherHash[unusualMatchers[j]] = getMatcherFunction(j); - } - - global.sinonJasmine = { - getMatchers: function() { - return spyMatcherHash; - } - }; - -})(window); - -beforeEach(function() { - - this.addMatchers(sinonJasmine.getMatchers()); - -}); diff --git a/spec/helpers/sinon.js b/spec/helpers/sinon.js deleted file mode 100644 index 4116929..0000000 --- a/spec/helpers/sinon.js +++ /dev/null @@ -1,343 +0,0 @@ -/*jslint eqeqeq: false, onevar: false, forin: true, nomen: false, regexp: false, plusplus: false*/ -/*global module, require, __dirname, document*/ -/** - * Sinon core utilities. For internal use only. - * - * @author Christian Johansen (christian@cjohansen.no) - * @license BSD - * - * Copyright (c) 2010-2011 Christian Johansen - */ -"use strict"; - -var sinon = (function (buster) { - var div = typeof document != "undefined" && document.createElement("div"); - var hasOwn = Object.prototype.hasOwnProperty; - - function isDOMNode(obj) { - var success = false; - - try { - obj.appendChild(div); - success = div.parentNode == obj; - } catch (e) { - return false; - } finally { - try { - obj.removeChild(div); - } catch (e) { - // Remove failed, not much we can do about that - } - } - - return success; - } - - function isElement(obj) { - return div && obj && obj.nodeType === 1 && isDOMNode(obj); - } - - function isFunction(obj) { - return typeof obj === "function" || !!(obj && obj.constructor && obj.call && obj.apply); - } - - function mirrorProperties(target, source) { - for (var prop in source) { - if (!hasOwn.call(target, prop)) { - target[prop] = source[prop]; - } - } - } - - var sinon = { - wrapMethod: function wrapMethod(object, property, method) { - if (!object) { - throw new TypeError("Should wrap property of object"); - } - - if (typeof method != "function") { - throw new TypeError("Method wrapper should be function"); - } - - var wrappedMethod = object[property]; - - if (!isFunction(wrappedMethod)) { - throw new TypeError("Attempted to wrap " + (typeof wrappedMethod) + " property " + - property + " as function"); - } - - if (wrappedMethod.restore && wrappedMethod.restore.sinon) { - throw new TypeError("Attempted to wrap " + property + " which is already wrapped"); - } - - if (wrappedMethod.calledBefore) { - var verb = !!wrappedMethod.returns ? "stubbed" : "spied on"; - throw new TypeError("Attempted to wrap " + property + " which is already " + verb); - } - - // IE 8 does not support hasOwnProperty on the window object. - var owned = hasOwn.call(object, property); - object[property] = method; - method.displayName = property; - - method.restore = function () { - // For prototype properties try to reset by delete first. - // If this fails (ex: localStorage on mobile safari) then force a reset - // via direct assignment. - if (!owned) { - delete object[property]; - } - if (object[property] === method) { - object[property] = wrappedMethod; - } - }; - - method.restore.sinon = true; - mirrorProperties(method, wrappedMethod); - - return method; - }, - - extend: function extend(target) { - for (var i = 1, l = arguments.length; i < l; i += 1) { - for (var prop in arguments[i]) { - if (arguments[i].hasOwnProperty(prop)) { - target[prop] = arguments[i][prop]; - } - - // DONT ENUM bug, only care about toString - if (arguments[i].hasOwnProperty("toString") && - arguments[i].toString != target.toString) { - target.toString = arguments[i].toString; - } - } - } - - return target; - }, - - create: function create(proto) { - var F = function () {}; - F.prototype = proto; - return new F(); - }, - - deepEqual: function deepEqual(a, b) { - if (sinon.match && sinon.match.isMatcher(a)) { - return a.test(b); - } - if (typeof a != "object" || typeof b != "object") { - return a === b; - } - - if (isElement(a) || isElement(b)) { - return a === b; - } - - if (a === b) { - return true; - } - - if ((a === null && b !== null) || (a !== null && b === null)) { - return false; - } - - var aString = Object.prototype.toString.call(a); - if (aString != Object.prototype.toString.call(b)) { - return false; - } - - if (aString == "[object Array]") { - if (a.length !== b.length) { - return false; - } - - for (var i = 0, l = a.length; i < l; i += 1) { - if (!deepEqual(a[i], b[i])) { - return false; - } - } - - return true; - } - - var prop, aLength = 0, bLength = 0; - - for (prop in a) { - aLength += 1; - - if (!deepEqual(a[prop], b[prop])) { - return false; - } - } - - for (prop in b) { - bLength += 1; - } - - if (aLength != bLength) { - return false; - } - - return true; - }, - - functionName: function functionName(func) { - var name = func.displayName || func.name; - - // Use function decomposition as a last resort to get function - // name. Does not rely on function decomposition to work - if it - // doesn't debugging will be slightly less informative - // (i.e. toString will say 'spy' rather than 'myFunc'). - if (!name) { - var matches = func.toString().match(/function ([^\s\(]+)/); - name = matches && matches[1]; - } - - return name; - }, - - functionToString: function toString() { - if (this.getCall && this.callCount) { - var thisValue, prop, i = this.callCount; - - while (i--) { - thisValue = this.getCall(i).thisValue; - - for (prop in thisValue) { - if (thisValue[prop] === this) { - return prop; - } - } - } - } - - return this.displayName || "sinon fake"; - }, - - getConfig: function (custom) { - var config = {}; - custom = custom || {}; - var defaults = sinon.defaultConfig; - - for (var prop in defaults) { - if (defaults.hasOwnProperty(prop)) { - config[prop] = custom.hasOwnProperty(prop) ? custom[prop] : defaults[prop]; - } - } - - return config; - }, - - format: function (val) { - return "" + val; - }, - - defaultConfig: { - injectIntoThis: true, - injectInto: null, - properties: ["spy", "stub", "mock", "clock", "server", "requests"], - useFakeTimers: true, - useFakeServer: true - }, - - timesInWords: function timesInWords(count) { - return count == 1 && "once" || - count == 2 && "twice" || - count == 3 && "thrice" || - (count || 0) + " times"; - }, - - calledInOrder: function (spies) { - for (var i = 1, l = spies.length; i < l; i++) { - if (!spies[i - 1].calledBefore(spies[i])) { - return false; - } - } - - return true; - }, - - orderByFirstCall: function (spies) { - return spies.sort(function (a, b) { - // uuid, won't ever be equal - var aCall = a.getCall(0); - var bCall = b.getCall(0); - var aId = aCall && aCall.callId || -1; - var bId = bCall && bCall.callId || -1; - - return aId < bId ? -1 : 1; - }); - }, - - log: function () {}, - - logError: function (label, err) { - var msg = label + " threw exception: " - sinon.log(msg + "[" + err.name + "] " + err.message); - if (err.stack) { sinon.log(err.stack); } - - setTimeout(function () { - err.message = msg + err.message; - throw err; - }, 0); - }, - - typeOf: function (value) { - if (value === null) { - return "null"; - } - else if (value === undefined) { - return "undefined"; - } - var string = Object.prototype.toString.call(value); - return string.substring(8, string.length - 1).toLowerCase(); - }, - - createStubInstance: function (constructor) { - if (typeof constructor !== "function") { - throw new TypeError("The constructor should be a function."); - } - return sinon.stub(sinon.create(constructor.prototype)); - } - }; - - var isNode = typeof module == "object" && typeof require == "function"; - - if (isNode) { - try { - buster = { format: require("buster-format") }; - } catch (e) {} - module.exports = sinon; - module.exports.spy = require("./sinon/spy"); - module.exports.stub = require("./sinon/stub"); - module.exports.mock = require("./sinon/mock"); - module.exports.collection = require("./sinon/collection"); - module.exports.assert = require("./sinon/assert"); - module.exports.sandbox = require("./sinon/sandbox"); - module.exports.test = require("./sinon/test"); - module.exports.testCase = require("./sinon/test_case"); - module.exports.assert = require("./sinon/assert"); - module.exports.match = require("./sinon/match"); - } - - if (buster) { - var formatter = sinon.create(buster.format); - formatter.quoteStrings = false; - sinon.format = function () { - return formatter.ascii.apply(formatter, arguments); - }; - } else if (isNode) { - try { - var util = require("util"); - sinon.format = function (value) { - return typeof value == "object" && value.toString === Object.prototype.toString ? util.inspect(value) : value; - }; - } catch (e) { - /* Node, but no util module - would be very old, but better safe than - sorry */ - } - } - - return sinon; -}(typeof buster == "object" && buster)); diff --git a/spec/jsTestDriver.conf b/spec/jsTestDriver.conf deleted file mode 100644 index 422fbf7..0000000 --- a/spec/jsTestDriver.conf +++ /dev/null @@ -1,17 +0,0 @@ -server: http://localhost:4224 - -load: - - lib/jasmine.js - - lib/JasmineAdapter.js - - ../shield.js - -test: - - shieldSpec.js - -plugin: - - name: "coverage" - jar: "lib/plugins/coverage-1.3.5.jar" - module: "com.google.jstestdriver.coverage.CoverageModule" - args: useCoberturaFormat - -timeout: 30 diff --git a/spec/lib/JasmineAdapter.js b/spec/lib/JasmineAdapter.js deleted file mode 100644 index 370de8b..0000000 --- a/spec/lib/JasmineAdapter.js +++ /dev/null @@ -1,189 +0,0 @@ -/** - * @fileoverview Jasmine JsTestDriver Adapter. - * @author misko@hevery.com (Misko Hevery) - * @author olmo.maldonado@gmail.com (Olmo Maldonado) - */ -(function(){ - - -var Env = function(onTestDone, onComplete){ - jasmine.Env.call(this); - - this.specFilter = function(spec){ - if (!this.exclusive) return true; - var blocks = spec.queue.blocks, l = blocks.length; - for (var i = 0; i < l; i++) if (blocks[i].func.exclusive >= this.exclusive) return true; - return false; - }; - - this.reporter = new Reporter(onTestDone, onComplete); -}; -jasmine.util.inherit(Env, jasmine.Env); - -// Here we store: -// 0: everyone runs -// 1: run everything under ddescribe -// 2: run only iits (ignore ddescribe) -Env.prototype.exclusive = 0; - - -Env.prototype.execute = function(){ - collectMode = false; - playback(); - jasmine.Env.prototype.execute.call(this); -}; - - -var Reporter = function(onTestDone, onComplete){ - this.onTestDone = onTestDone; - this.onComplete = onComplete; - this.reset(); -}; -jasmine.util.inherit(Reporter, jasmine.Reporter); - - -Reporter.formatStack = function(stack) { - var line, lines = (stack || '').split(/\r?\n/), l = lines.length, frames = []; - for (var i = 0; i < l; i++){ - line = lines[i]; - if (line.match(/\/jasmine[\.-]/)) continue; - frames.push(line.replace(/https?:\/\/\w+(:\d+)?\/test\//, '').replace(/^\s*/, ' ')); - } - return frames.join('\n'); -}; - - -Reporter.prototype.reset = function(){ - this.specLog = jstestdriver.console.log_ = []; -}; - - -Reporter.prototype.log = function(str){ - this.specLog.push(str); -}; - - -Reporter.prototype.reportSpecStarting = function(){ - this.reset(); - this.start = +new Date(); -}; - - -Reporter.prototype.reportSpecResults = function(spec){ - var elapsed = +new Date() - this.start, results = spec.results(); - - if (results.skipped) return; - - var item, state = 'passed', items = results.getItems(), l = items.length, messages = []; - for (var i = 0; i < l; i++){ - item = items[i]; - if (item.passed()) continue; - state = (item.message.indexOf('AssertionError:') != -1) ? 'error' : 'failed'; - messages.push({ - message: item + '', - name: item.trace.name, - stack: Reporter.formatStack(item.trace.stack) - }); - } - - this.onTestDone(new jstestdriver.TestResult( - spec.suite.getFullName(), - spec.description, - state, - jstestdriver.angular.toJson(messages), - this.specLog.join('\n'), - elapsed - )); -}; - - -Reporter.prototype.reportRunnerResults = function(){ - this.onComplete(); -}; - - -var collectMode = true, intercepted = {}; - -describe = intercept('describe'); -beforeEach = intercept('beforeEach'); -afterEach = intercept('afterEach'); - -var JASMINE_TYPE = 'jasmine test case'; -TestCase('Jasmine Adapter Tests', null, JASMINE_TYPE); - -jstestdriver.pluginRegistrar.register({ - - name: 'jasmine', - - getTestRunsConfigurationFor: function(testCaseInfos, expressions, testRunsConfiguration) { - for (var i = 0; i < testCaseInfos.length; i++) { - if (testCaseInfos[i].getType() == JASMINE_TYPE) { - testRunsConfiguration.push(new jstestdriver.TestRunConfiguration(testCaseInfos[i], [])); - } - } - return false; // allow other TestCases to be collected. - }, - - runTestConfiguration: function(config, onTestDone, onComplete){ - if (config.getTestCaseInfo().getType() != JASMINE_TYPE) return false; - (jasmine.currentEnv_ = new Env(onTestDone, onComplete)).execute(); - return true; - }, - - onTestsFinish: function(){ - jasmine.currentEnv_ = null; - collectMode = true; - } - -}); - -function intercept(method){ - var bucket = intercepted[method] = [], method = window[method]; - return function(desc, fn){ - if (collectMode) bucket.push(function(){ method(desc, fn); }); - else method(desc, fn); - }; -} - -function playback(){ - for (var method in intercepted){ - var bucket = intercepted[method]; - for (var i = 0, l = bucket.length; i < l; i++) bucket[i](); - } -} - -})(); - -var ddescribe = function(name, fn){ - var env = jasmine.getEnv(); - if (!env.exclusive) env.exclusive = 1; // run ddescribe only - describe(name, function(){ - var oldIt = it; - it = function(name, fn){ - fn.exclusive = 1; // run anything under ddescribe - env.it(name, fn); - }; - - try { - fn.call(this); - } finally { - it = oldIt; - }; - }); -}; - -var iit = function(name, fn){ - var env = jasmine.getEnv(); - env.exclusive = fn.exclusive = 2; // run only iits - env.it(name, fn); -}; - -// Patch Jasmine for proper stack traces -jasmine.Spec.prototype.fail = function (e) { - var result = new jasmine.ExpectationResult({ - passed: false, - message: e ? jasmine.util.formatException(e) : 'Exception' - }); - if(e) result.trace = e; - this.results_.addResult(result); -}; diff --git a/spec/lib/jasmine-html.js b/spec/lib/jasmine-html.js deleted file mode 100644 index a0b0639..0000000 --- a/spec/lib/jasmine-html.js +++ /dev/null @@ -1,616 +0,0 @@ -jasmine.HtmlReporterHelpers = {}; - -jasmine.HtmlReporterHelpers.createDom = function(type, attrs, childrenVarArgs) { - var el = document.createElement(type); - - for (var i = 2; i < arguments.length; i++) { - var child = arguments[i]; - - if (typeof child === 'string') { - el.appendChild(document.createTextNode(child)); - } else { - if (child) { - el.appendChild(child); - } - } - } - - for (var attr in attrs) { - if (attr == "className") { - el[attr] = attrs[attr]; - } else { - el.setAttribute(attr, attrs[attr]); - } - } - - return el; -}; - -jasmine.HtmlReporterHelpers.getSpecStatus = function(child) { - var results = child.results(); - var status = results.passed() ? 'passed' : 'failed'; - if (results.skipped) { - status = 'skipped'; - } - - return status; -}; - -jasmine.HtmlReporterHelpers.appendToSummary = function(child, childElement) { - var parentDiv = this.dom.summary; - var parentSuite = (typeof child.parentSuite == 'undefined') ? 'suite' : 'parentSuite'; - var parent = child[parentSuite]; - - if (parent) { - if (typeof this.views.suites[parent.id] == 'undefined') { - this.views.suites[parent.id] = new jasmine.HtmlReporter.SuiteView(parent, this.dom, this.views); - } - parentDiv = this.views.suites[parent.id].element; - } - - parentDiv.appendChild(childElement); -}; - - -jasmine.HtmlReporterHelpers.addHelpers = function(ctor) { - for(var fn in jasmine.HtmlReporterHelpers) { - ctor.prototype[fn] = jasmine.HtmlReporterHelpers[fn]; - } -}; - -jasmine.HtmlReporter = function(_doc) { - var self = this; - var doc = _doc || window.document; - - var reporterView; - - var dom = {}; - - // Jasmine Reporter Public Interface - self.logRunningSpecs = false; - - self.reportRunnerStarting = function(runner) { - var specs = runner.specs() || []; - - if (specs.length == 0) { - return; - } - - createReporterDom(runner.env.versionString()); - doc.body.appendChild(dom.reporter); - - reporterView = new jasmine.HtmlReporter.ReporterView(dom); - reporterView.addSpecs(specs, self.specFilter); - }; - - self.reportRunnerResults = function(runner) { - reporterView && reporterView.complete(); - }; - - self.reportSuiteResults = function(suite) { - reporterView.suiteComplete(suite); - }; - - self.reportSpecStarting = function(spec) { - if (self.logRunningSpecs) { - self.log('>> Jasmine Running ' + spec.suite.description + ' ' + spec.description + '...'); - } - }; - - self.reportSpecResults = function(spec) { - reporterView.specComplete(spec); - }; - - self.log = function() { - var console = jasmine.getGlobal().console; - if (console && console.log) { - if (console.log.apply) { - console.log.apply(console, arguments); - } else { - console.log(arguments); // ie fix: console.log.apply doesn't exist on ie - } - } - }; - - self.specFilter = function(spec) { - if (!focusedSpecName()) { - return true; - } - - return spec.getFullName().indexOf(focusedSpecName()) === 0; - }; - - return self; - - function focusedSpecName() { - var specName; - - (function memoizeFocusedSpec() { - if (specName) { - return; - } - - var paramMap = []; - var params = doc.location.search.substring(1).split('&'); - - for (var i = 0; i < params.length; i++) { - var p = params[i].split('='); - paramMap[decodeURIComponent(p[0])] = decodeURIComponent(p[1]); - } - - specName = paramMap.spec; - })(); - - return specName; - } - - function createReporterDom(version) { - dom.reporter = self.createDom('div', { id: 'HTMLReporter', className: 'jasmine_reporter' }, - dom.banner = self.createDom('div', { className: 'banner' }, - self.createDom('span', { className: 'title' }, "Jasmine "), - self.createDom('span', { className: 'version' }, version)), - - dom.symbolSummary = self.createDom('ul', {className: 'symbolSummary'}), - dom.alert = self.createDom('div', {className: 'alert'}), - dom.results = self.createDom('div', {className: 'results'}, - dom.summary = self.createDom('div', { className: 'summary' }), - dom.details = self.createDom('div', { id: 'details' })) - ); - } -}; -jasmine.HtmlReporterHelpers.addHelpers(jasmine.HtmlReporter);jasmine.HtmlReporter.ReporterView = function(dom) { - this.startedAt = new Date(); - this.runningSpecCount = 0; - this.completeSpecCount = 0; - this.passedCount = 0; - this.failedCount = 0; - this.skippedCount = 0; - - this.createResultsMenu = function() { - this.resultsMenu = this.createDom('span', {className: 'resultsMenu bar'}, - this.summaryMenuItem = this.createDom('a', {className: 'summaryMenuItem', href: "#"}, '0 specs'), - ' | ', - this.detailsMenuItem = this.createDom('a', {className: 'detailsMenuItem', href: "#"}, '0 failing')); - - this.summaryMenuItem.onclick = function() { - dom.reporter.className = dom.reporter.className.replace(/ showDetails/g, ''); - }; - - this.detailsMenuItem.onclick = function() { - showDetails(); - }; - }; - - this.addSpecs = function(specs, specFilter) { - this.totalSpecCount = specs.length; - - this.views = { - specs: {}, - suites: {} - }; - - for (var i = 0; i < specs.length; i++) { - var spec = specs[i]; - this.views.specs[spec.id] = new jasmine.HtmlReporter.SpecView(spec, dom, this.views); - if (specFilter(spec)) { - this.runningSpecCount++; - } - } - }; - - this.specComplete = function(spec) { - this.completeSpecCount++; - - if (isUndefined(this.views.specs[spec.id])) { - this.views.specs[spec.id] = new jasmine.HtmlReporter.SpecView(spec, dom); - } - - var specView = this.views.specs[spec.id]; - - switch (specView.status()) { - case 'passed': - this.passedCount++; - break; - - case 'failed': - this.failedCount++; - break; - - case 'skipped': - this.skippedCount++; - break; - } - - specView.refresh(); - this.refresh(); - }; - - this.suiteComplete = function(suite) { - var suiteView = this.views.suites[suite.id]; - if (isUndefined(suiteView)) { - return; - } - suiteView.refresh(); - }; - - this.refresh = function() { - - if (isUndefined(this.resultsMenu)) { - this.createResultsMenu(); - } - - // currently running UI - if (isUndefined(this.runningAlert)) { - this.runningAlert = this.createDom('a', {href: "?", className: "runningAlert bar"}); - dom.alert.appendChild(this.runningAlert); - } - this.runningAlert.innerHTML = "Running " + this.completeSpecCount + " of " + specPluralizedFor(this.totalSpecCount); - - // skipped specs UI - if (isUndefined(this.skippedAlert)) { - this.skippedAlert = this.createDom('a', {href: "?", className: "skippedAlert bar"}); - } - - this.skippedAlert.innerHTML = "Skipping " + this.skippedCount + " of " + specPluralizedFor(this.totalSpecCount) + " - run all"; - - if (this.skippedCount === 1 && isDefined(dom.alert)) { - dom.alert.appendChild(this.skippedAlert); - } - - // passing specs UI - if (isUndefined(this.passedAlert)) { - this.passedAlert = this.createDom('span', {href: "?", className: "passingAlert bar"}); - } - this.passedAlert.innerHTML = "Passing " + specPluralizedFor(this.passedCount); - - // failing specs UI - if (isUndefined(this.failedAlert)) { - this.failedAlert = this.createDom('span', {href: "?", className: "failingAlert bar"}); - } - this.failedAlert.innerHTML = "Failing " + specPluralizedFor(this.failedCount); - - if (this.failedCount === 1 && isDefined(dom.alert)) { - dom.alert.appendChild(this.failedAlert); - dom.alert.appendChild(this.resultsMenu); - } - - // summary info - this.summaryMenuItem.innerHTML = "" + specPluralizedFor(this.runningSpecCount); - this.detailsMenuItem.innerHTML = "" + this.failedCount + " failing"; - }; - - this.complete = function() { - dom.alert.removeChild(this.runningAlert); - - this.skippedAlert.innerHTML = "Ran " + this.runningSpecCount + " of " + specPluralizedFor(this.totalSpecCount) + " - run all"; - - if (this.failedCount === 0) { - dom.alert.appendChild(this.createDom('span', {className: 'passingAlert bar'}, "Passing " + specPluralizedFor(this.passedCount))); - } else { - showDetails(); - } - - dom.banner.appendChild(this.createDom('span', {className: 'duration'}, "finished in " + ((new Date().getTime() - this.startedAt.getTime()) / 1000) + "s")); - }; - - return this; - - function showDetails() { - if (dom.reporter.className.search(/showDetails/) === -1) { - dom.reporter.className += " showDetails"; - } - } - - function isUndefined(obj) { - return typeof obj === 'undefined'; - } - - function isDefined(obj) { - return !isUndefined(obj); - } - - function specPluralizedFor(count) { - var str = count + " spec"; - if (count > 1) { - str += "s" - } - return str; - } - -}; - -jasmine.HtmlReporterHelpers.addHelpers(jasmine.HtmlReporter.ReporterView); - - -jasmine.HtmlReporter.SpecView = function(spec, dom, views) { - this.spec = spec; - this.dom = dom; - this.views = views; - - this.symbol = this.createDom('li', { className: 'pending' }); - this.dom.symbolSummary.appendChild(this.symbol); - - this.summary = this.createDom('div', { className: 'specSummary' }, - this.createDom('a', { - className: 'description', - href: '?spec=' + encodeURIComponent(this.spec.getFullName()), - title: this.spec.getFullName() - }, this.spec.description) - ); - - this.detail = this.createDom('div', { className: 'specDetail' }, - this.createDom('a', { - className: 'description', - href: '?spec=' + encodeURIComponent(this.spec.getFullName()), - title: this.spec.getFullName() - }, this.spec.getFullName()) - ); -}; - -jasmine.HtmlReporter.SpecView.prototype.status = function() { - return this.getSpecStatus(this.spec); -}; - -jasmine.HtmlReporter.SpecView.prototype.refresh = function() { - this.symbol.className = this.status(); - - switch (this.status()) { - case 'skipped': - break; - - case 'passed': - this.appendSummaryToSuiteDiv(); - break; - - case 'failed': - this.appendSummaryToSuiteDiv(); - this.appendFailureDetail(); - break; - } -}; - -jasmine.HtmlReporter.SpecView.prototype.appendSummaryToSuiteDiv = function() { - this.summary.className += ' ' + this.status(); - this.appendToSummary(this.spec, this.summary); -}; - -jasmine.HtmlReporter.SpecView.prototype.appendFailureDetail = function() { - this.detail.className += ' ' + this.status(); - - var resultItems = this.spec.results().getItems(); - var messagesDiv = this.createDom('div', { className: 'messages' }); - - for (var i = 0; i < resultItems.length; i++) { - var result = resultItems[i]; - - if (result.type == 'log') { - messagesDiv.appendChild(this.createDom('div', {className: 'resultMessage log'}, result.toString())); - } else if (result.type == 'expect' && result.passed && !result.passed()) { - messagesDiv.appendChild(this.createDom('div', {className: 'resultMessage fail'}, result.message)); - - if (result.trace.stack) { - messagesDiv.appendChild(this.createDom('div', {className: 'stackTrace'}, result.trace.stack)); - } - } - } - - if (messagesDiv.childNodes.length > 0) { - this.detail.appendChild(messagesDiv); - this.dom.details.appendChild(this.detail); - } -}; - -jasmine.HtmlReporterHelpers.addHelpers(jasmine.HtmlReporter.SpecView);jasmine.HtmlReporter.SuiteView = function(suite, dom, views) { - this.suite = suite; - this.dom = dom; - this.views = views; - - this.element = this.createDom('div', { className: 'suite' }, - this.createDom('a', { className: 'description', href: '?spec=' + encodeURIComponent(this.suite.getFullName()) }, this.suite.description) - ); - - this.appendToSummary(this.suite, this.element); -}; - -jasmine.HtmlReporter.SuiteView.prototype.status = function() { - return this.getSpecStatus(this.suite); -}; - -jasmine.HtmlReporter.SuiteView.prototype.refresh = function() { - this.element.className += " " + this.status(); -}; - -jasmine.HtmlReporterHelpers.addHelpers(jasmine.HtmlReporter.SuiteView); - -/* @deprecated Use jasmine.HtmlReporter instead - */ -jasmine.TrivialReporter = function(doc) { - this.document = doc || document; - this.suiteDivs = {}; - this.logRunningSpecs = false; -}; - -jasmine.TrivialReporter.prototype.createDom = function(type, attrs, childrenVarArgs) { - var el = document.createElement(type); - - for (var i = 2; i < arguments.length; i++) { - var child = arguments[i]; - - if (typeof child === 'string') { - el.appendChild(document.createTextNode(child)); - } else { - if (child) { el.appendChild(child); } - } - } - - for (var attr in attrs) { - if (attr == "className") { - el[attr] = attrs[attr]; - } else { - el.setAttribute(attr, attrs[attr]); - } - } - - return el; -}; - -jasmine.TrivialReporter.prototype.reportRunnerStarting = function(runner) { - var showPassed, showSkipped; - - this.outerDiv = this.createDom('div', { id: 'TrivialReporter', className: 'jasmine_reporter' }, - this.createDom('div', { className: 'banner' }, - this.createDom('div', { className: 'logo' }, - this.createDom('span', { className: 'title' }, "Jasmine"), - this.createDom('span', { className: 'version' }, runner.env.versionString())), - this.createDom('div', { className: 'options' }, - "Show ", - showPassed = this.createDom('input', { id: "__jasmine_TrivialReporter_showPassed__", type: 'checkbox' }), - this.createDom('label', { "for": "__jasmine_TrivialReporter_showPassed__" }, " passed "), - showSkipped = this.createDom('input', { id: "__jasmine_TrivialReporter_showSkipped__", type: 'checkbox' }), - this.createDom('label', { "for": "__jasmine_TrivialReporter_showSkipped__" }, " skipped") - ) - ), - - this.runnerDiv = this.createDom('div', { className: 'runner running' }, - this.createDom('a', { className: 'run_spec', href: '?' }, "run all"), - this.runnerMessageSpan = this.createDom('span', {}, "Running..."), - this.finishedAtSpan = this.createDom('span', { className: 'finished-at' }, "")) - ); - - this.document.body.appendChild(this.outerDiv); - - var suites = runner.suites(); - for (var i = 0; i < suites.length; i++) { - var suite = suites[i]; - var suiteDiv = this.createDom('div', { className: 'suite' }, - this.createDom('a', { className: 'run_spec', href: '?spec=' + encodeURIComponent(suite.getFullName()) }, "run"), - this.createDom('a', { className: 'description', href: '?spec=' + encodeURIComponent(suite.getFullName()) }, suite.description)); - this.suiteDivs[suite.id] = suiteDiv; - var parentDiv = this.outerDiv; - if (suite.parentSuite) { - parentDiv = this.suiteDivs[suite.parentSuite.id]; - } - parentDiv.appendChild(suiteDiv); - } - - this.startedAt = new Date(); - - var self = this; - showPassed.onclick = function(evt) { - if (showPassed.checked) { - self.outerDiv.className += ' show-passed'; - } else { - self.outerDiv.className = self.outerDiv.className.replace(/ show-passed/, ''); - } - }; - - showSkipped.onclick = function(evt) { - if (showSkipped.checked) { - self.outerDiv.className += ' show-skipped'; - } else { - self.outerDiv.className = self.outerDiv.className.replace(/ show-skipped/, ''); - } - }; -}; - -jasmine.TrivialReporter.prototype.reportRunnerResults = function(runner) { - var results = runner.results(); - var className = (results.failedCount > 0) ? "runner failed" : "runner passed"; - this.runnerDiv.setAttribute("class", className); - //do it twice for IE - this.runnerDiv.setAttribute("className", className); - var specs = runner.specs(); - var specCount = 0; - for (var i = 0; i < specs.length; i++) { - if (this.specFilter(specs[i])) { - specCount++; - } - } - var message = "" + specCount + " spec" + (specCount == 1 ? "" : "s" ) + ", " + results.failedCount + " failure" + ((results.failedCount == 1) ? "" : "s"); - message += " in " + ((new Date().getTime() - this.startedAt.getTime()) / 1000) + "s"; - this.runnerMessageSpan.replaceChild(this.createDom('a', { className: 'description', href: '?'}, message), this.runnerMessageSpan.firstChild); - - this.finishedAtSpan.appendChild(document.createTextNode("Finished at " + new Date().toString())); -}; - -jasmine.TrivialReporter.prototype.reportSuiteResults = function(suite) { - var results = suite.results(); - var status = results.passed() ? 'passed' : 'failed'; - if (results.totalCount === 0) { // todo: change this to check results.skipped - status = 'skipped'; - } - this.suiteDivs[suite.id].className += " " + status; -}; - -jasmine.TrivialReporter.prototype.reportSpecStarting = function(spec) { - if (this.logRunningSpecs) { - this.log('>> Jasmine Running ' + spec.suite.description + ' ' + spec.description + '...'); - } -}; - -jasmine.TrivialReporter.prototype.reportSpecResults = function(spec) { - var results = spec.results(); - var status = results.passed() ? 'passed' : 'failed'; - if (results.skipped) { - status = 'skipped'; - } - var specDiv = this.createDom('div', { className: 'spec ' + status }, - this.createDom('a', { className: 'run_spec', href: '?spec=' + encodeURIComponent(spec.getFullName()) }, "run"), - this.createDom('a', { - className: 'description', - href: '?spec=' + encodeURIComponent(spec.getFullName()), - title: spec.getFullName() - }, spec.description)); - - - var resultItems = results.getItems(); - var messagesDiv = this.createDom('div', { className: 'messages' }); - for (var i = 0; i < resultItems.length; i++) { - var result = resultItems[i]; - - if (result.type == 'log') { - messagesDiv.appendChild(this.createDom('div', {className: 'resultMessage log'}, result.toString())); - } else if (result.type == 'expect' && result.passed && !result.passed()) { - messagesDiv.appendChild(this.createDom('div', {className: 'resultMessage fail'}, result.message)); - - if (result.trace.stack) { - messagesDiv.appendChild(this.createDom('div', {className: 'stackTrace'}, result.trace.stack)); - } - } - } - - if (messagesDiv.childNodes.length > 0) { - specDiv.appendChild(messagesDiv); - } - - this.suiteDivs[spec.suite.id].appendChild(specDiv); -}; - -jasmine.TrivialReporter.prototype.log = function() { - var console = jasmine.getGlobal().console; - if (console && console.log) { - if (console.log.apply) { - console.log.apply(console, arguments); - } else { - console.log(arguments); // ie fix: console.log.apply doesn't exist on ie - } - } -}; - -jasmine.TrivialReporter.prototype.getLocation = function() { - return this.document.location; -}; - -jasmine.TrivialReporter.prototype.specFilter = function(spec) { - var paramMap = {}; - var params = this.getLocation().search.substring(1).split('&'); - for (var i = 0; i < params.length; i++) { - var p = params[i].split('='); - paramMap[decodeURIComponent(p[0])] = decodeURIComponent(p[1]); - } - - if (!paramMap.spec) { - return true; - } - return spec.getFullName().indexOf(paramMap.spec) === 0; -}; diff --git a/spec/lib/jasmine.css b/spec/lib/jasmine.css deleted file mode 100644 index 826e575..0000000 --- a/spec/lib/jasmine.css +++ /dev/null @@ -1,81 +0,0 @@ -body { background-color: #eeeeee; padding: 0; margin: 5px; overflow-y: scroll; } - -#HTMLReporter { font-size: 11px; font-family: Monaco, "Lucida Console", monospace; line-height: 14px; color: #333333; } -#HTMLReporter a { text-decoration: none; } -#HTMLReporter a:hover { text-decoration: underline; } -#HTMLReporter p, #HTMLReporter h1, #HTMLReporter h2, #HTMLReporter h3, #HTMLReporter h4, #HTMLReporter h5, #HTMLReporter h6 { margin: 0; line-height: 14px; } -#HTMLReporter .banner, #HTMLReporter .symbolSummary, #HTMLReporter .summary, #HTMLReporter .resultMessage, #HTMLReporter .specDetail .description, #HTMLReporter .alert .bar, #HTMLReporter .stackTrace { padding-left: 9px; padding-right: 9px; } -#HTMLReporter #jasmine_content { position: fixed; right: 100%; } -#HTMLReporter .version { color: #aaaaaa; } -#HTMLReporter .banner { margin-top: 14px; } -#HTMLReporter .duration { color: #aaaaaa; float: right; } -#HTMLReporter .symbolSummary { overflow: hidden; *zoom: 1; margin: 14px 0; } -#HTMLReporter .symbolSummary li { display: block; float: left; height: 7px; width: 14px; margin-bottom: 7px; font-size: 16px; } -#HTMLReporter .symbolSummary li.passed { font-size: 14px; } -#HTMLReporter .symbolSummary li.passed:before { color: #5e7d00; content: "\02022"; } -#HTMLReporter .symbolSummary li.failed { line-height: 9px; } -#HTMLReporter .symbolSummary li.failed:before { color: #b03911; content: "x"; font-weight: bold; margin-left: -1px; } -#HTMLReporter .symbolSummary li.skipped { font-size: 14px; } -#HTMLReporter .symbolSummary li.skipped:before { color: #bababa; content: "\02022"; } -#HTMLReporter .symbolSummary li.pending { line-height: 11px; } -#HTMLReporter .symbolSummary li.pending:before { color: #aaaaaa; content: "-"; } -#HTMLReporter .bar { line-height: 28px; font-size: 14px; display: block; color: #eee; } -#HTMLReporter .runningAlert { background-color: #666666; } -#HTMLReporter .skippedAlert { background-color: #aaaaaa; } -#HTMLReporter .skippedAlert:first-child { background-color: #333333; } -#HTMLReporter .skippedAlert:hover { text-decoration: none; color: white; text-decoration: underline; } -#HTMLReporter .passingAlert { background-color: #a6b779; } -#HTMLReporter .passingAlert:first-child { background-color: #5e7d00; } -#HTMLReporter .failingAlert { background-color: #cf867e; } -#HTMLReporter .failingAlert:first-child { background-color: #b03911; } -#HTMLReporter .results { margin-top: 14px; } -#HTMLReporter #details { display: none; } -#HTMLReporter .resultsMenu, #HTMLReporter .resultsMenu a { background-color: #fff; color: #333333; } -#HTMLReporter.showDetails .summaryMenuItem { font-weight: normal; text-decoration: inherit; } -#HTMLReporter.showDetails .summaryMenuItem:hover { text-decoration: underline; } -#HTMLReporter.showDetails .detailsMenuItem { font-weight: bold; text-decoration: underline; } -#HTMLReporter.showDetails .summary { display: none; } -#HTMLReporter.showDetails #details { display: block; } -#HTMLReporter .summaryMenuItem { font-weight: bold; text-decoration: underline; } -#HTMLReporter .summary { margin-top: 14px; } -#HTMLReporter .summary .suite .suite, #HTMLReporter .summary .specSummary { margin-left: 14px; } -#HTMLReporter .summary .specSummary.passed a { color: #5e7d00; } -#HTMLReporter .summary .specSummary.failed a { color: #b03911; } -#HTMLReporter .description + .suite { margin-top: 0; } -#HTMLReporter .suite { margin-top: 14px; } -#HTMLReporter .suite a { color: #333333; } -#HTMLReporter #details .specDetail { margin-bottom: 28px; } -#HTMLReporter #details .specDetail .description { display: block; color: white; background-color: #b03911; } -#HTMLReporter .resultMessage { padding-top: 14px; color: #333333; } -#HTMLReporter .resultMessage span.result { display: block; } -#HTMLReporter .stackTrace { margin: 5px 0 0 0; max-height: 224px; overflow: auto; line-height: 18px; color: #666666; border: 1px solid #ddd; background: white; white-space: pre; } - -#TrivialReporter { padding: 8px 13px; position: absolute; top: 0; bottom: 0; left: 0; right: 0; overflow-y: scroll; background-color: white; font-family: "Helvetica Neue Light", "Lucida Grande", "Calibri", "Arial", sans-serif; /*.resultMessage {*/ /*white-space: pre;*/ /*}*/ } -#TrivialReporter a:visited, #TrivialReporter a { color: #303; } -#TrivialReporter a:hover, #TrivialReporter a:active { color: blue; } -#TrivialReporter .run_spec { float: right; padding-right: 5px; font-size: .8em; text-decoration: none; } -#TrivialReporter .banner { color: #303; background-color: #fef; padding: 5px; } -#TrivialReporter .logo { float: left; font-size: 1.1em; padding-left: 5px; } -#TrivialReporter .logo .version { font-size: .6em; padding-left: 1em; } -#TrivialReporter .runner.running { background-color: yellow; } -#TrivialReporter .options { text-align: right; font-size: .8em; } -#TrivialReporter .suite { border: 1px outset gray; margin: 5px 0; padding-left: 1em; } -#TrivialReporter .suite .suite { margin: 5px; } -#TrivialReporter .suite.passed { background-color: #dfd; } -#TrivialReporter .suite.failed { background-color: #fdd; } -#TrivialReporter .spec { margin: 5px; padding-left: 1em; clear: both; } -#TrivialReporter .spec.failed, #TrivialReporter .spec.passed, #TrivialReporter .spec.skipped { padding-bottom: 5px; border: 1px solid gray; } -#TrivialReporter .spec.failed { background-color: #fbb; border-color: red; } -#TrivialReporter .spec.passed { background-color: #bfb; border-color: green; } -#TrivialReporter .spec.skipped { background-color: #bbb; } -#TrivialReporter .messages { border-left: 1px dashed gray; padding-left: 1em; padding-right: 1em; } -#TrivialReporter .passed { background-color: #cfc; display: none; } -#TrivialReporter .failed { background-color: #fbb; } -#TrivialReporter .skipped { color: #777; background-color: #eee; display: none; } -#TrivialReporter .resultMessage span.result { display: block; line-height: 2em; color: black; } -#TrivialReporter .resultMessage .mismatch { color: black; } -#TrivialReporter .stackTrace { white-space: pre; font-size: .8em; margin-left: 10px; max-height: 5em; overflow: auto; border: 1px inset red; padding: 1em; background: #eef; } -#TrivialReporter .finished-at { padding-left: 1em; font-size: .6em; } -#TrivialReporter.show-passed .passed, #TrivialReporter.show-skipped .skipped { display: block; } -#TrivialReporter #jasmine_content { position: fixed; right: 100%; } -#TrivialReporter .runner { border: 1px solid gray; display: block; margin: 5px 0; padding: 2px 0 2px 10px; } diff --git a/spec/lib/jasmine.js b/spec/lib/jasmine.js deleted file mode 100644 index 03bf89a..0000000 --- a/spec/lib/jasmine.js +++ /dev/null @@ -1,2529 +0,0 @@ -var isCommonJS = typeof window == "undefined"; - -/** - * Top level namespace for Jasmine, a lightweight JavaScript BDD/spec/testing framework. - * - * @namespace - */ -var jasmine = {}; -if (isCommonJS) exports.jasmine = jasmine; -/** - * @private - */ -jasmine.unimplementedMethod_ = function() { - throw new Error("unimplemented method"); -}; - -/** - * Use jasmine.undefined instead of undefined, since undefined is just - * a plain old variable and may be redefined by somebody else. - * - * @private - */ -jasmine.undefined = jasmine.___undefined___; - -/** - * Show diagnostic messages in the console if set to true - * - */ -jasmine.VERBOSE = false; - -/** - * Default interval in milliseconds for event loop yields (e.g. to allow network activity or to refresh the screen with the HTML-based runner). Small values here may result in slow test running. Zero means no updates until all tests have completed. - * - */ -jasmine.DEFAULT_UPDATE_INTERVAL = 250; - -/** - * Default timeout interval in milliseconds for waitsFor() blocks. - */ -jasmine.DEFAULT_TIMEOUT_INTERVAL = 5000; - -jasmine.getGlobal = function() { - function getGlobal() { - return this; - } - - return getGlobal(); -}; - -/** - * Allows for bound functions to be compared. Internal use only. - * - * @ignore - * @private - * @param base {Object} bound 'this' for the function - * @param name {Function} function to find - */ -jasmine.bindOriginal_ = function(base, name) { - var original = base[name]; - if (original.apply) { - return function() { - return original.apply(base, arguments); - }; - } else { - // IE support - return jasmine.getGlobal()[name]; - } -}; - -jasmine.setTimeout = jasmine.bindOriginal_(jasmine.getGlobal(), 'setTimeout'); -jasmine.clearTimeout = jasmine.bindOriginal_(jasmine.getGlobal(), 'clearTimeout'); -jasmine.setInterval = jasmine.bindOriginal_(jasmine.getGlobal(), 'setInterval'); -jasmine.clearInterval = jasmine.bindOriginal_(jasmine.getGlobal(), 'clearInterval'); - -jasmine.MessageResult = function(values) { - this.type = 'log'; - this.values = values; - this.trace = new Error(); // todo: test better -}; - -jasmine.MessageResult.prototype.toString = function() { - var text = ""; - for (var i = 0; i < this.values.length; i++) { - if (i > 0) text += " "; - if (jasmine.isString_(this.values[i])) { - text += this.values[i]; - } else { - text += jasmine.pp(this.values[i]); - } - } - return text; -}; - -jasmine.ExpectationResult = function(params) { - this.type = 'expect'; - this.matcherName = params.matcherName; - this.passed_ = params.passed; - this.expected = params.expected; - this.actual = params.actual; - this.message = this.passed_ ? 'Passed.' : params.message; - - var trace = (params.trace || new Error(this.message)); - this.trace = this.passed_ ? '' : trace; -}; - -jasmine.ExpectationResult.prototype.toString = function () { - return this.message; -}; - -jasmine.ExpectationResult.prototype.passed = function () { - return this.passed_; -}; - -/** - * Getter for the Jasmine environment. Ensures one gets created - */ -jasmine.getEnv = function() { - var env = jasmine.currentEnv_ = jasmine.currentEnv_ || new jasmine.Env(); - return env; -}; - -/** - * @ignore - * @private - * @param value - * @returns {Boolean} - */ -jasmine.isArray_ = function(value) { - return jasmine.isA_("Array", value); -}; - -/** - * @ignore - * @private - * @param value - * @returns {Boolean} - */ -jasmine.isString_ = function(value) { - return jasmine.isA_("String", value); -}; - -/** - * @ignore - * @private - * @param value - * @returns {Boolean} - */ -jasmine.isNumber_ = function(value) { - return jasmine.isA_("Number", value); -}; - -/** - * @ignore - * @private - * @param {String} typeName - * @param value - * @returns {Boolean} - */ -jasmine.isA_ = function(typeName, value) { - return Object.prototype.toString.apply(value) === '[object ' + typeName + ']'; -}; - -/** - * Pretty printer for expecations. Takes any object and turns it into a human-readable string. - * - * @param value {Object} an object to be outputted - * @returns {String} - */ -jasmine.pp = function(value) { - var stringPrettyPrinter = new jasmine.StringPrettyPrinter(); - stringPrettyPrinter.format(value); - return stringPrettyPrinter.string; -}; - -/** - * Returns true if the object is a DOM Node. - * - * @param {Object} obj object to check - * @returns {Boolean} - */ -jasmine.isDomNode = function(obj) { - return obj.nodeType > 0; -}; - -/** - * Returns a matchable 'generic' object of the class type. For use in expecations of type when values don't matter. - * - * @example - * // don't care about which function is passed in, as long as it's a function - * expect(mySpy).toHaveBeenCalledWith(jasmine.any(Function)); - * - * @param {Class} clazz - * @returns matchable object of the type clazz - */ -jasmine.any = function(clazz) { - return new jasmine.Matchers.Any(clazz); -}; - -/** - * Returns a matchable subset of a JSON object. For use in expectations when you don't care about all of the - * attributes on the object. - * - * @example - * // don't care about any other attributes than foo. - * expect(mySpy).toHaveBeenCalledWith(jasmine.objectContaining({foo: "bar"}); - * - * @param sample {Object} sample - * @returns matchable object for the sample - */ -jasmine.objectContaining = function (sample) { - return new jasmine.Matchers.ObjectContaining(sample); -}; - -/** - * Jasmine Spies are test doubles that can act as stubs, spies, fakes or when used in an expecation, mocks. - * - * Spies should be created in test setup, before expectations. They can then be checked, using the standard Jasmine - * expectation syntax. Spies can be checked if they were called or not and what the calling params were. - * - * A Spy has the following fields: wasCalled, callCount, mostRecentCall, and argsForCall (see docs). - * - * Spies are torn down at the end of every spec. - * - * Note: Do not call new jasmine.Spy() directly - a spy must be created using spyOn, jasmine.createSpy or jasmine.createSpyObj. - * - * @example - * // a stub - * var myStub = jasmine.createSpy('myStub'); // can be used anywhere - * - * // spy example - * var foo = { - * not: function(bool) { return !bool; } - * } - * - * // actual foo.not will not be called, execution stops - * spyOn(foo, 'not'); - - // foo.not spied upon, execution will continue to implementation - * spyOn(foo, 'not').andCallThrough(); - * - * // fake example - * var foo = { - * not: function(bool) { return !bool; } - * } - * - * // foo.not(val) will return val - * spyOn(foo, 'not').andCallFake(function(value) {return value;}); - * - * // mock example - * foo.not(7 == 7); - * expect(foo.not).toHaveBeenCalled(); - * expect(foo.not).toHaveBeenCalledWith(true); - * - * @constructor - * @see spyOn, jasmine.createSpy, jasmine.createSpyObj - * @param {String} name - */ -jasmine.Spy = function(name) { - /** - * The name of the spy, if provided. - */ - this.identity = name || 'unknown'; - /** - * Is this Object a spy? - */ - this.isSpy = true; - /** - * The actual function this spy stubs. - */ - this.plan = function() { - }; - /** - * Tracking of the most recent call to the spy. - * @example - * var mySpy = jasmine.createSpy('foo'); - * mySpy(1, 2); - * mySpy.mostRecentCall.args = [1, 2]; - */ - this.mostRecentCall = {}; - - /** - * Holds arguments for each call to the spy, indexed by call count - * @example - * var mySpy = jasmine.createSpy('foo'); - * mySpy(1, 2); - * mySpy(7, 8); - * mySpy.mostRecentCall.args = [7, 8]; - * mySpy.argsForCall[0] = [1, 2]; - * mySpy.argsForCall[1] = [7, 8]; - */ - this.argsForCall = []; - this.calls = []; -}; - -/** - * Tells a spy to call through to the actual implemenatation. - * - * @example - * var foo = { - * bar: function() { // do some stuff } - * } - * - * // defining a spy on an existing property: foo.bar - * spyOn(foo, 'bar').andCallThrough(); - */ -jasmine.Spy.prototype.andCallThrough = function() { - this.plan = this.originalValue; - return this; -}; - -/** - * For setting the return value of a spy. - * - * @example - * // defining a spy from scratch: foo() returns 'baz' - * var foo = jasmine.createSpy('spy on foo').andReturn('baz'); - * - * // defining a spy on an existing property: foo.bar() returns 'baz' - * spyOn(foo, 'bar').andReturn('baz'); - * - * @param {Object} value - */ -jasmine.Spy.prototype.andReturn = function(value) { - this.plan = function() { - return value; - }; - return this; -}; - -/** - * For throwing an exception when a spy is called. - * - * @example - * // defining a spy from scratch: foo() throws an exception w/ message 'ouch' - * var foo = jasmine.createSpy('spy on foo').andThrow('baz'); - * - * // defining a spy on an existing property: foo.bar() throws an exception w/ message 'ouch' - * spyOn(foo, 'bar').andThrow('baz'); - * - * @param {String} exceptionMsg - */ -jasmine.Spy.prototype.andThrow = function(exceptionMsg) { - this.plan = function() { - throw exceptionMsg; - }; - return this; -}; - -/** - * Calls an alternate implementation when a spy is called. - * - * @example - * var baz = function() { - * // do some stuff, return something - * } - * // defining a spy from scratch: foo() calls the function baz - * var foo = jasmine.createSpy('spy on foo').andCall(baz); - * - * // defining a spy on an existing property: foo.bar() calls an anonymnous function - * spyOn(foo, 'bar').andCall(function() { return 'baz';} ); - * - * @param {Function} fakeFunc - */ -jasmine.Spy.prototype.andCallFake = function(fakeFunc) { - this.plan = fakeFunc; - return this; -}; - -/** - * Resets all of a spy's the tracking variables so that it can be used again. - * - * @example - * spyOn(foo, 'bar'); - * - * foo.bar(); - * - * expect(foo.bar.callCount).toEqual(1); - * - * foo.bar.reset(); - * - * expect(foo.bar.callCount).toEqual(0); - */ -jasmine.Spy.prototype.reset = function() { - this.wasCalled = false; - this.callCount = 0; - this.argsForCall = []; - this.calls = []; - this.mostRecentCall = {}; -}; - -jasmine.createSpy = function(name) { - - var spyObj = function() { - spyObj.wasCalled = true; - spyObj.callCount++; - var args = jasmine.util.argsToArray(arguments); - spyObj.mostRecentCall.object = this; - spyObj.mostRecentCall.args = args; - spyObj.argsForCall.push(args); - spyObj.calls.push({object: this, args: args}); - return spyObj.plan.apply(this, arguments); - }; - - var spy = new jasmine.Spy(name); - - for (var prop in spy) { - spyObj[prop] = spy[prop]; - } - - spyObj.reset(); - - return spyObj; -}; - -/** - * Determines whether an object is a spy. - * - * @param {jasmine.Spy|Object} putativeSpy - * @returns {Boolean} - */ -jasmine.isSpy = function(putativeSpy) { - return putativeSpy && putativeSpy.isSpy; -}; - -/** - * Creates a more complicated spy: an Object that has every property a function that is a spy. Used for stubbing something - * large in one call. - * - * @param {String} baseName name of spy class - * @param {Array} methodNames array of names of methods to make spies - */ -jasmine.createSpyObj = function(baseName, methodNames) { - if (!jasmine.isArray_(methodNames) || methodNames.length === 0) { - throw new Error('createSpyObj requires a non-empty array of method names to create spies for'); - } - var obj = {}; - for (var i = 0; i < methodNames.length; i++) { - obj[methodNames[i]] = jasmine.createSpy(baseName + '.' + methodNames[i]); - } - return obj; -}; - -/** - * All parameters are pretty-printed and concatenated together, then written to the current spec's output. - * - * Be careful not to leave calls to jasmine.log in production code. - */ -jasmine.log = function() { - var spec = jasmine.getEnv().currentSpec; - spec.log.apply(spec, arguments); -}; - -/** - * Function that installs a spy on an existing object's method name. Used within a Spec to create a spy. - * - * @example - * // spy example - * var foo = { - * not: function(bool) { return !bool; } - * } - * spyOn(foo, 'not'); // actual foo.not will not be called, execution stops - * - * @see jasmine.createSpy - * @param obj - * @param methodName - * @returns a Jasmine spy that can be chained with all spy methods - */ -var spyOn = function(obj, methodName) { - return jasmine.getEnv().currentSpec.spyOn(obj, methodName); -}; -if (isCommonJS) exports.spyOn = spyOn; - -/** - * Creates a Jasmine spec that will be added to the current suite. - * - * // TODO: pending tests - * - * @example - * it('should be true', function() { - * expect(true).toEqual(true); - * }); - * - * @param {String} desc description of this specification - * @param {Function} func defines the preconditions and expectations of the spec - */ -var it = function(desc, func) { - return jasmine.getEnv().it(desc, func); -}; -if (isCommonJS) exports.it = it; - -/** - * Creates a disabled Jasmine spec. - * - * A convenience method that allows existing specs to be disabled temporarily during development. - * - * @param {String} desc description of this specification - * @param {Function} func defines the preconditions and expectations of the spec - */ -var xit = function(desc, func) { - return jasmine.getEnv().xit(desc, func); -}; -if (isCommonJS) exports.xit = xit; - -/** - * Starts a chain for a Jasmine expectation. - * - * It is passed an Object that is the actual value and should chain to one of the many - * jasmine.Matchers functions. - * - * @param {Object} actual Actual value to test against and expected value - */ -var expect = function(actual) { - return jasmine.getEnv().currentSpec.expect(actual); -}; -if (isCommonJS) exports.expect = expect; - -/** - * Defines part of a jasmine spec. Used in cominbination with waits or waitsFor in asynchrnous specs. - * - * @param {Function} func Function that defines part of a jasmine spec. - */ -var runs = function(func) { - jasmine.getEnv().currentSpec.runs(func); -}; -if (isCommonJS) exports.runs = runs; - -/** - * Waits a fixed time period before moving to the next block. - * - * @deprecated Use waitsFor() instead - * @param {Number} timeout milliseconds to wait - */ -var waits = function(timeout) { - jasmine.getEnv().currentSpec.waits(timeout); -}; -if (isCommonJS) exports.waits = waits; - -/** - * Waits for the latchFunction to return true before proceeding to the next block. - * - * @param {Function} latchFunction - * @param {String} optional_timeoutMessage - * @param {Number} optional_timeout - */ -var waitsFor = function(latchFunction, optional_timeoutMessage, optional_timeout) { - jasmine.getEnv().currentSpec.waitsFor.apply(jasmine.getEnv().currentSpec, arguments); -}; -if (isCommonJS) exports.waitsFor = waitsFor; - -/** - * A function that is called before each spec in a suite. - * - * Used for spec setup, including validating assumptions. - * - * @param {Function} beforeEachFunction - */ -var beforeEach = function(beforeEachFunction) { - jasmine.getEnv().beforeEach(beforeEachFunction); -}; -if (isCommonJS) exports.beforeEach = beforeEach; - -/** - * A function that is called after each spec in a suite. - * - * Used for restoring any state that is hijacked during spec execution. - * - * @param {Function} afterEachFunction - */ -var afterEach = function(afterEachFunction) { - jasmine.getEnv().afterEach(afterEachFunction); -}; -if (isCommonJS) exports.afterEach = afterEach; - -/** - * Defines a suite of specifications. - * - * Stores the description and all defined specs in the Jasmine environment as one suite of specs. Variables declared - * are accessible by calls to beforeEach, it, and afterEach. Describe blocks can be nested, allowing for specialization - * of setup in some tests. - * - * @example - * // TODO: a simple suite - * - * // TODO: a simple suite with a nested describe block - * - * @param {String} description A string, usually the class under test. - * @param {Function} specDefinitions function that defines several specs. - */ -var describe = function(description, specDefinitions) { - return jasmine.getEnv().describe(description, specDefinitions); -}; -if (isCommonJS) exports.describe = describe; - -/** - * Disables a suite of specifications. Used to disable some suites in a file, or files, temporarily during development. - * - * @param {String} description A string, usually the class under test. - * @param {Function} specDefinitions function that defines several specs. - */ -var xdescribe = function(description, specDefinitions) { - return jasmine.getEnv().xdescribe(description, specDefinitions); -}; -if (isCommonJS) exports.xdescribe = xdescribe; - - -// Provide the XMLHttpRequest class for IE 5.x-6.x: -jasmine.XmlHttpRequest = (typeof XMLHttpRequest == "undefined") ? function() { - function tryIt(f) { - try { - return f(); - } catch(e) { - } - return null; - } - - var xhr = tryIt(function() { - return new ActiveXObject("Msxml2.XMLHTTP.6.0"); - }) || - tryIt(function() { - return new ActiveXObject("Msxml2.XMLHTTP.3.0"); - }) || - tryIt(function() { - return new ActiveXObject("Msxml2.XMLHTTP"); - }) || - tryIt(function() { - return new ActiveXObject("Microsoft.XMLHTTP"); - }); - - if (!xhr) throw new Error("This browser does not support XMLHttpRequest."); - - return xhr; -} : XMLHttpRequest; -/** - * @namespace - */ -jasmine.util = {}; - -/** - * Declare that a child class inherit it's prototype from the parent class. - * - * @private - * @param {Function} childClass - * @param {Function} parentClass - */ -jasmine.util.inherit = function(childClass, parentClass) { - /** - * @private - */ - var subclass = function() { - }; - subclass.prototype = parentClass.prototype; - childClass.prototype = new subclass(); -}; - -jasmine.util.formatException = function(e) { - var lineNumber; - if (e.line) { - lineNumber = e.line; - } - else if (e.lineNumber) { - lineNumber = e.lineNumber; - } - - var file; - - if (e.sourceURL) { - file = e.sourceURL; - } - else if (e.fileName) { - file = e.fileName; - } - - var message = (e.name && e.message) ? (e.name + ': ' + e.message) : e.toString(); - - if (file && lineNumber) { - message += ' in ' + file + ' (line ' + lineNumber + ')'; - } - - return message; -}; - -jasmine.util.htmlEscape = function(str) { - if (!str) return str; - return str.replace(/&/g, '&') - .replace(//g, '>'); -}; - -jasmine.util.argsToArray = function(args) { - var arrayOfArgs = []; - for (var i = 0; i < args.length; i++) arrayOfArgs.push(args[i]); - return arrayOfArgs; -}; - -jasmine.util.extend = function(destination, source) { - for (var property in source) destination[property] = source[property]; - return destination; -}; - -/** - * Environment for Jasmine - * - * @constructor - */ -jasmine.Env = function() { - this.currentSpec = null; - this.currentSuite = null; - this.currentRunner_ = new jasmine.Runner(this); - - this.reporter = new jasmine.MultiReporter(); - - this.updateInterval = jasmine.DEFAULT_UPDATE_INTERVAL; - this.defaultTimeoutInterval = jasmine.DEFAULT_TIMEOUT_INTERVAL; - this.lastUpdate = 0; - this.specFilter = function() { - return true; - }; - - this.nextSpecId_ = 0; - this.nextSuiteId_ = 0; - this.equalityTesters_ = []; - - // wrap matchers - this.matchersClass = function() { - jasmine.Matchers.apply(this, arguments); - }; - jasmine.util.inherit(this.matchersClass, jasmine.Matchers); - - jasmine.Matchers.wrapInto_(jasmine.Matchers.prototype, this.matchersClass); -}; - - -jasmine.Env.prototype.setTimeout = jasmine.setTimeout; -jasmine.Env.prototype.clearTimeout = jasmine.clearTimeout; -jasmine.Env.prototype.setInterval = jasmine.setInterval; -jasmine.Env.prototype.clearInterval = jasmine.clearInterval; - -/** - * @returns an object containing jasmine version build info, if set. - */ -jasmine.Env.prototype.version = function () { - if (jasmine.version_) { - return jasmine.version_; - } else { - throw new Error('Version not set'); - } -}; - -/** - * @returns string containing jasmine version build info, if set. - */ -jasmine.Env.prototype.versionString = function() { - if (!jasmine.version_) { - return "version unknown"; - } - - var version = this.version(); - var versionString = version.major + "." + version.minor + "." + version.build; - if (version.release_candidate) { - versionString += ".rc" + version.release_candidate; - } - versionString += " revision " + version.revision; - return versionString; -}; - -/** - * @returns a sequential integer starting at 0 - */ -jasmine.Env.prototype.nextSpecId = function () { - return this.nextSpecId_++; -}; - -/** - * @returns a sequential integer starting at 0 - */ -jasmine.Env.prototype.nextSuiteId = function () { - return this.nextSuiteId_++; -}; - -/** - * Register a reporter to receive status updates from Jasmine. - * @param {jasmine.Reporter} reporter An object which will receive status updates. - */ -jasmine.Env.prototype.addReporter = function(reporter) { - this.reporter.addReporter(reporter); -}; - -jasmine.Env.prototype.execute = function() { - this.currentRunner_.execute(); -}; - -jasmine.Env.prototype.describe = function(description, specDefinitions) { - var suite = new jasmine.Suite(this, description, specDefinitions, this.currentSuite); - - var parentSuite = this.currentSuite; - if (parentSuite) { - parentSuite.add(suite); - } else { - this.currentRunner_.add(suite); - } - - this.currentSuite = suite; - - var declarationError = null; - try { - specDefinitions.call(suite); - } catch(e) { - declarationError = e; - } - - if (declarationError) { - this.it("encountered a declaration exception", function() { - throw declarationError; - }); - } - - this.currentSuite = parentSuite; - - return suite; -}; - -jasmine.Env.prototype.beforeEach = function(beforeEachFunction) { - if (this.currentSuite) { - this.currentSuite.beforeEach(beforeEachFunction); - } else { - this.currentRunner_.beforeEach(beforeEachFunction); - } -}; - -jasmine.Env.prototype.currentRunner = function () { - return this.currentRunner_; -}; - -jasmine.Env.prototype.afterEach = function(afterEachFunction) { - if (this.currentSuite) { - this.currentSuite.afterEach(afterEachFunction); - } else { - this.currentRunner_.afterEach(afterEachFunction); - } - -}; - -jasmine.Env.prototype.xdescribe = function(desc, specDefinitions) { - return { - execute: function() { - } - }; -}; - -jasmine.Env.prototype.it = function(description, func) { - var spec = new jasmine.Spec(this, this.currentSuite, description); - this.currentSuite.add(spec); - this.currentSpec = spec; - - if (func) { - spec.runs(func); - } - - return spec; -}; - -jasmine.Env.prototype.xit = function(desc, func) { - return { - id: this.nextSpecId(), - runs: function() { - } - }; -}; - -jasmine.Env.prototype.compareObjects_ = function(a, b, mismatchKeys, mismatchValues) { - if (a.__Jasmine_been_here_before__ === b && b.__Jasmine_been_here_before__ === a) { - return true; - } - - a.__Jasmine_been_here_before__ = b; - b.__Jasmine_been_here_before__ = a; - - var hasKey = function(obj, keyName) { - return obj !== null && obj[keyName] !== jasmine.undefined; - }; - - for (var property in b) { - if (!hasKey(a, property) && hasKey(b, property)) { - mismatchKeys.push("expected has key '" + property + "', but missing from actual."); - } - } - for (property in a) { - if (!hasKey(b, property) && hasKey(a, property)) { - mismatchKeys.push("expected missing key '" + property + "', but present in actual."); - } - } - for (property in b) { - if (property == '__Jasmine_been_here_before__') continue; - if (!this.equals_(a[property], b[property], mismatchKeys, mismatchValues)) { - mismatchValues.push("'" + property + "' was '" + (b[property] ? jasmine.util.htmlEscape(b[property].toString()) : b[property]) + "' in expected, but was '" + (a[property] ? jasmine.util.htmlEscape(a[property].toString()) : a[property]) + "' in actual."); - } - } - - if (jasmine.isArray_(a) && jasmine.isArray_(b) && a.length != b.length) { - mismatchValues.push("arrays were not the same length"); - } - - delete a.__Jasmine_been_here_before__; - delete b.__Jasmine_been_here_before__; - return (mismatchKeys.length === 0 && mismatchValues.length === 0); -}; - -jasmine.Env.prototype.equals_ = function(a, b, mismatchKeys, mismatchValues) { - mismatchKeys = mismatchKeys || []; - mismatchValues = mismatchValues || []; - - for (var i = 0; i < this.equalityTesters_.length; i++) { - var equalityTester = this.equalityTesters_[i]; - var result = equalityTester(a, b, this, mismatchKeys, mismatchValues); - if (result !== jasmine.undefined) return result; - } - - if (a === b) return true; - - if (a === jasmine.undefined || a === null || b === jasmine.undefined || b === null) { - return (a == jasmine.undefined && b == jasmine.undefined); - } - - if (jasmine.isDomNode(a) && jasmine.isDomNode(b)) { - return a === b; - } - - if (a instanceof Date && b instanceof Date) { - return a.getTime() == b.getTime(); - } - - if (a.jasmineMatches) { - return a.jasmineMatches(b); - } - - if (b.jasmineMatches) { - return b.jasmineMatches(a); - } - - if (a instanceof jasmine.Matchers.ObjectContaining) { - return a.matches(b); - } - - if (b instanceof jasmine.Matchers.ObjectContaining) { - return b.matches(a); - } - - if (jasmine.isString_(a) && jasmine.isString_(b)) { - return (a == b); - } - - if (jasmine.isNumber_(a) && jasmine.isNumber_(b)) { - return (a == b); - } - - if (typeof a === "object" && typeof b === "object") { - return this.compareObjects_(a, b, mismatchKeys, mismatchValues); - } - - //Straight check - return (a === b); -}; - -jasmine.Env.prototype.contains_ = function(haystack, needle) { - if (jasmine.isArray_(haystack)) { - for (var i = 0; i < haystack.length; i++) { - if (this.equals_(haystack[i], needle)) return true; - } - return false; - } - return haystack.indexOf(needle) >= 0; -}; - -jasmine.Env.prototype.addEqualityTester = function(equalityTester) { - this.equalityTesters_.push(equalityTester); -}; -/** No-op base class for Jasmine reporters. - * - * @constructor - */ -jasmine.Reporter = function() { -}; - -//noinspection JSUnusedLocalSymbols -jasmine.Reporter.prototype.reportRunnerStarting = function(runner) { -}; - -//noinspection JSUnusedLocalSymbols -jasmine.Reporter.prototype.reportRunnerResults = function(runner) { -}; - -//noinspection JSUnusedLocalSymbols -jasmine.Reporter.prototype.reportSuiteResults = function(suite) { -}; - -//noinspection JSUnusedLocalSymbols -jasmine.Reporter.prototype.reportSpecStarting = function(spec) { -}; - -//noinspection JSUnusedLocalSymbols -jasmine.Reporter.prototype.reportSpecResults = function(spec) { -}; - -//noinspection JSUnusedLocalSymbols -jasmine.Reporter.prototype.log = function(str) { -}; - -/** - * Blocks are functions with executable code that make up a spec. - * - * @constructor - * @param {jasmine.Env} env - * @param {Function} func - * @param {jasmine.Spec} spec - */ -jasmine.Block = function(env, func, spec) { - this.env = env; - this.func = func; - this.spec = spec; -}; - -jasmine.Block.prototype.execute = function(onComplete) { - try { - this.func.apply(this.spec); - } catch (e) { - this.spec.fail(e); - } - onComplete(); -}; -/** JavaScript API reporter. - * - * @constructor - */ -jasmine.JsApiReporter = function() { - this.started = false; - this.finished = false; - this.suites_ = []; - this.results_ = {}; -}; - -jasmine.JsApiReporter.prototype.reportRunnerStarting = function(runner) { - this.started = true; - var suites = runner.topLevelSuites(); - for (var i = 0; i < suites.length; i++) { - var suite = suites[i]; - this.suites_.push(this.summarize_(suite)); - } -}; - -jasmine.JsApiReporter.prototype.suites = function() { - return this.suites_; -}; - -jasmine.JsApiReporter.prototype.summarize_ = function(suiteOrSpec) { - var isSuite = suiteOrSpec instanceof jasmine.Suite; - var summary = { - id: suiteOrSpec.id, - name: suiteOrSpec.description, - type: isSuite ? 'suite' : 'spec', - children: [] - }; - - if (isSuite) { - var children = suiteOrSpec.children(); - for (var i = 0; i < children.length; i++) { - summary.children.push(this.summarize_(children[i])); - } - } - return summary; -}; - -jasmine.JsApiReporter.prototype.results = function() { - return this.results_; -}; - -jasmine.JsApiReporter.prototype.resultsForSpec = function(specId) { - return this.results_[specId]; -}; - -//noinspection JSUnusedLocalSymbols -jasmine.JsApiReporter.prototype.reportRunnerResults = function(runner) { - this.finished = true; -}; - -//noinspection JSUnusedLocalSymbols -jasmine.JsApiReporter.prototype.reportSuiteResults = function(suite) { -}; - -//noinspection JSUnusedLocalSymbols -jasmine.JsApiReporter.prototype.reportSpecResults = function(spec) { - this.results_[spec.id] = { - messages: spec.results().getItems(), - result: spec.results().failedCount > 0 ? "failed" : "passed" - }; -}; - -//noinspection JSUnusedLocalSymbols -jasmine.JsApiReporter.prototype.log = function(str) { -}; - -jasmine.JsApiReporter.prototype.resultsForSpecs = function(specIds){ - var results = {}; - for (var i = 0; i < specIds.length; i++) { - var specId = specIds[i]; - results[specId] = this.summarizeResult_(this.results_[specId]); - } - return results; -}; - -jasmine.JsApiReporter.prototype.summarizeResult_ = function(result){ - var summaryMessages = []; - var messagesLength = result.messages.length; - for (var messageIndex = 0; messageIndex < messagesLength; messageIndex++) { - var resultMessage = result.messages[messageIndex]; - summaryMessages.push({ - text: resultMessage.type == 'log' ? resultMessage.toString() : jasmine.undefined, - passed: resultMessage.passed ? resultMessage.passed() : true, - type: resultMessage.type, - message: resultMessage.message, - trace: { - stack: resultMessage.passed && !resultMessage.passed() ? resultMessage.trace.stack : jasmine.undefined - } - }); - } - - return { - result : result.result, - messages : summaryMessages - }; -}; - -/** - * @constructor - * @param {jasmine.Env} env - * @param actual - * @param {jasmine.Spec} spec - */ -jasmine.Matchers = function(env, actual, spec, opt_isNot) { - this.env = env; - this.actual = actual; - this.spec = spec; - this.isNot = opt_isNot || false; - this.reportWasCalled_ = false; -}; - -// todo: @deprecated as of Jasmine 0.11, remove soon [xw] -jasmine.Matchers.pp = function(str) { - throw new Error("jasmine.Matchers.pp() is no longer supported, please use jasmine.pp() instead!"); -}; - -// todo: @deprecated Deprecated as of Jasmine 0.10. Rewrite your custom matchers to return true or false. [xw] -jasmine.Matchers.prototype.report = function(result, failing_message, details) { - throw new Error("As of jasmine 0.11, custom matchers must be implemented differently -- please see jasmine docs"); -}; - -jasmine.Matchers.wrapInto_ = function(prototype, matchersClass) { - for (var methodName in prototype) { - if (methodName == 'report') continue; - var orig = prototype[methodName]; - matchersClass.prototype[methodName] = jasmine.Matchers.matcherFn_(methodName, orig); - } -}; - -jasmine.Matchers.matcherFn_ = function(matcherName, matcherFunction) { - return function() { - var matcherArgs = jasmine.util.argsToArray(arguments); - var result = matcherFunction.apply(this, arguments); - - if (this.isNot) { - result = !result; - } - - if (this.reportWasCalled_) return result; - - var message; - if (!result) { - if (this.message) { - message = this.message.apply(this, arguments); - if (jasmine.isArray_(message)) { - message = message[this.isNot ? 1 : 0]; - } - } else { - var englishyPredicate = matcherName.replace(/[A-Z]/g, function(s) { return ' ' + s.toLowerCase(); }); - message = "Expected " + jasmine.pp(this.actual) + (this.isNot ? " not " : " ") + englishyPredicate; - if (matcherArgs.length > 0) { - for (var i = 0; i < matcherArgs.length; i++) { - if (i > 0) message += ","; - message += " " + jasmine.pp(matcherArgs[i]); - } - } - message += "."; - } - } - var expectationResult = new jasmine.ExpectationResult({ - matcherName: matcherName, - passed: result, - expected: matcherArgs.length > 1 ? matcherArgs : matcherArgs[0], - actual: this.actual, - message: message - }); - this.spec.addMatcherResult(expectationResult); - return jasmine.undefined; - }; -}; - - - - -/** - * toBe: compares the actual to the expected using === - * @param expected - */ -jasmine.Matchers.prototype.toBe = function(expected) { - return this.actual === expected; -}; - -/** - * toNotBe: compares the actual to the expected using !== - * @param expected - * @deprecated as of 1.0. Use not.toBe() instead. - */ -jasmine.Matchers.prototype.toNotBe = function(expected) { - return this.actual !== expected; -}; - -/** - * toEqual: compares the actual to the expected using common sense equality. Handles Objects, Arrays, etc. - * - * @param expected - */ -jasmine.Matchers.prototype.toEqual = function(expected) { - return this.env.equals_(this.actual, expected); -}; - -/** - * toNotEqual: compares the actual to the expected using the ! of jasmine.Matchers.toEqual - * @param expected - * @deprecated as of 1.0. Use not.toEqual() instead. - */ -jasmine.Matchers.prototype.toNotEqual = function(expected) { - return !this.env.equals_(this.actual, expected); -}; - -/** - * Matcher that compares the actual to the expected using a regular expression. Constructs a RegExp, so takes - * a pattern or a String. - * - * @param expected - */ -jasmine.Matchers.prototype.toMatch = function(expected) { - return new RegExp(expected).test(this.actual); -}; - -/** - * Matcher that compares the actual to the expected using the boolean inverse of jasmine.Matchers.toMatch - * @param expected - * @deprecated as of 1.0. Use not.toMatch() instead. - */ -jasmine.Matchers.prototype.toNotMatch = function(expected) { - return !(new RegExp(expected).test(this.actual)); -}; - -/** - * Matcher that compares the actual to jasmine.undefined. - */ -jasmine.Matchers.prototype.toBeDefined = function() { - return (this.actual !== jasmine.undefined); -}; - -/** - * Matcher that compares the actual to jasmine.undefined. - */ -jasmine.Matchers.prototype.toBeUndefined = function() { - return (this.actual === jasmine.undefined); -}; - -/** - * Matcher that compares the actual to null. - */ -jasmine.Matchers.prototype.toBeNull = function() { - return (this.actual === null); -}; - -/** - * Matcher that boolean not-nots the actual. - */ -jasmine.Matchers.prototype.toBeTruthy = function() { - return !!this.actual; -}; - - -/** - * Matcher that boolean nots the actual. - */ -jasmine.Matchers.prototype.toBeFalsy = function() { - return !this.actual; -}; - - -/** - * Matcher that checks to see if the actual, a Jasmine spy, was called. - */ -jasmine.Matchers.prototype.toHaveBeenCalled = function() { - if (arguments.length > 0) { - throw new Error('toHaveBeenCalled does not take arguments, use toHaveBeenCalledWith'); - } - - if (!jasmine.isSpy(this.actual)) { - throw new Error('Expected a spy, but got ' + jasmine.pp(this.actual) + '.'); - } - - this.message = function() { - return [ - "Expected spy " + this.actual.identity + " to have been called.", - "Expected spy " + this.actual.identity + " not to have been called." - ]; - }; - - return this.actual.wasCalled; -}; - -/** @deprecated Use expect(xxx).toHaveBeenCalled() instead */ -jasmine.Matchers.prototype.wasCalled = jasmine.Matchers.prototype.toHaveBeenCalled; - -/** - * Matcher that checks to see if the actual, a Jasmine spy, was not called. - * - * @deprecated Use expect(xxx).not.toHaveBeenCalled() instead - */ -jasmine.Matchers.prototype.wasNotCalled = function() { - if (arguments.length > 0) { - throw new Error('wasNotCalled does not take arguments'); - } - - if (!jasmine.isSpy(this.actual)) { - throw new Error('Expected a spy, but got ' + jasmine.pp(this.actual) + '.'); - } - - this.message = function() { - return [ - "Expected spy " + this.actual.identity + " to not have been called.", - "Expected spy " + this.actual.identity + " to have been called." - ]; - }; - - return !this.actual.wasCalled; -}; - -/** - * Matcher that checks to see if the actual, a Jasmine spy, was called with a set of parameters. - * - * @example - * - */ -jasmine.Matchers.prototype.toHaveBeenCalledWith = function() { - var expectedArgs = jasmine.util.argsToArray(arguments); - if (!jasmine.isSpy(this.actual)) { - throw new Error('Expected a spy, but got ' + jasmine.pp(this.actual) + '.'); - } - this.message = function() { - if (this.actual.callCount === 0) { - // todo: what should the failure message for .not.toHaveBeenCalledWith() be? is this right? test better. [xw] - return [ - "Expected spy " + this.actual.identity + " to have been called with " + jasmine.pp(expectedArgs) + " but it was never called.", - "Expected spy " + this.actual.identity + " not to have been called with " + jasmine.pp(expectedArgs) + " but it was." - ]; - } else { - return [ - "Expected spy " + this.actual.identity + " to have been called with " + jasmine.pp(expectedArgs) + " but was called with " + jasmine.pp(this.actual.argsForCall), - "Expected spy " + this.actual.identity + " not to have been called with " + jasmine.pp(expectedArgs) + " but was called with " + jasmine.pp(this.actual.argsForCall) - ]; - } - }; - - return this.env.contains_(this.actual.argsForCall, expectedArgs); -}; - -/** @deprecated Use expect(xxx).toHaveBeenCalledWith() instead */ -jasmine.Matchers.prototype.wasCalledWith = jasmine.Matchers.prototype.toHaveBeenCalledWith; - -/** @deprecated Use expect(xxx).not.toHaveBeenCalledWith() instead */ -jasmine.Matchers.prototype.wasNotCalledWith = function() { - var expectedArgs = jasmine.util.argsToArray(arguments); - if (!jasmine.isSpy(this.actual)) { - throw new Error('Expected a spy, but got ' + jasmine.pp(this.actual) + '.'); - } - - this.message = function() { - return [ - "Expected spy not to have been called with " + jasmine.pp(expectedArgs) + " but it was", - "Expected spy to have been called with " + jasmine.pp(expectedArgs) + " but it was" - ]; - }; - - return !this.env.contains_(this.actual.argsForCall, expectedArgs); -}; - -/** - * Matcher that checks that the expected item is an element in the actual Array. - * - * @param {Object} expected - */ -jasmine.Matchers.prototype.toContain = function(expected) { - return this.env.contains_(this.actual, expected); -}; - -/** - * Matcher that checks that the expected item is NOT an element in the actual Array. - * - * @param {Object} expected - * @deprecated as of 1.0. Use not.toContain() instead. - */ -jasmine.Matchers.prototype.toNotContain = function(expected) { - return !this.env.contains_(this.actual, expected); -}; - -jasmine.Matchers.prototype.toBeLessThan = function(expected) { - return this.actual < expected; -}; - -jasmine.Matchers.prototype.toBeGreaterThan = function(expected) { - return this.actual > expected; -}; - -/** - * Matcher that checks that the expected item is equal to the actual item - * up to a given level of decimal precision (default 2). - * - * @param {Number} expected - * @param {Number} precision - */ -jasmine.Matchers.prototype.toBeCloseTo = function(expected, precision) { - if (!(precision === 0)) { - precision = precision || 2; - } - var multiplier = Math.pow(10, precision); - var actual = Math.round(this.actual * multiplier); - expected = Math.round(expected * multiplier); - return expected == actual; -}; - -/** - * Matcher that checks that the expected exception was thrown by the actual. - * - * @param {String} expected - */ -jasmine.Matchers.prototype.toThrow = function(expected) { - var result = false; - var exception; - if (typeof this.actual != 'function') { - throw new Error('Actual is not a function'); - } - try { - this.actual(); - } catch (e) { - exception = e; - } - if (exception) { - result = (expected === jasmine.undefined || this.env.equals_(exception.message || exception, expected.message || expected)); - } - - var not = this.isNot ? "not " : ""; - - this.message = function() { - if (exception && (expected === jasmine.undefined || !this.env.equals_(exception.message || exception, expected.message || expected))) { - return ["Expected function " + not + "to throw", expected ? expected.message || expected : "an exception", ", but it threw", exception.message || exception].join(' '); - } else { - return "Expected function to throw an exception."; - } - }; - - return result; -}; - -jasmine.Matchers.Any = function(expectedClass) { - this.expectedClass = expectedClass; -}; - -jasmine.Matchers.Any.prototype.jasmineMatches = function(other) { - if (this.expectedClass == String) { - return typeof other == 'string' || other instanceof String; - } - - if (this.expectedClass == Number) { - return typeof other == 'number' || other instanceof Number; - } - - if (this.expectedClass == Function) { - return typeof other == 'function' || other instanceof Function; - } - - if (this.expectedClass == Object) { - return typeof other == 'object'; - } - - return other instanceof this.expectedClass; -}; - -jasmine.Matchers.Any.prototype.jasmineToString = function() { - return ''; -}; - -jasmine.Matchers.ObjectContaining = function (sample) { - this.sample = sample; -}; - -jasmine.Matchers.ObjectContaining.prototype.jasmineMatches = function(other, mismatchKeys, mismatchValues) { - mismatchKeys = mismatchKeys || []; - mismatchValues = mismatchValues || []; - - var env = jasmine.getEnv(); - - var hasKey = function(obj, keyName) { - return obj != null && obj[keyName] !== jasmine.undefined; - }; - - for (var property in this.sample) { - if (!hasKey(other, property) && hasKey(this.sample, property)) { - mismatchKeys.push("expected has key '" + property + "', but missing from actual."); - } - else if (!env.equals_(this.sample[property], other[property], mismatchKeys, mismatchValues)) { - mismatchValues.push("'" + property + "' was '" + (other[property] ? jasmine.util.htmlEscape(other[property].toString()) : other[property]) + "' in expected, but was '" + (this.sample[property] ? jasmine.util.htmlEscape(this.sample[property].toString()) : this.sample[property]) + "' in actual."); - } - } - - return (mismatchKeys.length === 0 && mismatchValues.length === 0); -}; - -jasmine.Matchers.ObjectContaining.prototype.jasmineToString = function () { - return ""; -}; -// Mock setTimeout, clearTimeout -// Contributed by Pivotal Computer Systems, www.pivotalsf.com - -jasmine.FakeTimer = function() { - this.reset(); - - var self = this; - self.setTimeout = function(funcToCall, millis) { - self.timeoutsMade++; - self.scheduleFunction(self.timeoutsMade, funcToCall, millis, false); - return self.timeoutsMade; - }; - - self.setInterval = function(funcToCall, millis) { - self.timeoutsMade++; - self.scheduleFunction(self.timeoutsMade, funcToCall, millis, true); - return self.timeoutsMade; - }; - - self.clearTimeout = function(timeoutKey) { - self.scheduledFunctions[timeoutKey] = jasmine.undefined; - }; - - self.clearInterval = function(timeoutKey) { - self.scheduledFunctions[timeoutKey] = jasmine.undefined; - }; - -}; - -jasmine.FakeTimer.prototype.reset = function() { - this.timeoutsMade = 0; - this.scheduledFunctions = {}; - this.nowMillis = 0; -}; - -jasmine.FakeTimer.prototype.tick = function(millis) { - var oldMillis = this.nowMillis; - var newMillis = oldMillis + millis; - this.runFunctionsWithinRange(oldMillis, newMillis); - this.nowMillis = newMillis; -}; - -jasmine.FakeTimer.prototype.runFunctionsWithinRange = function(oldMillis, nowMillis) { - var scheduledFunc; - var funcsToRun = []; - for (var timeoutKey in this.scheduledFunctions) { - scheduledFunc = this.scheduledFunctions[timeoutKey]; - if (scheduledFunc != jasmine.undefined && - scheduledFunc.runAtMillis >= oldMillis && - scheduledFunc.runAtMillis <= nowMillis) { - funcsToRun.push(scheduledFunc); - this.scheduledFunctions[timeoutKey] = jasmine.undefined; - } - } - - if (funcsToRun.length > 0) { - funcsToRun.sort(function(a, b) { - return a.runAtMillis - b.runAtMillis; - }); - for (var i = 0; i < funcsToRun.length; ++i) { - try { - var funcToRun = funcsToRun[i]; - this.nowMillis = funcToRun.runAtMillis; - funcToRun.funcToCall(); - if (funcToRun.recurring) { - this.scheduleFunction(funcToRun.timeoutKey, - funcToRun.funcToCall, - funcToRun.millis, - true); - } - } catch(e) { - } - } - this.runFunctionsWithinRange(oldMillis, nowMillis); - } -}; - -jasmine.FakeTimer.prototype.scheduleFunction = function(timeoutKey, funcToCall, millis, recurring) { - this.scheduledFunctions[timeoutKey] = { - runAtMillis: this.nowMillis + millis, - funcToCall: funcToCall, - recurring: recurring, - timeoutKey: timeoutKey, - millis: millis - }; -}; - -/** - * @namespace - */ -jasmine.Clock = { - defaultFakeTimer: new jasmine.FakeTimer(), - - reset: function() { - jasmine.Clock.assertInstalled(); - jasmine.Clock.defaultFakeTimer.reset(); - }, - - tick: function(millis) { - jasmine.Clock.assertInstalled(); - jasmine.Clock.defaultFakeTimer.tick(millis); - }, - - runFunctionsWithinRange: function(oldMillis, nowMillis) { - jasmine.Clock.defaultFakeTimer.runFunctionsWithinRange(oldMillis, nowMillis); - }, - - scheduleFunction: function(timeoutKey, funcToCall, millis, recurring) { - jasmine.Clock.defaultFakeTimer.scheduleFunction(timeoutKey, funcToCall, millis, recurring); - }, - - useMock: function() { - if (!jasmine.Clock.isInstalled()) { - var spec = jasmine.getEnv().currentSpec; - spec.after(jasmine.Clock.uninstallMock); - - jasmine.Clock.installMock(); - } - }, - - installMock: function() { - jasmine.Clock.installed = jasmine.Clock.defaultFakeTimer; - }, - - uninstallMock: function() { - jasmine.Clock.assertInstalled(); - jasmine.Clock.installed = jasmine.Clock.real; - }, - - real: { - setTimeout: jasmine.getGlobal().setTimeout, - clearTimeout: jasmine.getGlobal().clearTimeout, - setInterval: jasmine.getGlobal().setInterval, - clearInterval: jasmine.getGlobal().clearInterval - }, - - assertInstalled: function() { - if (!jasmine.Clock.isInstalled()) { - throw new Error("Mock clock is not installed, use jasmine.Clock.useMock()"); - } - }, - - isInstalled: function() { - return jasmine.Clock.installed == jasmine.Clock.defaultFakeTimer; - }, - - installed: null -}; -jasmine.Clock.installed = jasmine.Clock.real; - -//else for IE support -jasmine.getGlobal().setTimeout = function(funcToCall, millis) { - if (jasmine.Clock.installed.setTimeout.apply) { - return jasmine.Clock.installed.setTimeout.apply(this, arguments); - } else { - return jasmine.Clock.installed.setTimeout(funcToCall, millis); - } -}; - -jasmine.getGlobal().setInterval = function(funcToCall, millis) { - if (jasmine.Clock.installed.setInterval.apply) { - return jasmine.Clock.installed.setInterval.apply(this, arguments); - } else { - return jasmine.Clock.installed.setInterval(funcToCall, millis); - } -}; - -jasmine.getGlobal().clearTimeout = function(timeoutKey) { - if (jasmine.Clock.installed.clearTimeout.apply) { - return jasmine.Clock.installed.clearTimeout.apply(this, arguments); - } else { - return jasmine.Clock.installed.clearTimeout(timeoutKey); - } -}; - -jasmine.getGlobal().clearInterval = function(timeoutKey) { - if (jasmine.Clock.installed.clearTimeout.apply) { - return jasmine.Clock.installed.clearInterval.apply(this, arguments); - } else { - return jasmine.Clock.installed.clearInterval(timeoutKey); - } -}; - -/** - * @constructor - */ -jasmine.MultiReporter = function() { - this.subReporters_ = []; -}; -jasmine.util.inherit(jasmine.MultiReporter, jasmine.Reporter); - -jasmine.MultiReporter.prototype.addReporter = function(reporter) { - this.subReporters_.push(reporter); -}; - -(function() { - var functionNames = [ - "reportRunnerStarting", - "reportRunnerResults", - "reportSuiteResults", - "reportSpecStarting", - "reportSpecResults", - "log" - ]; - for (var i = 0; i < functionNames.length; i++) { - var functionName = functionNames[i]; - jasmine.MultiReporter.prototype[functionName] = (function(functionName) { - return function() { - for (var j = 0; j < this.subReporters_.length; j++) { - var subReporter = this.subReporters_[j]; - if (subReporter[functionName]) { - subReporter[functionName].apply(subReporter, arguments); - } - } - }; - })(functionName); - } -})(); -/** - * Holds results for a set of Jasmine spec. Allows for the results array to hold another jasmine.NestedResults - * - * @constructor - */ -jasmine.NestedResults = function() { - /** - * The total count of results - */ - this.totalCount = 0; - /** - * Number of passed results - */ - this.passedCount = 0; - /** - * Number of failed results - */ - this.failedCount = 0; - /** - * Was this suite/spec skipped? - */ - this.skipped = false; - /** - * @ignore - */ - this.items_ = []; -}; - -/** - * Roll up the result counts. - * - * @param result - */ -jasmine.NestedResults.prototype.rollupCounts = function(result) { - this.totalCount += result.totalCount; - this.passedCount += result.passedCount; - this.failedCount += result.failedCount; -}; - -/** - * Adds a log message. - * @param values Array of message parts which will be concatenated later. - */ -jasmine.NestedResults.prototype.log = function(values) { - this.items_.push(new jasmine.MessageResult(values)); -}; - -/** - * Getter for the results: message & results. - */ -jasmine.NestedResults.prototype.getItems = function() { - return this.items_; -}; - -/** - * Adds a result, tracking counts (total, passed, & failed) - * @param {jasmine.ExpectationResult|jasmine.NestedResults} result - */ -jasmine.NestedResults.prototype.addResult = function(result) { - if (result.type != 'log') { - if (result.items_) { - this.rollupCounts(result); - } else { - this.totalCount++; - if (result.passed()) { - this.passedCount++; - } else { - this.failedCount++; - } - } - } - this.items_.push(result); -}; - -/** - * @returns {Boolean} True if everything below passed - */ -jasmine.NestedResults.prototype.passed = function() { - return this.passedCount === this.totalCount; -}; -/** - * Base class for pretty printing for expectation results. - */ -jasmine.PrettyPrinter = function() { - this.ppNestLevel_ = 0; -}; - -/** - * Formats a value in a nice, human-readable string. - * - * @param value - */ -jasmine.PrettyPrinter.prototype.format = function(value) { - if (this.ppNestLevel_ > 40) { - throw new Error('jasmine.PrettyPrinter: format() nested too deeply!'); - } - - this.ppNestLevel_++; - try { - if (value === jasmine.undefined) { - this.emitScalar('undefined'); - } else if (value === null) { - this.emitScalar('null'); - } else if (value === jasmine.getGlobal()) { - this.emitScalar(''); - } else if (value.jasmineToString) { - this.emitScalar(value.jasmineToString()); - } else if (typeof value === 'string') { - this.emitString(value); - } else if (jasmine.isSpy(value)) { - this.emitScalar("spy on " + value.identity); - } else if (value instanceof RegExp) { - this.emitScalar(value.toString()); - } else if (typeof value === 'function') { - this.emitScalar('Function'); - } else if (typeof value.nodeType === 'number') { - this.emitScalar('HTMLNode'); - } else if (value instanceof Date) { - this.emitScalar('Date(' + value + ')'); - } else if (value.__Jasmine_been_here_before__) { - this.emitScalar(''); - } else if (jasmine.isArray_(value) || typeof value == 'object') { - value.__Jasmine_been_here_before__ = true; - if (jasmine.isArray_(value)) { - this.emitArray(value); - } else { - this.emitObject(value); - } - delete value.__Jasmine_been_here_before__; - } else { - this.emitScalar(value.toString()); - } - } finally { - this.ppNestLevel_--; - } -}; - -jasmine.PrettyPrinter.prototype.iterateObject = function(obj, fn) { - for (var property in obj) { - if (property == '__Jasmine_been_here_before__') continue; - fn(property, obj.__lookupGetter__ ? (obj.__lookupGetter__(property) !== jasmine.undefined && - obj.__lookupGetter__(property) !== null) : false); - } -}; - -jasmine.PrettyPrinter.prototype.emitArray = jasmine.unimplementedMethod_; -jasmine.PrettyPrinter.prototype.emitObject = jasmine.unimplementedMethod_; -jasmine.PrettyPrinter.prototype.emitScalar = jasmine.unimplementedMethod_; -jasmine.PrettyPrinter.prototype.emitString = jasmine.unimplementedMethod_; - -jasmine.StringPrettyPrinter = function() { - jasmine.PrettyPrinter.call(this); - - this.string = ''; -}; -jasmine.util.inherit(jasmine.StringPrettyPrinter, jasmine.PrettyPrinter); - -jasmine.StringPrettyPrinter.prototype.emitScalar = function(value) { - this.append(value); -}; - -jasmine.StringPrettyPrinter.prototype.emitString = function(value) { - this.append("'" + value + "'"); -}; - -jasmine.StringPrettyPrinter.prototype.emitArray = function(array) { - this.append('[ '); - for (var i = 0; i < array.length; i++) { - if (i > 0) { - this.append(', '); - } - this.format(array[i]); - } - this.append(' ]'); -}; - -jasmine.StringPrettyPrinter.prototype.emitObject = function(obj) { - var self = this; - this.append('{ '); - var first = true; - - this.iterateObject(obj, function(property, isGetter) { - if (first) { - first = false; - } else { - self.append(', '); - } - - self.append(property); - self.append(' : '); - if (isGetter) { - self.append(''); - } else { - self.format(obj[property]); - } - }); - - this.append(' }'); -}; - -jasmine.StringPrettyPrinter.prototype.append = function(value) { - this.string += value; -}; -jasmine.Queue = function(env) { - this.env = env; - this.blocks = []; - this.running = false; - this.index = 0; - this.offset = 0; - this.abort = false; -}; - -jasmine.Queue.prototype.addBefore = function(block) { - this.blocks.unshift(block); -}; - -jasmine.Queue.prototype.add = function(block) { - this.blocks.push(block); -}; - -jasmine.Queue.prototype.insertNext = function(block) { - this.blocks.splice((this.index + this.offset + 1), 0, block); - this.offset++; -}; - -jasmine.Queue.prototype.start = function(onComplete) { - this.running = true; - this.onComplete = onComplete; - this.next_(); -}; - -jasmine.Queue.prototype.isRunning = function() { - return this.running; -}; - -jasmine.Queue.LOOP_DONT_RECURSE = true; - -jasmine.Queue.prototype.next_ = function() { - var self = this; - var goAgain = true; - - while (goAgain) { - goAgain = false; - - if (self.index < self.blocks.length && !this.abort) { - var calledSynchronously = true; - var completedSynchronously = false; - - var onComplete = function () { - if (jasmine.Queue.LOOP_DONT_RECURSE && calledSynchronously) { - completedSynchronously = true; - return; - } - - if (self.blocks[self.index].abort) { - self.abort = true; - } - - self.offset = 0; - self.index++; - - var now = new Date().getTime(); - if (self.env.updateInterval && now - self.env.lastUpdate > self.env.updateInterval) { - self.env.lastUpdate = now; - self.env.setTimeout(function() { - self.next_(); - }, 0); - } else { - if (jasmine.Queue.LOOP_DONT_RECURSE && completedSynchronously) { - goAgain = true; - } else { - self.next_(); - } - } - }; - self.blocks[self.index].execute(onComplete); - - calledSynchronously = false; - if (completedSynchronously) { - onComplete(); - } - - } else { - self.running = false; - if (self.onComplete) { - self.onComplete(); - } - } - } -}; - -jasmine.Queue.prototype.results = function() { - var results = new jasmine.NestedResults(); - for (var i = 0; i < this.blocks.length; i++) { - if (this.blocks[i].results) { - results.addResult(this.blocks[i].results()); - } - } - return results; -}; - - -/** - * Runner - * - * @constructor - * @param {jasmine.Env} env - */ -jasmine.Runner = function(env) { - var self = this; - self.env = env; - self.queue = new jasmine.Queue(env); - self.before_ = []; - self.after_ = []; - self.suites_ = []; -}; - -jasmine.Runner.prototype.execute = function() { - var self = this; - if (self.env.reporter.reportRunnerStarting) { - self.env.reporter.reportRunnerStarting(this); - } - self.queue.start(function () { - self.finishCallback(); - }); -}; - -jasmine.Runner.prototype.beforeEach = function(beforeEachFunction) { - beforeEachFunction.typeName = 'beforeEach'; - this.before_.splice(0,0,beforeEachFunction); -}; - -jasmine.Runner.prototype.afterEach = function(afterEachFunction) { - afterEachFunction.typeName = 'afterEach'; - this.after_.splice(0,0,afterEachFunction); -}; - - -jasmine.Runner.prototype.finishCallback = function() { - this.env.reporter.reportRunnerResults(this); -}; - -jasmine.Runner.prototype.addSuite = function(suite) { - this.suites_.push(suite); -}; - -jasmine.Runner.prototype.add = function(block) { - if (block instanceof jasmine.Suite) { - this.addSuite(block); - } - this.queue.add(block); -}; - -jasmine.Runner.prototype.specs = function () { - var suites = this.suites(); - var specs = []; - for (var i = 0; i < suites.length; i++) { - specs = specs.concat(suites[i].specs()); - } - return specs; -}; - -jasmine.Runner.prototype.suites = function() { - return this.suites_; -}; - -jasmine.Runner.prototype.topLevelSuites = function() { - var topLevelSuites = []; - for (var i = 0; i < this.suites_.length; i++) { - if (!this.suites_[i].parentSuite) { - topLevelSuites.push(this.suites_[i]); - } - } - return topLevelSuites; -}; - -jasmine.Runner.prototype.results = function() { - return this.queue.results(); -}; -/** - * Internal representation of a Jasmine specification, or test. - * - * @constructor - * @param {jasmine.Env} env - * @param {jasmine.Suite} suite - * @param {String} description - */ -jasmine.Spec = function(env, suite, description) { - if (!env) { - throw new Error('jasmine.Env() required'); - } - if (!suite) { - throw new Error('jasmine.Suite() required'); - } - var spec = this; - spec.id = env.nextSpecId ? env.nextSpecId() : null; - spec.env = env; - spec.suite = suite; - spec.description = description; - spec.queue = new jasmine.Queue(env); - - spec.afterCallbacks = []; - spec.spies_ = []; - - spec.results_ = new jasmine.NestedResults(); - spec.results_.description = description; - spec.matchersClass = null; -}; - -jasmine.Spec.prototype.getFullName = function() { - return this.suite.getFullName() + ' ' + this.description + '.'; -}; - - -jasmine.Spec.prototype.results = function() { - return this.results_; -}; - -/** - * All parameters are pretty-printed and concatenated together, then written to the spec's output. - * - * Be careful not to leave calls to jasmine.log in production code. - */ -jasmine.Spec.prototype.log = function() { - return this.results_.log(arguments); -}; - -jasmine.Spec.prototype.runs = function (func) { - var block = new jasmine.Block(this.env, func, this); - this.addToQueue(block); - return this; -}; - -jasmine.Spec.prototype.addToQueue = function (block) { - if (this.queue.isRunning()) { - this.queue.insertNext(block); - } else { - this.queue.add(block); - } -}; - -/** - * @param {jasmine.ExpectationResult} result - */ -jasmine.Spec.prototype.addMatcherResult = function(result) { - this.results_.addResult(result); -}; - -jasmine.Spec.prototype.expect = function(actual) { - var positive = new (this.getMatchersClass_())(this.env, actual, this); - positive.not = new (this.getMatchersClass_())(this.env, actual, this, true); - return positive; -}; - -/** - * Waits a fixed time period before moving to the next block. - * - * @deprecated Use waitsFor() instead - * @param {Number} timeout milliseconds to wait - */ -jasmine.Spec.prototype.waits = function(timeout) { - var waitsFunc = new jasmine.WaitsBlock(this.env, timeout, this); - this.addToQueue(waitsFunc); - return this; -}; - -/** - * Waits for the latchFunction to return true before proceeding to the next block. - * - * @param {Function} latchFunction - * @param {String} optional_timeoutMessage - * @param {Number} optional_timeout - */ -jasmine.Spec.prototype.waitsFor = function(latchFunction, optional_timeoutMessage, optional_timeout) { - var latchFunction_ = null; - var optional_timeoutMessage_ = null; - var optional_timeout_ = null; - - for (var i = 0; i < arguments.length; i++) { - var arg = arguments[i]; - switch (typeof arg) { - case 'function': - latchFunction_ = arg; - break; - case 'string': - optional_timeoutMessage_ = arg; - break; - case 'number': - optional_timeout_ = arg; - break; - } - } - - var waitsForFunc = new jasmine.WaitsForBlock(this.env, optional_timeout_, latchFunction_, optional_timeoutMessage_, this); - this.addToQueue(waitsForFunc); - return this; -}; - -jasmine.Spec.prototype.fail = function (e) { - var expectationResult = new jasmine.ExpectationResult({ - passed: false, - message: e ? jasmine.util.formatException(e) : 'Exception', - trace: { stack: e.stack } - }); - this.results_.addResult(expectationResult); -}; - -jasmine.Spec.prototype.getMatchersClass_ = function() { - return this.matchersClass || this.env.matchersClass; -}; - -jasmine.Spec.prototype.addMatchers = function(matchersPrototype) { - var parent = this.getMatchersClass_(); - var newMatchersClass = function() { - parent.apply(this, arguments); - }; - jasmine.util.inherit(newMatchersClass, parent); - jasmine.Matchers.wrapInto_(matchersPrototype, newMatchersClass); - this.matchersClass = newMatchersClass; -}; - -jasmine.Spec.prototype.finishCallback = function() { - this.env.reporter.reportSpecResults(this); -}; - -jasmine.Spec.prototype.finish = function(onComplete) { - this.removeAllSpies(); - this.finishCallback(); - if (onComplete) { - onComplete(); - } -}; - -jasmine.Spec.prototype.after = function(doAfter) { - if (this.queue.isRunning()) { - this.queue.add(new jasmine.Block(this.env, doAfter, this)); - } else { - this.afterCallbacks.unshift(doAfter); - } -}; - -jasmine.Spec.prototype.execute = function(onComplete) { - var spec = this; - if (!spec.env.specFilter(spec)) { - spec.results_.skipped = true; - spec.finish(onComplete); - return; - } - - this.env.reporter.reportSpecStarting(this); - - spec.env.currentSpec = spec; - - spec.addBeforesAndAftersToQueue(); - - spec.queue.start(function () { - spec.finish(onComplete); - }); -}; - -jasmine.Spec.prototype.addBeforesAndAftersToQueue = function() { - var runner = this.env.currentRunner(); - var i; - - for (var suite = this.suite; suite; suite = suite.parentSuite) { - for (i = 0; i < suite.before_.length; i++) { - this.queue.addBefore(new jasmine.Block(this.env, suite.before_[i], this)); - } - } - for (i = 0; i < runner.before_.length; i++) { - this.queue.addBefore(new jasmine.Block(this.env, runner.before_[i], this)); - } - for (i = 0; i < this.afterCallbacks.length; i++) { - this.queue.add(new jasmine.Block(this.env, this.afterCallbacks[i], this)); - } - for (suite = this.suite; suite; suite = suite.parentSuite) { - for (i = 0; i < suite.after_.length; i++) { - this.queue.add(new jasmine.Block(this.env, suite.after_[i], this)); - } - } - for (i = 0; i < runner.after_.length; i++) { - this.queue.add(new jasmine.Block(this.env, runner.after_[i], this)); - } -}; - -jasmine.Spec.prototype.explodes = function() { - throw 'explodes function should not have been called'; -}; - -jasmine.Spec.prototype.spyOn = function(obj, methodName, ignoreMethodDoesntExist) { - if (obj == jasmine.undefined) { - throw "spyOn could not find an object to spy upon for " + methodName + "()"; - } - - if (!ignoreMethodDoesntExist && obj[methodName] === jasmine.undefined) { - throw methodName + '() method does not exist'; - } - - if (!ignoreMethodDoesntExist && obj[methodName] && obj[methodName].isSpy) { - throw new Error(methodName + ' has already been spied upon'); - } - - var spyObj = jasmine.createSpy(methodName); - - this.spies_.push(spyObj); - spyObj.baseObj = obj; - spyObj.methodName = methodName; - spyObj.originalValue = obj[methodName]; - - obj[methodName] = spyObj; - - return spyObj; -}; - -jasmine.Spec.prototype.removeAllSpies = function() { - for (var i = 0; i < this.spies_.length; i++) { - var spy = this.spies_[i]; - spy.baseObj[spy.methodName] = spy.originalValue; - } - this.spies_ = []; -}; - -/** - * Internal representation of a Jasmine suite. - * - * @constructor - * @param {jasmine.Env} env - * @param {String} description - * @param {Function} specDefinitions - * @param {jasmine.Suite} parentSuite - */ -jasmine.Suite = function(env, description, specDefinitions, parentSuite) { - var self = this; - self.id = env.nextSuiteId ? env.nextSuiteId() : null; - self.description = description; - self.queue = new jasmine.Queue(env); - self.parentSuite = parentSuite; - self.env = env; - self.before_ = []; - self.after_ = []; - self.children_ = []; - self.suites_ = []; - self.specs_ = []; -}; - -jasmine.Suite.prototype.getFullName = function() { - var fullName = this.description; - for (var parentSuite = this.parentSuite; parentSuite; parentSuite = parentSuite.parentSuite) { - fullName = parentSuite.description + ' ' + fullName; - } - return fullName; -}; - -jasmine.Suite.prototype.finish = function(onComplete) { - this.env.reporter.reportSuiteResults(this); - this.finished = true; - if (typeof(onComplete) == 'function') { - onComplete(); - } -}; - -jasmine.Suite.prototype.beforeEach = function(beforeEachFunction) { - beforeEachFunction.typeName = 'beforeEach'; - this.before_.unshift(beforeEachFunction); -}; - -jasmine.Suite.prototype.afterEach = function(afterEachFunction) { - afterEachFunction.typeName = 'afterEach'; - this.after_.unshift(afterEachFunction); -}; - -jasmine.Suite.prototype.results = function() { - return this.queue.results(); -}; - -jasmine.Suite.prototype.add = function(suiteOrSpec) { - this.children_.push(suiteOrSpec); - if (suiteOrSpec instanceof jasmine.Suite) { - this.suites_.push(suiteOrSpec); - this.env.currentRunner().addSuite(suiteOrSpec); - } else { - this.specs_.push(suiteOrSpec); - } - this.queue.add(suiteOrSpec); -}; - -jasmine.Suite.prototype.specs = function() { - return this.specs_; -}; - -jasmine.Suite.prototype.suites = function() { - return this.suites_; -}; - -jasmine.Suite.prototype.children = function() { - return this.children_; -}; - -jasmine.Suite.prototype.execute = function(onComplete) { - var self = this; - this.queue.start(function () { - self.finish(onComplete); - }); -}; -jasmine.WaitsBlock = function(env, timeout, spec) { - this.timeout = timeout; - jasmine.Block.call(this, env, null, spec); -}; - -jasmine.util.inherit(jasmine.WaitsBlock, jasmine.Block); - -jasmine.WaitsBlock.prototype.execute = function (onComplete) { - if (jasmine.VERBOSE) { - this.env.reporter.log('>> Jasmine waiting for ' + this.timeout + ' ms...'); - } - this.env.setTimeout(function () { - onComplete(); - }, this.timeout); -}; -/** - * A block which waits for some condition to become true, with timeout. - * - * @constructor - * @extends jasmine.Block - * @param {jasmine.Env} env The Jasmine environment. - * @param {Number} timeout The maximum time in milliseconds to wait for the condition to become true. - * @param {Function} latchFunction A function which returns true when the desired condition has been met. - * @param {String} message The message to display if the desired condition hasn't been met within the given time period. - * @param {jasmine.Spec} spec The Jasmine spec. - */ -jasmine.WaitsForBlock = function(env, timeout, latchFunction, message, spec) { - this.timeout = timeout || env.defaultTimeoutInterval; - this.latchFunction = latchFunction; - this.message = message; - this.totalTimeSpentWaitingForLatch = 0; - jasmine.Block.call(this, env, null, spec); -}; -jasmine.util.inherit(jasmine.WaitsForBlock, jasmine.Block); - -jasmine.WaitsForBlock.TIMEOUT_INCREMENT = 10; - -jasmine.WaitsForBlock.prototype.execute = function(onComplete) { - if (jasmine.VERBOSE) { - this.env.reporter.log('>> Jasmine waiting for ' + (this.message || 'something to happen')); - } - var latchFunctionResult; - try { - latchFunctionResult = this.latchFunction.apply(this.spec); - } catch (e) { - this.spec.fail(e); - onComplete(); - return; - } - - if (latchFunctionResult) { - onComplete(); - } else if (this.totalTimeSpentWaitingForLatch >= this.timeout) { - var message = 'timed out after ' + this.timeout + ' msec waiting for ' + (this.message || 'something to happen'); - this.spec.fail({ - name: 'timeout', - message: message - }); - - this.abort = true; - onComplete(); - } else { - this.totalTimeSpentWaitingForLatch += jasmine.WaitsForBlock.TIMEOUT_INCREMENT; - var self = this; - this.env.setTimeout(function() { - self.execute(onComplete); - }, jasmine.WaitsForBlock.TIMEOUT_INCREMENT); - } -}; - -jasmine.version_= { - "major": 1, - "minor": 2, - "build": 0, - "revision": 1337005947 -}; diff --git a/spec/lib/plugins/coverage-1.3.5.jar b/spec/lib/plugins/coverage-1.3.5.jar deleted file mode 100644 index a54010d..0000000 Binary files a/spec/lib/plugins/coverage-1.3.5.jar and /dev/null differ diff --git a/spec/shieldSpec.js b/spec/shieldSpec.js index 5fef63e..b2cb8a8 100644 --- a/spec/shieldSpec.js +++ b/spec/shieldSpec.js @@ -1,7 +1,7 @@ describe('shield.js', function() { - describe('Shield#normalize', function() { + describe('shield#normalize', function() { it('should return normalized error synchronously', function() { - var obj = Shield.normalize(); + var obj = shield.normalize(); expect(obj.stack).toEqual([]); expect(obj.stack.length).toBe(0); }); @@ -10,11 +10,11 @@ describe('shield.js', function() { expect(obj.stack).toEqual([]); expect(obj.stack.length).toBe(0); }; - Shield.normalize(cb); + shield.normalize(cb); }) }); - describe('Shield#report', function() { + describe('shield#report', function() { }); }); diff --git a/src/shield.jquery.js b/src/shield.jquery.js new file mode 100644 index 0000000..cbc7567 --- /dev/null +++ b/src/shield.jquery.js @@ -0,0 +1,114 @@ +/*global extendFunction, $, shield, _, onuncaughtException */ +/* + +Wish jQuery would bark when you had a bad selector? +Maybe `$('#buttonn')` was a typo or `#button` actually +isn't on the page. Fail safely w/ `$('#button', failsafe)` + +Simple copy pasta version without shield.js: + +*/ +function shield_jquery_js() { + 'use strict'; + + if (window.failsafe) { + console.log('looks like you already have a failsafe variable defined. '); + } else { + window.failsafe = 'failsafe'; + } + + // Don't like throwing errors? Define $.badSelectorAction to be whatever you want. + function badSelectorAction( selector, context, originalResult ) { + if (window.console && console.warn) { + console.warn( 'empty selector:' + selector, context ); + } + return originalResult; + } + $.badSelectorAction = badSelectorAction; + + //Feel free to stop reading here! + extendFunction('$', function strictSelectorOverride( args, oldjQuery ) { + var selector = args[0]; + var context = args[1]; + + //if it's not a string or clearly html.. + if ( typeof selector !== 'string' || + ( selector.charAt( 0 ) === '<' && + selector.charAt( selector.length - 1 ) === '>' && + selector.length >= 3 ) + ) + { + return oldjQuery.apply(this, arguments); + } + + if ( context === 'failsafe' ) { + return oldjQuery.call(this, selector); //don't do apply because context is 'failsafe' + } else { + var result = oldjQuery.apply(this, arguments); + if (typeof result.length === 'number') { + if (result.length > 0) { + return result; + } else { + return $.badSelectorAction.call(this, selector, context, result); + } + } else { + //.length is undefined or not a number, result is unknown, just return it. + return result; + } + } + }); + + shield('$, $.fn.on, $.fn.ready'); + + + //get a stack trace for failed ajax requests + extendFunction('$.ajax', function ajaxFailExtension(args, prevFunc) { + try { // have to try/throw/catch to get stack in safari + throw new Error('manually created stack'); + } catch (e) { + var stackOnSend = e.stack; + } + + //prevFunc is the original $.ajax + //call that and store the value to return + var ret = prevFunc.apply(this, args); + + // when we have a offline failure -> que -> retry when online system setup, we'll want to use this + /* (https://gist.github.com/devinrhode2/4491219) + //modify the fail function to only call failure callbacks if we are actually online. + //If we are offline, que the request to re-try periodically, and then complete all the requests in the order initiatd + ret.fail = extendFunction(ret.fail, function offlineRetryGuardFail(args) { + //punting offline check/retry stuff + if (offline + //report + if (typeof onuncaughtException !== 'undefined' && _.isFunction(onuncaughtException)) { + onuncaughtException({stack: stackOnSend, message: args[0]}); + } + + //nothing returned, so extendFunction calls + //the original fail function and returns + //the value returned from it + }); + */ + + //add a fail callback that will log the stack leading up the to the failed request. + //This will only fire for failures that happen when you're online, thanks to the above code (coming soon) + ret.fail(function failCallbackWithStack() { + console.error( + /* Strip out our libraries' function calls */ + 'ajax error! stack on send:' + stackOnSend.replace(/^ajaxFailExtension@[^\n]*/gim, '').replace('extendedFunc\n\n', ''), + '\n\nargs:', arguments + ); + if (arguments[2].message) { + console.error(arguments[2].message); + } + }); + return ret; + }); +} + +if (typeof $ !== 'undefined' && _.isFunction($)) { + shield_jquery_js(); +} else { + console.warn('looks like $ is undefined, call shield_jquery_js() when jQuery is loaded'); +} diff --git a/src/shield.js b/src/shield.js index 350aa98..cb735bb 100644 --- a/src/shield.js +++ b/src/shield.js @@ -1,55 +1,322 @@ -/*! Shield.js v0.0.1 - Stack traces and moar - MIT licensed - https://github.com/Shield/shield.js */ +/*extendFunction: false, historicalConsole: false, sendUncaughtException: false*/ +(function shieldJS() { + 'use strict' -/** - * @method exceptionalException - * - * exceptionalException - * You know, for something that should REALLY never occur - */ -var exceptionalException = function exceptionalExceptionFn(message) { - 'use strict'; - alert('HOLY MOLY! Please email this error to support@domain.com: \n\nSubject:Error\n' + message); -}; + // IE < 9 doesn't support .call/.apply on setInterval/setTimeout, but it + // also only supports 2 arguments and doesn't care what "this" is, so we + // can just call the original function directly. + function applyPatch(irrelevantThis, args) { + return this(args[0], args[1]) + } + setTimeout.apply || (setTimeout.apply = applyPatch) + setInterval.apply || (setInterval.apply = applyPatch) // No need to patch .call since we can never assume 1 argument. + // This is the only thing we need to do to support IE < 9, and for simplicity should always stay here + + // local sendUncaughtException may call global sendUncaughtException + function sendUncaughtException(e) { + if (window.sendUncaughtException) { + return sendUncaughtException(e) + } else if (window.onuncaughtException) { + return onuncaughtException(e) + } else { + throw e + } + } /** - * @class Shield - */ -var Shield = (function shieldWrapper() { - 'use strict'; - - function Shield_normalize(callback) { - if(callback == null) { - // do synchronous normalization - return {stack: []}; - } - // Do async things like remote fetching, etc - return callback({ - stack: [], - url: location.href - //... + +## The main shield function does a few things: + + +1.) Wraps a callback in a try/catch block: + +``` +shield(function(){ + //your program +})() +``` + +2.) Optionally include a `console` param to use our historicalConsole plugin to include console.log's in your error reports. + +``` +shield(function(console){ +})() +``` + +For documentation regarding keeping a console history, see +github.com/devinrhode2/historicalConsole.js +

+ +3.) Modify global api functions so their callbacks are also wrapped in a try/catch block: + +``` +shield('$') +shield('$, $.fn.on, $.fn.ready') + + +//Now errors in these callbacks will be caught, and there's no need for a try/catch block: +$(function(){}) +$('#foo').on('click', function(){}) +$(document).ready(function(){}) +``` + +4.) Use it for easier try/catch blocks. Instead of: + +``` +var func = function() { + //your function +} + +// add shield: +var func = shield(function(){ + //no need for a try/catch block now, shield has it taken care of +}) +``` + +This function and all shield methods should not be invoked with `new` + + +@class shield +@type Function +@param apiFn {String || Function || Array} A string must represent a global function like `'$'`, or a space/comma-space seperated list like `'$, $.fn.ready'`
+ Pass in a function, and it will be shieled and returned. `shield`'ing means this function and callbacks + passed as parameters to it will have all exceptions sent to onuncaughtError, or shield subscribers. (example 4) +@param {String} [promises] Space or comma-space separated list of promise functions to shield (like $.ajax().done) +@return {Function} A function that will have all uncaught exceptions sent to your shield.js subscribers, or onuncaughtException if you overwrote the function. You shield.unsubscribe(shield.report) +*/ + function shield(apiFn, promises) { + if (_.isString(apiFn)) { + if (apiFn.indexOf(' ') > -1) { + apiFn.replace(/\,/g, '') //allow '$, $.fn.on, $.fn.ready' + apiFn = apiFn.split(' ') + } + } + if (_.isArray(apiFn)) { + _.each(apiFn, function(api){ + shield(api) + }) + return + } + return extendFunction(apiFn, function(args, prevFunc) { + apiFn = null //garbage collected + + //if function.length (number of listed parameters) is 1, and there are no args, then this is + //shield(function(console){})() + //ie, prevFunc expects 1 arg (length) but received none when called + if (prevFunc.length === 1 && args.length === 0) { + + //verify a 'console' param + var prevFnString = prevFunc.toString() + var firstParen = prevFnString.indexOf('(') + var secondParen = prevFnString.indexOf(')', firstParen) + if (prevFnString.substring(firstParen, secondParen).indexOf('console') > -1) { + if (window.historicalConsole) { + //historicalConsole takes in a function and returns one that will receive the first arg as the console. + //The second arg is a unique identifier to use another scope's historical console object + //options.url is probably a deent unique identifier. + //We could ask the user to name the app (shield.options.appName('thing') + return historicalConsole(prevFunc/*, options.url*/) + } else { + console.log('to use our historicalConsole please use a build which contains historicalConsole.js') + return prevFunc + } + } else { + return prevFunc + } + } else { + //instead of just doing apiFn.apply, we interate through args + //and if an arg is a function then we wrap then we swap that fn for callback in a try/catch + var length = args.length + //before executing the overriden function, transform each function arg to have a try/catch wrapper + //I'd prefer to keep the while/length style iteration here for performance, since this can be rather important + var arg + while (arg = args[--length]) { + if (_.isFunction(arg)) { + arg = shield_wrap(arg) + } + } + + //now we apply the modified arguments: + var ret = prevFunc.apply(this, args) + if (promises) { + promises = promises.split(' ') + var promise + while(promise = promises.pop()) { + ret[promise] = shield(ret[promise]) + } + } + return ret + } }); } /** - * @method Shield_report - * @param arg {Error || Object || String} - * @constructor + * Export shield out to another variable, e.g., `myModule.shield = shield.noConflict();` + * + * @method noConflict + * @namespace shield + * @return {Function} the currently defined window.shield (now defined to the previous + window.shield, which may or may not be defined) */ - function Shield_report(arg) { - //If object or string AND it has no stack property, add one by doing .stack = (new Error('force-added stack')).stack - Shield.normalize(function(jsonErrorReport) { - //send to subscribers - //if no subscribers.. then throw an error or alert? - //If we were to throw in this situation, I would call that an exceptionalException, and call that function above - }); + var oldShield = window.shield //window.shield may or may not be defined. + function shield_noConflict() { + window.shield = oldShield + return shield + } + + + /** + * ### shield.wrap, wrap a function in a try/catch block while preserving prototypes and properties + * + * @method wrap + * @namespace shield + * @param func {Function} Function to wrap in try/catch block + * @return {Function} + */ + function shield_wrap(func) { + // Define a function that simply returns what func returns, and forwards the arguments + function wrappedFunction() { + try { + /* + If someone does new SomeWrappedFunction(), + the value of this is an instanceof wrappedFunction. + + But thanks to the line at the bottom of shield_wrap, + wrappedFunction is an instanceof the original function, + `this` gets all the right properties, but a resulting objects properties may not + be it's *own* properties.. well this check shows there are zero side effects: + + function printThis() { + this.prop = 'this.prop value!'; + console.log('this:', this); + console.log('this.proto:', this.prototype); + } + printThis.prototype.protoProp = 'protoProp value!'; + function printProperties(obj) { + for (var p in obj) { + console.log( + (obj.hasOwnProperty(p) ? '... OWNED ' : 'NOT OWNED ') + p + ': ' + obj[p] + ); + } + } + printThis(); + printProperties(new printThis()); + printThis = shield_wrap(printThis); + printThis(); + printProperties(new printThis()); + */ + return func.apply(this, Array.prototype.slice.call(arguments) ) + } catch (uncaughtException) { + return sendUncaughtException(uncaughtException) + } + } + + // Copy properties over: + for (var prop in func) { + if (Object.prototype.hasOwnProperty.call(func, prop)) { + wrappedFunction[prop] = func[prop] + } + } + // actually does setting wrappedFunction.prototype to func.prototype below preserve properties, making the above for loop unnecessary + + //maintain/preserve prototype and constructor chains. Note: we're not actually creating a new class. + wrappedFunction.prototype = func.prototype + wrappedFunction.constructor = func.constructor + wrappedFunction.name = func.name || 'anonymous_shield_wrapped_function' + // if check non-standard function properties: + if (typeof func.length !== 'undefined') { // if 0, then wrappedFunction.length already === 0 + wrappedFunction.length = func.length //wrappedFunction doesn't list arguments! so we at least copy over the 'length' of arguments. + } + if (func.__proto__) { + wrappedFunction.__proto__ = func.__proto__ + } + + //Note: if someone does `new shield_wrap(..)` nothing different happens at all. + return wrappedFunction + } // end shield_wrap + + /** + * shield.report reports an exception to the server.. + * + * shield.report returns nothing. + * + * @method report + * @namespace shield + * @type Function + */ + function shield_report() { + return analytics.track.apply(analytics, arguments); + } + + window['onuncaughtException'] = function(ex) { + // Ensure stack property is computed. Or, attempt to alias Opera 10's stacktrace property to it + ex.stack || (ex.stacktrace ? (ex.stack = ex.stacktrace) : '') + var message = ex.message + try { + //because we don't want to duplicate the message with the + delete ex.message + } catch (e) { + alert('exception doing `delete ex.message`. e.message:' + e.message + ' e.stack: ' + e.stack + ' e.stacktrace: ' + e.stacktrace) + throw e + } + if (window.analytics && analytics.track) { + analytics.track(message, exception) + } else { + console.log('nowhere to send this exception', ex) + alert('analytics.track is not defined, so shield.js does not know what to do with the console.log\'d exception') + } + } + + shield.wrap = shield_wrap + shield.report = shield_report + shield.noConflict = shield_noConflict + + // Export/define library just like lodash + + // Used to determine if values are of the language type Object + var objectTypes = { + 'function': true, + 'object': true } - return { - report: Shield_report, - normalize: Shield_normalize - }; -})(); + // Used as a reference to the global object + var root = (objectTypes[typeof window] && window) || this; + + // Detect free variable `exports` + var freeExports = objectTypes[typeof exports] && exports && !exports.nodeType && exports; + + // Detect free variable `module` + var freeModule = objectTypes[typeof module] && module && !module.nodeType && module; + + // Detect the popular CommonJS extension `module.exports` + var moduleExports = freeModule && freeModule.exports === freeExports && freeExports; -Shield.options = { - foo: 'bar' -}; + // Detect free variable `global` from Node.js or Browserified code and use it as `root` + var freeGlobal = objectTypes[typeof global] && global; + if (freeGlobal && (freeGlobal.global === freeGlobal || freeGlobal.window === freeGlobal)) { + root = freeGlobal; + } + + // some AMD build optimizers like r.js check for condition patterns like the following: + if (typeof define == 'function' && typeof define.amd == 'object' && define.amd) { + // define as a named module like jQuery and underscore.js + define("shield", [], function () { + return shield; + }); + } + // check for `exports` after `define` in case a build optimizer adds an `exports` object + else if (freeExports && freeModule) { + // in Node.js or RingoJS + if (moduleExports) { + freeModule.exports = shield; + } + // in Narwhal or Rhino -require + else { + freeExports.shield = shield; + } + } + else { + // in a browser or Rhino + root.shield = shield; + } +}).call(this) \ No newline at end of file