topical media & game development
lib-jquery-style-custom-development-bundle-external-qunit-testrunner.js / js
/*
* QUnit - jQuery unit testrunner
*
* http://docs.jquery.com/QUnit
*
* Copyright (c) 2008 John Resig, Jörn Zaefferer
* Dual licensed under the MIT (MIT-LICENSE.txt)
* and GPL (GPL-LICENSE.txt) licenses.
*
*
*/
(function(.map( location.search.slice(1).split('&'), decodeURIComponent ),
ngindex = .extend(window, {
test: test,
module: module,
expect: expect,
ok: ok,
equals: equals,
start: start,
stop: stop,
reset: reset,
isLocal: config.isLocal,
same: function(a, b, message) {
push(equiv(a, b), a, b, message);
},
QUnit: {
equiv: equiv,
ok: ok,
done: function(failures, total){},
log: function(result, message){}
},
// legacy methods below
isSet: isSet,
isObj: isObj,
compare: function() {
throw "compare is deprecated - use same() instead";
},
compare2: function() {
throw "compare2 is deprecated - use same() instead";
},
serialArray: function() {
throw "serialArray is deprecated - use jsDump.parse() instead";
},
q: q,
t: t,
url: url,
triggerEvent: triggerEvent
});
window.load(function() {
$('#userAgent').html(navigator.userAgent);
var head = $('<div class="testrunner-toolbar"><label for="filter-pass">Hide passed tests</label></div>').insertAfter("#userAgent");
$('<input type="checkbox" id="filter-pass" />').attr("disabled", true).prependTo(head).click(function() {
$('li.pass')[this.checked ? 'hide' : 'show']();
});
$('<input type="checkbox" id="filter-missing">').attr("disabled", true).appendTo(head).click(function() {
$("li.fail:contains('missing test - untested code is broken code')").parent('ol').parent('li.fail')[this.checked ? 'hide' : 'show']();
});
$("#filter-missing").after('<label for="filter-missing">Hide missing tests (untested code is broken code)</label>');
runTest();
});
function synchronize(callback) {
config.queue.push(callback);
if(!config.blocking) {
process();
}
}
function process() {
while(config.queue.length && !config.blocking) {
config.queue.shift()();
}
}
function stop(timeout) {
config.blocking = true;
if (timeout)
config.timeout = setTimeout(function() {
QUnit.ok( false, "Test timed out" );
start();
}, timeout);
}
function start() {
// A slight delay, to avoid any current callbacks
setTimeout(function() {
if(config.timeout)
clearTimeout(config.timeout);
config.blocking = false;
process();
}, 13);
}
function validTest( name ) {
var i = config.filters.length,
run = false;
if( !i )
return true;
while( i-- ){
var filter = config.filters[i],
not = filter.charAt(0) == '!';
if( not )
filter = filter.slice(1);
if( name.indexOf(filter) != -1 )
return !not;
if( not )
run = true;
}
return run;
}
function runTest() {
config.blocking = false;
var started = +new Date;
config.fixture = document.getElementById('main').innerHTML;
config.ajaxSettings = .grep( dirty, function(name){
return .extend({
setup: function() {},
teardown: function() {}
}, config.moduleLifecycle);
if ( !validTest(name) )
return;
synchronize(function() {
config.assertions = [];
config.expected = null;
try {
if( !pollution )
saveGlobal();
lifecycle.setup();
} catch(e) {
QUnit.ok( false, "Setup failed on " + name + ": " + e.message );
}
})
synchronize(function() {
try {
callback();
} catch(e) {
if( typeof console != "undefined" && console.error && console.warn ) {
console.error("Test " + name + " died, exception and test follows");
console.error(e);
console.warn(callback.toString());
}
QUnit.ok( false, "Died on test #" + (config.assertions.length + 1) + ": " + e.message );
// else next test will carry the responsibility
saveGlobal();
}
});
synchronize(function() {
try {
checkPollution();
lifecycle.teardown();
} catch(e) {
QUnit.ok( false, "Teardown failed on " + name + ": " + e.message );
}
})
synchronize(function() {
try {
reset();
} catch(e) {
if( typeof console != "undefined" && console.error && console.warn ) {
console.error("reset() failed, following Test " + name + ", exception and reset fn follows");
console.error(e);
console.warn(reset.toString());
}
}
if(config.expected && config.expected != config.assertions.length) {
QUnit.ok( false, "Expected " + config.expected + " assertions, but " + config.assertions.length + " were run" );
}
var good = 0, bad = 0;
var ol = $("<ol/>").hide();
config.stats.all += config.assertions.length;
for ( var i = 0; i < config.assertions.length; i++ ) {
var assertion = config.assertions[i];
$("<li/>").addClass(assertion.result ? "pass" : "fail").text(assertion.message || "(no message)").appendTo(ol);
assertion.result ? good++ : bad++;
}
config.stats.bad += bad;
var b = $("<strong/>").html(name + " <b style='color:black;'>(<b class='fail'>" + bad + "</b>, <b class='pass'>" + good + "</b>, " + config.assertions.length + ")</b>")
.click(function(){
this.next().toggle();
})
.dblclick(function(event) {
var target = $(event.target).filter("strong").clone();
if ( target.length ) {
target.children().remove();
location.href = location.href.match(/^(.+?)(\?.*)?.trim(target.text()));
}
});
$("<li/>").addClass(bad ? "fail" : "pass").append(b).append(ol).appendTo("#tests");
if(bad) {
$("#filter-pass").attr("disabled", null);
$("#filter-missing").attr("disabled", null);
}
});
}
// call on start of module test to prepend name to all tests
function module(name, lifecycle) {
config.currentModule = name;
config.moduleLifecycle = lifecycle;
}
Specify the number of expected assertions to gurantee that failed test (no assertions are run at all) don't slip through.
function expect(asserts) {
config.expected = asserts;
}
Resets the test setup. Useful for tests that modify the DOM.
function reset() {
$("#main").html( config.fixture );
.ajaxSettings =
Asserts true.
@example ok( $("a").size() > 5, "There must be at least 5 anchors" );
function ok(a, msg) {
QUnit.log(a, msg);
config.assertions.push({
result: !!a,
message: msg
});
}
Asserts that two arrays are the same
function isSet(a, b, msg) {
function serialArray( a ) {
var r = [];
if ( a && a.length )
for ( var i = 0; i < a.length; i++ ) {
var str = a[i].nodeName;
if ( str ) {
str = str.toLowerCase();
if ( a[i].id )
str += "#" + a[i].id;
} else
str = a[i];
r.push( str );
}
return "[ " + r.join(", ") + " ]";
}
var ret = true;
if ( a && b && a.length != undefined && a.length == b.length ) {
for ( var i = 0; i < a.length; i++ )
if ( a[i] != b[i] )
ret = false;
} else
ret = false;
QUnit.ok( ret, !ret ? (msg + " expected: " + serialArray(b) + " result: " + serialArray(a)) : msg );
}
Asserts that two objects are equivalent
function isObj(a, b, msg) {
var ret = true;
if ( a && b ) {
for ( var i in a )
if ( a[i] != b[i] )
ret = false;
for ( i in b )
if ( a[i] != b[i] )
ret = false;
} else
ret = false;
QUnit.ok( ret, msg );
}
Returns an array of elements with the given IDs, eg.
@example q("main", "foo", "bar")
@result [<div id="main">, <span id="foo">, <input id="bar">]
function q() {
var r = [];
for ( var i = 0; i < arguments.length; i++ )
r.push( document.getElementById( arguments[i] ) );
return r;
}
Asserts that a select matches the given IDs
@example t("Check for something", "//[a]", ["foo", "baar"]);
@result returns true if "//[a]" return two elements with the IDs 'foo' and 'baar'
function t(a,b,c) {
var f = b;
var s = "";
for ( var i = 0; i < f.length; i++ )
s += (s && ",") + '"' + f[i].id + '"';
isSet(f, q.apply(q,c), a + " (" + b + ")");
}
Add random number to url to stop IE from caching
@example url("data/test.html")
@result "data/test.html?10538358428943"
@example url("data/test.php?foo=bar")
@result "data/test.php?foo=bar&10538358345554"
function url(value) {
return value + (/\?/.test(value) ? "&" : "?") + new Date().getTime() + "" + parseInt(Math.random()*100000);
}
Checks that the first two arguments are equal, with an optional message.
Prints out both actual and expected values.
Prefered to ok( actual == expected, message )
@example equals( .format("Received {0} bytes.", 2), "Received 2 bytes." );
parameter: Object actual
parameter: Object expected
parameter: String message (optional)
function equals(actual, expected, message) {
push(expected == actual, actual, expected, message);
}
function push(result, actual, expected, message) {
message = message || (result ? "okay" : "failed");
QUnit.ok( result, result ? message + ": " + expected : message + ", expected: " + jsDump.parse(expected) + " result: " + jsDump.parse(actual) );
}
Trigger an event on an element.
@example triggerEvent( document.body, "click" );
parameter: DOMElement elem
parameter: String type
function triggerEvent( elem, type, event ) {
if ( .browser.opera ) {
event = document.createEvent("MouseEvents");
event.initMouseEvent(type, true, true, elem.ownerDocument.defaultView,
0, 0, 0, 0, 0, false, false, false, false, 0, null);
elem.dispatchEvent( event );
} else if (
jsDump
Copyright (c) 2008 Ariel Flesler - aflesler(at)gmail(dot)com | http://flesler.blogspot.com
Licensed under BSD (http://www.opensource.org/licenses/bsd-license.php)
Date: 5/15/2008
@projectDescription Advanced and extensible data dumping for Javascript.
version: 1.0.0
author: Ariel Flesler
gray {http://flesler.blogspot.com/2008/05/jsdump-pretty-dump-of-any-javascript.html}
(function(){
function quote( str ){
return '"' + str.toString().replace(/"/g, '\\"') + '"';
};
function literal( o ){
return o + '';
};
function join( pre, arr, post ){
var s = jsDump.separator(),
base = jsDump.indent();
inner = jsDump.indent(1);
if( arr.join )
arr = arr.join( ',' + s + inner );
if( !arr )
return pre + post;
return [ pre, inner + arr, base + post ].join(s);
};
function array( arr ){
var i = arr.length, ret = Array(i);
this.up();
while( i-- )
ret[i] = this.parse( arr[i] );
this.down();
return join( '[', ret, ']' );
};
var reName = /^function (\w+)/;
var jsDump = window.jsDump = {
parse:function( obj, type ){//type is used mostly internally, you can fix a (custom)type in advance
var parser = this.parsers[ type || this.typeOf(obj) ];
type = typeof parser;
return type == 'function' ? parser.call( this, obj ) :
type == 'string' ? parser :
this.parsers.error;
},
typeOf:function( obj ){
var type = typeof obj,
f = 'function';//we'll use it 3 times, save it
return type != 'object' && type != f ? type :
!obj ? 'null' :
obj.exec ? 'regexp' :// some browsers (FF) consider regexps functions
obj.getHours ? 'date' :
obj.scrollBy ? 'window' :
obj.nodeName == '#document' ? 'document' :
obj.nodeName ? 'node' :
obj.item ? 'nodelist' : // Safari reports nodelists as functions
obj.callee ? 'arguments' :
obj.call || obj.constructor != Array && //an array would also fall on this hack
(obj+'').indexOf(f) != -1 ? f : //IE reports functions like alert, as objects
'length' in obj ? 'array' :
type;
},
separator:function(){
return this.multiline ? this.HTML ? '<br />' : '\n' : this.HTML ? ' ' : ' ';
},
indent:function( extra ){// extra can be a number, shortcut for increasing-calling-decreasing
if( !this.multiline )
return '';
var chr = this.indentChar;
if( this.HTML )
chr = chr.replace(/\t/g,' ').replace(/ /g,' ');
return Array( this._depth_ + (extra||0) ).join(chr);
},
up:function( a ){
this._depth_ += a || 1;
},
down:function( a ){
this._depth_ -= a || 1;
},
setParser:function( name, parser ){
this.parsers[name] = parser;
},
// The next 3 are exposed so you can use them
quote:quote,
literal:literal,
join:join,
//
_depth_: 1,
// This is the list of parsers, to modify them, use jsDump.setParser
parsers:{
window: '[Window]',
document: '[Document]',
error:'[ERROR]', //when no parser is found, shouldn't happen
unknown: '[Unknown]',
'null':'null',
undefined:'undefined',
'function':function( fn ){
var ret = 'function',
name = 'name' in fn ? fn.name : (reName.exec(fn)||[])[1];//functions never have name in IE
if( name )
ret += ' ' + name;
ret += '(';
ret = [ ret, this.parse( fn, 'functionArgs' ), '){'].join('');
return join( ret, this.parse(fn,'functionCode'), '}' );
},
array: array,
nodelist: array,
arguments: array,
object:function( map ){
var ret = [ ];
this.up();
for( var key in map )
ret.push( this.parse(key,'key') + ': ' + this.parse(map[key]) );
this.down();
return join( '{', ret, '}' );
},
node:function( node ){
var open = this.HTML ? '<' : '<',
close = this.HTML ? '>' : '>';
var tag = node.nodeName.toLowerCase(),
ret = open + tag;
for( var a in this.DOMAttrs ){
var val = node[this.DOMAttrs[a]];
if( val )
ret += ' ' + a + '=' + this.parse( val, 'attribute' );
}
return ret + close + open + '/' + tag + close;
},
functionArgs:function( fn ){//function calls it internally, it's the arguments part of the function
var l = fn.length;
if( !l ) return '';
var args = Array(l);
while( l-- )
args[l] = String.fromCharCode(97+l);//97 is 'a'
return ' ' + args.join(', ') + ' ';
},
key:quote, //object calls it internally, the key part of an item in a map
functionCode:'[code]', //function calls it internally, it's the content of the function
attribute:quote, //node calls it internally, it's an html attribute value
string:quote,
date:quote,
regexp:literal, //regex
number:literal,
'boolean':literal
},
DOMAttrs:{//attributes to dump from nodes, name=>realName
id:'id',
name:'name',
'class':'className'
},
HTML:false,//if true, entities are escaped ( <, >, \t, space and \n )
indentChar:' ',//indentation unit
multiline:true //if true, items in a collection, are separated by a \n, else just a space.
};
})();
(C) Æliens
20/2/2008
You may not copy or print any of this material without explicit permission of the author or the publisher.
In case of other copyright issues, contact the author.