Javascript testing in Adobe AIR

I'm in the process of migrating a web application to an Adobe AIR application and I finally got around to trying to migrate some of my JavaScript unit tests to run in AIR. I'd previously written some doh tests and wanted to get them up and running in AIR. Turns out it was relatively simple. All you need to do is:

In your apache configuration file, add an entry to point to the base of your AIR project:

<VirtualHost *>
   ServerName air-testing.my.domain
   DocumentRoot /path/to/my/trunk/htdocs
</VirtualHost>

(The htdocs directory here should have a subdirectory called dojo which has the 4 dojo subdirectories (dojo, dijit, dojox, util)

Then, in the .html file where you previously had a <meta> redirect (lets call this runTests.html - it probably looked something like this)

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html lang="en-US" dir="ltr" xmlns="http://www.w3.org/1999/xhtml">
   <head>
       <title>My Unit Tests</title>
       <meta http-equiv="REFRESH" content="0; url=../../dojo/util/doh/runner.html?testModule=my.module.testAll&registerModulePath=mydomain,../../mydomain">
   </head>
   <body>
       Redirecting to D.O.H runner.
   </body>
</html>

... change this file to look like this:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html lang="en-US" dir="ltr" xmlns="http://www.w3.org/1999/xhtml">
   <head>
       <title>My Unit Tests</title>
       <script type="text/javascript">
           var addOnLoad = function() {
               window.location = "http://air-testing.my.domain/dojo/util/doh/runner.html?testModule=my.module.testAll&registerModulePath=mydomain,../../mydomain"";
           }
       </script>
   </head>
   <body onload="addOnLoad();">
       Redirecting to D.O.H runner.
   </body>
</html>

I found it useful to have a testing application descriptor xml file in the same directory as my runTests.html test file:

<?xml version="1.0" encoding="utf-8" ?>
<application xmlns="http://ns.adobe.com/air/application/1.5">
   <id>tests</id>
   <filename>runTests</filename>
   <name>
       <text xml:lang="en_US">Run Tests</text>
   </name>
   <version>0.0001</version>
   <description>
       <text xml:lang="en_US">Run Tests</text>
   </description>
   <initialWindow>
       <title>TESTS</title>
       <content>runTests.html</content>
       <systemChrome>standard</systemChrome>
       <transparent>false</transparent>
       <visible>true</visible>
       <width>1250</width>
       <height>900</height>
       <x>20</x>
       <y>20</y>
       <minimizable>true</minimizable>
       <maximizable>true</maximizable>
       <minSize>850 636</minSize>
       <resizable>true</resizable>
   </initialWindow>
</application>

Running adl on this new test application descriptor file should kick off your doh unit tests.

Handy Firefox plugin

This was pointed out to me today - Window Resizer allows you view your own browser in different resolutions. Not everyone has a massive 30" display!! I've definitely made the mistake in the past to develop for just my own resolution. Would be really cool if automated testing frameworks like D'OH or Selinium could be integrated with this plugin so you could run your test suits against a list of resolutions you need to support.

Google Analytics has a sub tab which lets you know the screen resolutions of your visitors. Its under Visitors -> Browser Capabilities -> Screen Resolutions.