k3po.js is used to run K3po Scripts against JavaScript libraries in both the browser and node modules.
- Control Transport Factory which provides communication protocol for contacting k3po driver
- Control.js, a k3po control protocol that is used by talk to the K3po Driver via a Transport that provides an API for starting/stopping k3po scripts
- BrowserRunner, which provides a mechanism for running javascript test functions in a browser
- mocha-k3po.js, a mocha plugin that can control k3po scripts as part of the test framework, and run them in browser or locally via configuration
The K3po driver is launched prior to tests via grunt-k3po plugin
Test code is written using a mocha extension
### Building
1. install grunt-k3po plugin (needed as it is not officiall released yet). `npm install <directory of grunt-plugin>`
=======
var chai = require('chai');
var WebSocket = require('websocket').w3cwebsocket;
describe('WsClient', function () {
// configure k3po settings, such as script root on where to load scripts
k3poConfig.scriptRoot('org/kaazing/specification/utils');
// configure browser settings, such as origin, and resource libraries to load, here it
// is chai, which is used as an assert in the test
browserConfig.origin('http://localhost:8080').addResource("http://chaijs.com/chai.js");
// everything inside function will be executed in the runtime environment, which can be a browser
it('full.feature.test/server', function (done) {
var echoText = "12345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345";
var ws = new WebSocket("ws://localhost:8080/echo");
ws.onopen = function () {
k3po.notify("CLIENT_READY_TO_READ");
k3po.await("SERVER_READY_TO_READ").then(function () {
ws.send(echoText);
});
};
ws.onmessage = function (event) {
chai.assert.equal(event.data, echoText);
ws.close();
};
ws.onclose = ws.onerror = function () {
done();
};
});
}Configuration via Grunt
// configure k3po driver to run prior to tests
k3po: {
start: {
options: {
goal: "start"
}
},
stop: {
options: {
goal: "stop"
}
},
daemon: {
options: {
goal: "start",
daemon: false
}
}
},
// configure mocha to run using mocka-k3po extension
mochaTest: {
// configure to run in node
testMochaK3po: {
options: {
reporter: 'spec',
ui: 'mocha-k3po',
require: 'lib/testFrameworks/mocha-k3po.js',
captureFile: "build/testMochaK3po.txt"
},
src: ['test/testFrameworks/mocha-k3po*.js']
},
// configure to run in browser
testMochaK3poBrowserSupport: {
options: {
reporter: 'spec',
ui: 'mocha-k3po',
require: 'lib/testFrameworks/mocha-k3po.js',
captureFile: "build/testMochaK3po.txt",
browser: {
desiredCapabilities: {
// browser capabilities are documented at http://webdriver.io/
browserName: 'firefox'
}
}
},
src: ['test/testFrameworks/mocha-k3po*.js']
}
}
// Note: due to mocha bug, tests can't be ran twice in a row via grunt due to global state that is not cleaned,
// so you will need multiple grunt profiles
grunt.registerTask('default', ['k3po:start', 'mochaTest:testMochaK3po']);
grunt.registerTask('firefox', ['k3po:start', 'mochaTest:testMochaK3poBrowserSupport']);npm installgrunt
By default the browser closes after the test, in case of test failures you can pass the debug flag to the browser configuration as shown to keep it open. This allows access to the browser javascript console.
browser: {
desiredCapabilities: {
browserName: 'firefox'
},
debug: true
}
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent