Ejecutar pruebas unitarias de JavaScript de forma directa en una compilación de Integración Continua

Como me las arreglé para llegar a una solución yo mismo, pensé que sería una buena idea compartirla. El enfoque puede no ser impecable, pero es el primero que parecía funcionar. Siéntase libre de publicar mejoras y sugerencias.

Lo que hice en pocas palabras: {[13]]}

• Lanzar una instancia de Xvfb , un framebuffer virtual
• Utilizando JsTestDriver :
  • inicie una instancia de Firefox en el framebuffer virtual (sin cabeza)
  • capture la instancia Firefox y ejecute el conjunto de pruebas
  • generar resultados de pruebas compatibles con JUnit .XML
• Utilice Bamboo para inspeccionar el archivo de resultados para pasar o fallar la compilación

Pasaré a continuación por las fases más detalladas. Esto es lo que mi estructura de directorios terminó pareciendo:

lib/
    JsTestDriver.jar
test/
    qunit/
            equiv.js
            QUnitAdapter.js
    jsTestDriver.conf
    run_js_tests.sh
    tests.js
test-reports/
build.xml

En el servidor de compilación:

• Instalar Xvfb (apt-get install Xvfb)
• Instalar Firefox (apt-get install firefox)

En su aplicación que se construirá:

• Instalar JsTestDriver: http://code.google.com/p/js-test-driver /
  • agregue los adaptadores QUnit equiv.js y QUnitAdapter.js
  • configurar JsTestDriver (jsTestDriver.conf):

server: http://localhost:4224

load:
# Load QUnit adapters (may be omitted if QUnit is not used)
  - qunit/equiv.js
  - qunit/QUnitAdapter.js   

# Tests themselves (you'll want to add more files)
  - tests.js

Crear un archivo de script para ejecutar las pruebas unitarias y generar los resultados de las pruebas (ejemplo en Bash, run_js_tests.sh):

#!/bin/bash
# directory to write output XML (if this doesn't exist, the results will not be generated!)
OUTPUT_DIR="../test-reports"
mkdir $OUTPUT_DIR

XVFB=`which Xvfb`
if [ "$?" -eq 1 ];
then
    echo "Xvfb not found."
    exit 1
fi

FIREFOX=`which firefox`
if [ "$?" -eq 1 ];
then
    echo "Firefox not found."
    exit 1
fi

$XVFB :99 -ac &    # launch virtual framebuffer into the background
PID_XVFB="$!"      # take the process ID
export DISPLAY=:99 # set display to use that of the xvfb

# run the tests
java -jar ../lib/JsTestDriver.jar --config jsTestDriver.conf --port 4224 --browser $FIREFOX --tests all --testOutput $OUTPUT_DIR

kill $PID_XVFB     # shut down xvfb (firefox will shut down cleanly by JsTestDriver)
echo "Done."

Crear un destino Ant que llame al script:

<target name="test">        
    <exec executable="cmd" osfamily="windows">
        <!-- This might contain something different in a Windows environment -->
    </exec>

    <exec executable="/bin/bash" dir="test" osfamily="unix">
        <arg value="run_js_tests.sh" />
    </exec>
</target>   

Finalmente, dile al plan de construcción de Bamboo que invoque el objetivo test y busque los resultados de la prueba JUnit. Aquí el valor predeterminado "**/test-reports/*.xml" estará bien.