Grails Application with AngularJS: Tests on build server – Part 4

In the previous post, we got karma running on your local systems, as part of grails unit test plans, enabling continual test against Chrome. How do you ensure your unit tests are running in a build server like Jenkins or Bamboo?

PhantomJS is a headless webkit, ie a browser with no browser UI. Make these changes in your karma.conf.js

browsers: ['Chrome', 'PhantomJS'],
plugins: [
 'karma-jasmine',
 'karma-chrome-launcher',
 'karma-phantomjs-launcher',
 'karma-remote-reporter'
 ]

Now run the karma test again:

cmd> cd c:\projects\angrails
cmd> karma start test\javascript\config\karma.conf.js

Warning: Native modules not compiled. XOR performance will be degraded.
Warning: Native modules not compiled. UTF-8 validation disabled.
INFO [karma]: Karma v0.10.9 server started at http://localhost:8001/
INFO [launcher]: Starting browser Chrome
INFO [launcher]: Starting browser PhantomJS
INFO [Chrome 33.0.1750 (Windows 7)]: Connected on socket Tsk76f8qRWk84nVP6jlC
INFO [PhantomJS 1.9.2 (Windows 7)]: Connected on socket oMQSWXNcCW6hNOoH6jlD
PhantomJS 1.9.2 (Windows 7) LOG: ‘angrails manifest load complete.’
PhantomJS 1.9.2 (Windows 7) LOG: ‘calling’
Chrome 33.0.1750 (Windows 7) LOG: ‘angrails manifest load complete.’
Chrome 33.0.1750 (Windows 7) LOG: ‘calling’
Chrome 33.0.1750 (Windows 7): Executed 1 of 1 SUCCESS (0.352 secs / 0.029 secs)
PhantomJS 1.9.2 (Windows 7): Executed 1 of 1 SUCCESS (0.273 secs / 0.018 secs)
TOTAL: 2 SUCCESS

Notice that Karma runs tests against PhantomJS too. You can also add Firefox, IE and test your javascripts against multiple browsers simultaneously.

Additional Notes

But for your build server you need to test just against PhantomJS and not other browsers. One way to do this, is to create a copy of karma.conf.js as karma.local-conf.js. Use the local copy for your local unit tests and the default karma.conf.js for the builds (ie only PhantomJS). This way grails test-app runs against the karma.conf.js in your build server.

Remember you need to install node.js, karma and other components in the build server too.

In Part 5, we shall see how to invoke grails urls/services from AngularJS.

Advertisements

Grails application with AngularJS: Karma with test-app – Part 3

In Part 2, we added karma test runner to our AnGrails application. Its great that you can test your javascripts on the fly locally. What about testing it as part of your grails test-app lifecycle ?

Step: Setup JUnit/Karma integration so that karma can run via grails test-app

Edit BuildConfig.groovy

Add the following line under plugins

test ':karma-test-runner:0.2.0'

See karma-test-runner grails plugin for more information.

Create new file c:/projects/angrails/test/unit/angrails/JavaScriptUnitTestKarmaSuite.java

Add the following text:

package angrails;
import de.is24.util.karmatestrunner.junit.KarmaTestSuiteRunner;
import org.junit.runner.RunWith;
@RunWith(KarmaTestSuiteRunner.class)
@KarmaTestSuiteRunner.KarmaConfigPath("./test/javascript/config/karma.conf.js")
@KarmaTestSuiteRunner.KarmaRemoteServerPort(9876)
public class JavaScriptUnitTestKarmaSuite {
}

Run the test.

cmd> grails test-app

| Compiling 1 source files.....
Karma will be started with process builder args: [karma.cmd, start, C:\projects\angrails\.\test\javascript\config\karma.conf.js]
| Running 1 javascript test...
Starting karma result receiver server on localhost:9889
Warning: Native modules not compiled. XOR performance will be degraded.
INFO [karma]: Karma v0.10.9 server started at http://localhost:8001/
Warning: Native modules not compiled. UTF-8 validation disabled.
INFO [launcher]: Starting browser Chrome
INFO [Chrome 33.0.1750 (Windows 7)]: Connected on socket yX5XSRbnYl_IzwQp7ocG
LOG: 'angrails manifest load complete.'
LOG: 'calling'
Chrome 33.0.1750 (Windows 7): Executed 1 of 1 SUCCESS (0.248 secs / 0.03 secs)

Issues

If one of the following errors occur:

Could not load class in test type ‘javascript’
ERROR [karma]: { [Error: listen EACCES] code: ‘EACCES’, errno: ‘EACCES’, syscall: ‘listen’ }

There is some issue with how the karma is being started via test-app. I found both cmd line grails test-app and invoking via IntelliJ grails cmd window (Alt+G) yield different results. The common problem of both errors seems to be the port number that karma starts on.

Solutions

