Something like this:
describe("pure awesomeness", function() {
it("should be amazing!", function() {
expect(stuff).toEqual("amazing");
});
it("should be awesome", function() {
expect(moreStuff).toBe("awesome");
});
});
describe("coolness", function() {
it("should be cooler than ice when freezed", function() {
var coolness = CoolingRepository.beCool();
coolness.freeze();
expect(coolness.coolnessRatio).toBe(-100);
});
it("should be cool enough by default", function() {
expect(CoolingRepository.beCool().coolnessRatio).toBe(-5);
});
});Being translated into something like this:
Quite simple, it's a custsom Java Junit Runner that allows you to embed Javascript Unit tests (using Jasmine) in your Java-based projects. It fully integrates with your most beloved IDE, your most hated version control system and of course your most needed CI env.
So let's rephrase:
- Run Javascript (the Jasmine - behavior driven - way) "specs" in Java
- Talks like a duck-erhm, any other Junit Java test. Just use a custom annotation (see below)
- Executes super-fast. No browser required. Hocus-pocus. (Rhino + Envjs magic)
Yes and no. Not explicitly using the Jasmine Junit XML Reporter, but since it's a Java Junit Result, your build process will do that for you. Maven surefire plugins will generate the needed result files, for Jenkins to pick up. Your stacktrace/failure message will be something like:
Expected x to be y (zz.js, #458)
Just like the default Jasmine HTML reporter. (So, to answer the question: yes!)
Yes! It allows you to test your jQuery plugins or your spaghetti GUI+Logic code, neatly woven together.
You can use jasmine-jquery matchers. I've modified jasmine.Fixtures to support Envjs+Rhino. This means you can test stuff like this:
beforeEach(function() {
loadFixtures("myFixture.html");
});
it("should be visible and blue", function() {
var div = $('#myDivInFixtureHtml');
expect(div).toBeVisible();
expect(div.css('color')).toBe('blue');
});Fixtures are automatically cleaned up. See src/test/javascript/lib/jasminedir/jasmine-jquery-rhino.js
See env.utils.js. Cover your eyes - hacks present.
Yes! When the debug mode flag in @JasmineSuite has been set to true, you can use the Rhino Debugger to set breakpoints.
After pressing "GO", the tests will run and you can inspect stuff and step through the code.
Tough luck. I've tried to get JSDT working but no avail. You can still use Firebug to debug when generating a specRunner HTML file (see below).
- Fork this project.
- Create some Jasmine specs, place them in some folder.
- Create a Junit test class, annotate it with
@RunWith(JasmineTestRunner.class) - Fill in the blanks using
@JasmineSuite
@JasmineSuite allows you to set these options:
- debug: use the built-in Rhino debugger (gives you the chance to set a breakpoint before firing the test suite)
- jsRootDir: the javascript install root dir. Jasmine and other should be installed here (see source)
- sourcesRootDir: your production JS files root dir.
- specs: one or more spec file to run. You may also use the glob syntax described here.For example to load all javascript files in subdir use subdir/*.js. Default behavior: use java Class name (replaces Test with Spec, see example).
- sources: one or more JS production file which your spec needs (included before specs, d'uh). You can use the same glob syntax as the specs option.
- generateSpecRunner: (the HTML output, useful for firefox/firebug debugging etc)
- specRunnerSubDir: a subsidiary path to the default runner root directory where generated spec runners will be placed
- envJs: load EnvJS support (defaults to true)
Currently, Jasmine Junit Runner relies on Rhino 1.7R2 (+ es5-shim) & Envjs 1.2 to interpret JS code. It also uses Jamsine 1.0.2 to read your spec files. All js libs are located in test/javascript/lib .
See the pom.xml (Maven2) - you can build the whole thing using:
mvn clean install
- Rhino 1.7R2 + es5-shim 0.0.4 (not needed if you'll be using 1.7R3)
- Envjs 1.2 + required hacks in env.utils.js
- Jasmine 1.0.2
- Java libs: commons-io and commons-lang (test libs: mockito and fest assert)
If you do not specify specs with the annotation, the runner will auto-pick the spec name using your test class. The below test will load myAwesomeSpec.js from the specs dir (jsRootDir + '/specs/').
@RunWith(JasmineTestRunner.class)
@JasmineSuite(sources = { 'jQuery.js', 'myAwesomeCode.js' } )
public class MyAwesomeTest {
}your awesome production code relies on jQuery (of course it does), so you'll have to include it.
Your spec file might look like this:
describe("my awesome code", function() {
it("will always run", function() {
expect(stuff.DoCoolThings()).toBe("awesome");
});
});It's possible to do some extra work before and after each spec run:
@RunWith(JasmineTestRunner.class)
@JasmineSuite
public class MyAwesomeTest {
@Before
public void beforeStuff(RhinoContext context) {
context.evalJS("var prefabVar = { cool: 'yeah!' };");
}
@Before
public void beforeStuffNoContext() {
System.out.println("I'm gonna blow! Or Will I?");
}
@After
public void afterStuff() {
// say cool things
}
}What's happening?
- You can define n number of PUBLIC methods annotated with
@Beforeor@After - You can, but don't have to, take the
RhinoContextobject as the only parameter. This allows you to set stuff up in JS space before running the spec.
Your awesome test (example 1) would for instance generate this html file:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Jasmine Test Runner</title>
<link rel="stylesheet" type="text/css" href="./../lib/jasmine-1.3.1/jasmine.css">
<script type="text/javascript" src="./../lib/jasmine-1.3.1/jasmine.js"></script>
<script type="text/javascript" src="./../lib/jasmine-1.3.1/jasmine-html.js"></script>
<script type='text/javascript' src='./../../../main/webapp/js/jquery.js'></script>
<script type='text/javascript' src='./../../../main/webapp/js/myawesomecode.js'></script>
<script type='text/javascript' src='./../specs/myawesomespec.js'></script>
</head>
<body>
<script type="text/javascript">
jasmine.getEnv().addReporter(new jasmine.TrivialReporter());
jasmine.getEnv().execute();
</script>
</body>
</html>You can inspect the output using firefox, or debug in your spec file using firebug.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent