X-Git-Url: https://git.ucc.asn.au/?a=blobdiff_plain;f=testing%2Fqunit%2Funit-tests.js;h=12bb76ad2c8c680a29411c821cef0bd09e1ea8b0;hb=0f827545e0eb6846608da4aaf4dc8047478070a4;hp=c16b8c916a8676ed17b29ad01ec5766ba3fa5d53;hpb=acfa0e6c1ccbbaa00025b209272c46b386588d48;p=matches%2FMCTX3420.git diff --git a/testing/qunit/unit-tests.js b/testing/qunit/unit-tests.js index c16b8c9..12bb76a 100644 --- a/testing/qunit/unit-tests.js +++ b/testing/qunit/unit-tests.js @@ -2,70 +2,140 @@ * MCTX3420 2013 - Remote pressurised can experiment. * Unit testing for the server API. * These unit tests use the QUnit unit testing framework. - * @requires QUnit and jQuery + * @requires QUnit, jQuery, and base64.js * @date 28/8/13 * @author Jeremy Tan */ -var api = location.protocol + "//" + location.host + "/api/"; +//Namespace ut + +ut = {}; +ut.api = location.protocol + "//" + location.host + "/api/"; +ut.ckey = undefined; +ut.controlcb = $.Callbacks(); /** * Sends an AJAX query to the API * @param {string} module The name of the module to be queried - * @param {Object} opts Object containing parameters to pass to module - * @param {function} callback Function that receives JSON data - * @param {string} username Optional - * @param {string} password Required if username specified - * @returns JSON data + * @param {Object} opts Object holding the parameters, username, password and + * callback. The parameters should be an object of key/value + * pairs. + * @returns jqXHR object (but calls callback with JSON data, or null on AJAX error) */ -function query(module, opts, callback, username, password) { - function buildQuery(opts) { - var result = "?"; - var first = true; - - for (key in opts) { - if (!first) - result += "&"; - else - first = false; - result += encodeURIComponent(key) + - (opts.key ? "=" + encodeURIComponent(opts.key) : ""); - } - return result; - } +function query(module, opts) { + var queryurl = ut.api + module; - var queryurl = api + module; - if (opts) - queryurl += buildQuery(opts); + var authfunc; + if (opts.username) { + authfunc = function(xhr) { + xhr.setRequestHeader("Authorization", + "Basic " + base64.encode(opts.username + ":" + opts.password)); + }; + } - $.ajax({ + return $.ajax({ url: queryurl, type: 'GET', dataType: 'json', - beforeSend: !username ? undefined : function (xhr) { - xhr.setRequestHeader("Authorization", - "Basic " + btoa(username + ":" + password)); - } - }).done(callback) + data: opts.params, + beforeSend: authfunc, + async: opts.async + }).done(opts.callback) .fail(function(jqXHR) { - if (jqXHR.status === 400) { - callback($.parseJSON(jqXHR.responseText)); - } else { - callback({status:-999, - description: jqXHR.status.toString() + " " + jqXHR.responseText}); - } + ok(false, "Request failed: " + jqXHR.status.toString() + " " + jqXHR.statusText); + opts.callback(null); }); } -QUnit.test("API Existence", function () { - stop(); //????? - query("test", undefined, function(data) { - equal(parseInt(data.status, 10), -1, "Nonexistent module"); //Magic numbers! +QUnit.module("API basics"); +QUnit.asyncTest("API Existence (identify)", function () { + query("identify", {callback : function(data) { start(); - }); + ok(data.status > 0, "Return status"); + ok(data.description, data.description); + ok(data.build_date, data.build_date); + }}); +}); - /*query("version", undefined, function (data) { - assert.equal(data.status, 0); - });*/ - +QUnit.asyncTest("Invalid module", function () { + query("dontexist", {callback : function(data) { + start(); + ok(data.status < 0); + }}); +}); + +QUnit.module("Sensors"); +QUnit.asyncTest("Existence", function() { + query("sensors", {params : {id : 0}, callback : function(data) { + start(); + ok(data.status > 0, "Return status"); + ok(data.data !== undefined, "Data field existence"); + var result = "Data: "; + for (var i = 0; i < data.data.length; i++) { + result += data.data[i][0] + ":" + data.data[i][1] + ", "; + } + ok(true, result); + }}); +}); + +QUnit.asyncTest("Invalid sensor id 1", function() { + query("sensors", {params : {id : 999}, callback : function(data) { + start(); + ok(data.status < 0, "Return status"); + }}); +}); + +QUnit.asyncTest("Invalid sensor id 2", function() { + query("sensors", {params : {id : ""}, callback : function(data) { + start(); + ok(data.status < 0, "Return status"); + }}); +}); + +QUnit.asyncTest("Out of bounds sensor id 1", function() { + query("sensors", {params : {id : "-1"}, callback : function(data) { + start(); + ok(data.status < 0, "Return status"); + }}); +}); + +QUnit.asyncTest("Out of bounds sensor id 2", function() { + query("sensors", {params : {id : "999"}, callback : function(data) { + start(); + ok(data.status < 0, "Return status"); + }}); +}); + +QUnit.module("Controls and access"); +QUnit.asyncTest("Gaining access", function() { + ut.controlcb.add(function () { + query("control", {params : {action : "start", force : true}, + username : $("#username").val(), password : $("#password").val(), + async : false, + callback : function(data) { + start(); + ok(data.status > 0, "Return status"); + ut.ckey = data.key; + }}); + }); +}); + +QUnit.asyncTest("Setting actuator value", function () { + ut.controlcb.add(function () { + query("control", {params : {action : "set", id : 0, + username : $("#username").val(), password : $("#password").val(), + value : 200, key : ut.ckey}, + callback : function(data) { + start(); + ok(data.status > 0, "Return status"); + ok(true, data.description); + }}); + }); +}); + +$(document).ready(function(){ + $("#control").submit(function () { + ut.controlcb.fire(); + return false; + }); }); \ No newline at end of file