1. Change the port number in karma.conf.js to 8001 or try another number (above 1024 and available).
2. Remove line of the port number specified in JavaScriptUnitTestKarmaSuite.java: @KarmaTestSuiteRunner.KarmaRemoteServerPort(8001)

Results

With the above settings (ie karma.conf.js:port = 8001 and no port specified in the java code), the test-app works fine in both IntelliJ and command line.

During your test runs, sometimes the port binding is not released when test is shutdown. On *nix systems, you can just use kill <process-id>. For Windows, use PowerShell and do the following:

netstat -o -n -a | findstr "<portnumber>"
stop-process -Id <pid>

In Part 3, we saw how to add karma to grails test-app lifecycle.
In Part 4, lets see how to get karma tests running on your build server.

Grails application with AngularJS: Adding Karma – Part 2

Step: Install karma, karma cli and angular-mocks

cmd> cd c:/projects/angrails
cmd> mkdir test\javascript\config
cmd> mkdir test\javascript\unit
cmd> mkdir test\javascript\lib
cmd> npm install -g karma
cmd> npm install -g karma-cli
cmd> cd c:/projects/angrails/test/javascript/lib

As of this writing, angular-mocks is at v1.2.14 and does not work with angular v1.2.12. When Karma is run, it fails with following error:

Failed to instantiate module ngMock due to Unknown provider: $$rAFProvider

I had to go back to a previous version of angular-mocks v1.2.3. So install v1.2.3:

cmd> bower install angular-mocks#1.2.3

Both angular and angular-mocks will be installed in c:/projects/angrails/test/javascript/lib/bower_components. You can delete the “angular” directory, because we already included it in the grails-app/assets. You would rather not want two angular imports in your project, as you must remember to update both for version changes.

Step: Configure karma

cmd> cd c:/projects/angrails/test/javascript/config
cmd> karma init karma.conf.js

#Answer in the following manner (of course you can choose to answer differently)

Which testing framework do you want to use ?
Press tab to list possible options. Enter to move to the next question.
> jasmine
Do you want to use Require.js ?
This will add Require.js plugin.
Press tab to list possible options. Enter to move to the next question.
> no
Do you want to capture a browser automatically ?
Press tab to list possible options. Enter empty string to move to the next question.
> Chrome
>
What is the location of your source and test files ?
You can use glob patterns, eg. "js/*.js" or "test/**/*Spec.js".
Enter empty string to move to the next question.
> ../../../grails-app/assets/bower_components/jquery/dist/jquery.js
> ../../../grails-app/assets/bower_components/angular/angular.js
> ../../../grails-app/assets/javascripts/**/*.js
> ../../../test/javascript/lib/bower_components/angular-mocks/angular-mocks.js
> ../../../test/javascript/unit/**/*.js
>
Should any of the files included by the previous patterns be excluded ?
You can use glob patterns, eg. "**/*.swp".
Enter empty string to move to the next question.
>
Do you want Karma to watch all the files and run the tests on change ?
Press tab to list possible options.
> yes
Config file generated at "c:\projects\angrails\test\javascript\config\karma.conf.js".

Optionally, you can edit the karma.conf.js and set the basepath to: basePath: ‘./../../../’, and remove the ../../../ from the file includes.

Step: Start Karma

cmd> karma start karma.conf.js

You should see a chrome browser started pointing to 9876 port. There is nothing to test yet. Keep the Karma running.

Step: Add Angular code

Add a test: test/javascript/unit/controllersSpec.js

'use strict';
describe('angrailsTest', function () {
beforeEach(module('angrailsApp'));
var scope, mainCtrl;
beforeEach(inject(function ($compile, $rootScope) {
 scope = $rootScope.$new();
 }));
describe('angrailsMainCtrl', function () {
beforeEach(inject(function ($controller) {
 mainCtrl = $controller("MainCtrl", {$scope: scope});
 }));
it("should set hello text", function () {
 var helloText = 'Hello Angular Demo!';
 expect(scope.helloText).toEqual(helloText);
 });
})
});

Angular Application module: grails-app/assets/javascripts/angrailsApp.js

var angrailsApp = angular.module('angrailsApp', []);
angrailsApp.controller('MainCtrl', ['$scope',
 function ($scope) {
 $scope.helloText = 'Hello Angrails Demo!';
 }
])

Application dependencies: grails-app/assets/javascripts/application.js

Add line between angular and views:

//= require angular/angular
//= require angrailsApp
//= require_tree views

When you modify the js files, keep watching the karma window, it will run tests automatically. Currently it must have failed, because our test is incorrect:

In controllersSpec.js, change

var helloText = 'Hello Angular Demo!';

to

var helloText = 'Hello Angrails Demo!';

and watch the Karma window, it should pass.

In Part 2, We added Karma to our application. Karma can test javascripts independently. What if we want to test it as part of our grails test lifecycle?

In Part 3, lets ensure that Karma is part of the grails application test lifecycle.