Everipedia Logo
Everipedia is now IQ.wiki - Join the IQ Brainlist and our Discord for early access to editing on the new platform and to participate in the beta testing.
Jasmine (JavaScript testing framework)

Jasmine (JavaScript testing framework)

Jasmine is an open source testing framework for JavaScript.[4] It aims to run on any JavaScript-enabled platform, to not intrude on the application nor the IDE, and to have easy-to-read syntax. It is heavily influenced by other unit testing frameworks, such as ScrewUnit, JSSpec, JSpec, and RSpec.[5]

Jasmine
Developer(s)Pivotal Labs
Initial releaseSeptember 14, 2010 (2010-09-14)[1]
Stable release
3.4.0 / April 4, 2019 (2019-04-04)[2]
Repositoryhttps://github.com/jasmine/jasmine [18]
Written inJavaScript
Operating systemCross-platform
TypeUnit Test
LicenseMIT License[3]
Websitehttps://jasmine.github.io/ [19]

History

The developers at Pivotal Labs for Jasmine previously developed a similar unit testing framework called JsUnit before active development of Jasmine.[6]

Features

  • Supports asynchronous testing.[7]

  • Makes use of 'spies' for implementing test doubles.[7]

  • Supports testing of front-end code through a front-end extension of Jasmine called Jasmine-jQuery.[7]

Usage

Jasmine aims to be easy to read. A simple hello world test looks like the code below, where describe() describes a suite of tests and it() is an individual test specification. The name "it()" follows the idea of behavior-driven development and serves as the first word in the test name, which should be a complete sentence. Usage follows syntax similar to that of RSpec.

The code below tests this function

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

Jasmine provides a rich set of built-in matchers. In the above example, toEqual checks the equality between the value returned from the helloWorld() function and the 'Hello world!' string. This is the same as assertions used in other testing frameworks. Jasmine matchers simply return a Boolean value: true if the expectation is matched (a way to indicate that the test has passed) or false if the expectation doesn’t match.[7] A good practice is to put a single expectation in an individual it() test specification.

Other built-in matchers include toBe, toBeTruthy, toBeFalsy, toContain, toBeDefined, toBeUndefined, toBeNull, toBeNaN, toBeGreaterThan, toBeLessThan, toBeCloseTo.[8] The identity matcher toBe checks if two things are the same object. The condition matchers toBeTruthy, toBeFalsy evaluate if something is true or false and toBeDefined, toBeUndefined check if something is defined or undefined. As the name suggests toBeNull checks if something is null and toBeNaN checks if something is not a number (NaN). Precision matcher toBeCloseTo accepts two parameters and checks if a number is close to the first parameter, given a certain amount of decimal precision as indicated by the second parameter. Matcher toContain is used to verify that an element, object or sub-string is contained in an array, list or string.

The special built-in matcher toThrow is used to verify that an exception has been thrown.[7] The code below verifies that "Some exception" is thrown.

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

Jasmine test runners

Jasmine comes with an inbuilt test runner. Jasmine tests can run browser tests by including a simple SpecRunner.html[9] file or by using it as a command line test runner supported for various languages like Nodejs, Python, Ruby [20] , or (old way) by using Karma,[10] a simple JavaScript test runner tool.

Comparison between Jasmine and Mocha[11]

Mocha is another popular Javascript testing framework. The comparison between Jasmine and Mocha is given in the table below.

JasmineMocha
Jasmine comes with test doubles by using spies.Mocha does not come with a test double library, and generally uses an external library like Sinon.
Jasmine has a command line utility [21] to run tests.Mocha has a command line utility to run tests.
Jasmine has assertions built into it.Mocha does not have an assertions library and uses Chai for assertions.

Benefits

  • The aim of Jasmine is to be browser, framework, platform and language independent.[12]

  • Besides behavior-driven development, Jasmine also supports test driven development.[12]

See also

  • List of JavaScript libraries

  • List of unit testing frameworks

  • Mocha (JavaScript framework)

  • QUnit

References

[1]
Citation Linkpivotallabs.comDavis W. Frank. "Jasmine 1.0 Released". Pivotal Labs. Retrieved 11 February 2014.
Sep 23, 2019, 5:10 PM
[2]
Citation Linkgithub.com"Releases". Retrieved 30 April 2017.
Sep 23, 2019, 5:10 PM
[3]
Citation Linkgithub.com"jasmine/MIT.LICENSE". GitHub. Retrieved 25 April 2017.
Sep 23, 2019, 5:10 PM
[4]
Citation Linkjasmine.github.iohttps://jasmine.github.io/
Sep 23, 2019, 5:10 PM
[5]
Citation Linkgithub.comhttps://github.com/pivotal/jasmine/wiki/Background
Sep 23, 2019, 5:10 PM
[6]
Citation Linkgithub.comGithub JsUnit Project Page
Sep 23, 2019, 5:10 PM
[7]
Citation Linkopenlibrary.orgRagonha, Paulo (2013). Jasmine JavaScript Testing. Packt Publishing. ISBN 978-1782167211.
Sep 23, 2019, 5:10 PM
[8]
Citation Linkopenlibrary.orgHahn, Evan (2013). JavaScript Testing with Jasmine. O'Reilly Media. ISBN 978-1449356378.
Sep 23, 2019, 5:10 PM
[9]
Citation Linkgithub.com"A simple project".
Sep 23, 2019, 5:10 PM
[10]
Citation Linkwww.npmjs.com"Karma Jasmine".
Sep 23, 2019, 5:10 PM
[11]
Citation Linkmarcofranssen.nl"Jasmine vs. Mocha". Marco Franssen. Retrieved 13 February 2017.
Sep 23, 2019, 5:10 PM
[12]
Citation Linkstackshare.io"Comparison: Jasmine vs Mocha vs QUnit | StackShare". Retrieved 13 February 2017.
Sep 23, 2019, 5:10 PM
[13]
Citation Linkjasmine.github.ioJasmine website
Sep 23, 2019, 5:10 PM
[14]
Citation Linkgithub.comJasmine on GitHub
Sep 23, 2019, 5:10 PM
[15]
Citation Linkwww.npmjs.comJSSpec
Sep 23, 2019, 5:10 PM
[16]
Citation Linkjavalite.ioJSpec
Sep 23, 2019, 5:10 PM
[17]
Citation Linkcontent.pivotal.ioScrewUnit
Sep 23, 2019, 5:10 PM
[18]
Citation Linkgithub.comhttps://github.com/jasmine/jasmine
Sep 23, 2019, 5:10 PM
[19]
Citation Linkjasmine.github.iohttps://jasmine.github.io/
Sep 23, 2019, 5:10 PM
[20]
Citation Linkjasmine.github.ioNodejs, Python, Ruby
Sep 23, 2019, 5:10 PM