View source for Jasmine (JavaScript testing framework)

'''Jasmine''' is an open source [[unit testing]] framework for testing [[JavaScript]] code.

It uses the [[behavior-driven development]] model.

== Description ==

It aims to run on any JavaScript-enabled platform, to not intrude on the [[Application software|application]] nor the [[Integrated development environment|IDE]], and to have easy-to-read syntax.

Jasmine has a number of other features, such as custom matchers, spies, and support for asynchronous specifications.

== Installing Jasmine standalone on local box ==

Download the standalone distribution for your desired release from the [https://github.com/jasmine/jasmine/releases releases page]

Create a Jasmine directory in your project - <code>mkdir my-project/jasmine</code>

Move the dist to your project directory - 

<code>mv jasmine/dist/jasmine-standalone-2.0.0.zip my-project/jasmine</code>

Change directory - <code>cd my-project/jasmine</code>

Unzip the dist - <code>unzip jasmine-standalone-2.0.0.zip</code>

Add the following to your HTML file:

<pre>
<link rel="shortcut icon" type="image/png" href="jasmine/lib/jasmine-2.0.0/jasmine_favicon.png">
<link rel="stylesheet" type="text/css" href="jasmine/lib/jasmine-2.0.0/jasmine.css">

<script type="text/javascript" src="jasmine/lib/jasmine-2.0.0/jasmine.js"></script>
<script type="text/javascript" src="jasmine/lib/jasmine-2.0.0/jasmine-html.js"></script>
<script type="text/javascript" src="jasmine/lib/jasmine-2.0.0/boot.js"></script>
</pre>

== Examples ==

A simple hello world test looks like the code below, where <code>describe()</code> describes a suite of tests and <code>it()</code> is an individual test specification.

The name "<code>it()</code>" follows the idea of [[behavior-driven development]] and serves as the first word in the test name, which should be a complete sentence. 

The code below tests this function:

<pre>
function helloWorld() {
  return 'Hello world!';
}
</pre>

and verifies that its output is indeed the text "Hello world!".

<pre>
describe('Hello world', function() {
  it('says hello', function() {
    expect(helloWorld()).toEqual('Hello world!');
  });
});
</pre>

== Influences ==

It is heavily influenced by other unit testing frameworks, such as ScrewUnit, JSSpec, JSpec, and RSpec.

== See also ==

* [[Behavior-driven development]]
* [[Unit testing]]

== External links ==

* [http://jasmine.github.io/ Official website]
* [http://jasmine.github.io/2.0/introduction.html Introduction] @ jasmine.github.io
* [https://en.wikipedia.org/wiki/Jasmine_(JavaScript_testing_framework) Jasmine (JavaScript testing framework)] @ Wikipedia
* [http://www.htmlgoodies.com/beyond/javascript/testing-javascript-using-the-jasmine-framework.html Testing JavaScript Using the Jasmine Framework] by Rob Gravelle
* [https://code.tutsplus.com/tutorials/testing-your-javascript-with-jasmine--net-21229 Testing Your JavaScript With Jasmine] by Andrew Burgess
* [https://evanhahn.com/how-do-i-jasmine/ How do I Jasmine: a tutorial] by Evan Hahn
* [https://inviqa.com/blog/testing-javascript-get-started-jasmine-0 Testing Javascript: get started with Jasmine] by Katie Fenn
* [http://blog.adamcameron.me/2014/12/javascript-jasmine-for-unit-testing.html JavaScript: Jasmine for unit testing] by Adam Cameron
* [http://www.slideshare.net/lporras161/jasmine-bdd-for-javascript Jasmine BDD for Javascript] by Luis Alfredo Porras Páez
* [http://blog.carbonfive.com/2011/07/06/pragmatic-javascript-testing-with-jasmine/ Pragmatic JavaScript Testing with Jasmine] by Jared Carroll
* [https://www.rainforestqa.com/blog/2014-07-14-test-your-javascript-with-jasmine-the-basics-part-1/ Test your JavaScript with Jasmine part 1] by Jean Philippe Boily
* [http://howtodoinjava.com/scripting/javascript/jasmine-javascript-unit-testing-tutorial/ Jasmine – JavaScript Unit Testing Tutorial with Examples] by Lokesh Gupta
* [https://kroltech.com/2013/11/20/javascript-tdd-with-jasmine-and-karma/ JavaScript TDD with Jasmine and Karma] by Krol Tech
* [http://www.developer.com/lang/jscript/testing-javascript-code-with-jasmine.html Testing JavaScript Code with Jasmine] Jason Gilmore
* [https://vimeo.com/71326996 JavaScript Testing with Jasmine] by Codeship
* [http://blog.jphpsf.com/2012/08/30/drying-up-your-javascript-jasmine-tests DRYing Up Your JavaScript Jasmine Tests With the Data Provider Pattern] by JP
* [https://www.joezimjs.com/javascript/javascript-unit-testing-with-jasmine-part-1/ JavaScript Unit Testing With Jasmine: Part 1] by Joe Zim+
* [http://ivanjovanovic.com/2011/07/22/introduction-to-javascript-bdd-testing-with-jasmine-library/ Introduction to JavaScript BDD Testing With Jasmine Library] by Ivan Jovanovic
* [http://www.codeproject.com/Articles/1118021/Jasmine-Testing-JavaScript Jasmine - Testing JavaScript] by Sharon Sudhan
* [http://geniuscarrier.com/jasmine-javascript-testing/ Jasmine - JavaScript Testing] by Yang Zhao
* [https://semaphoreci.com/community/tutorials/getting-started-with-node-js-and-jasmine Getting Started with Node.js and Jasmine] by Igor Šarčević

=== General principles of testing ===

* [http://www.adequatelygood.com/Writing-Testable-JavaScript.html Writing Testable JavaScript] by Ben Cherry

=== Online tools ===

* [http://tryjasmine.com/ Try Jasmine]]

=== YouTube videos ===

* [https://www.youtube.com/watch?v=eVpXkyN0zOE Unit Testing in JavaScript via Jasmine] by Jesse Warden
* [https://www.youtube.com/watch?v=nH1Amt_JHLg Jasmine: BDD Style JavaScript Testing Hello World] by Chris McNabb



[[Category:JavaScript]]
[[Category:Software engineering]]
[[Category:Software testing]]