View source for Mocha (JavaScript framework)

{{Short description|JavaScript test framework running on Node.js}}
{{Other uses|Mocha (disambiguation){{!}}Mocha}}
{{multiple issues|
{{more citations needed|date=February 2022}}
{{notability|Products|date=August 2014}}
}}
{{Infobox software
| name = Mocha
| title = Mocha
| logo = [[File:Mocha logo.svg|100px]]
| screenshot = 
| caption = 
| collapsible = 
| author = 
| developer = [[OpenJS Foundation]]
| released = {{Start date|2011|11|22}}
| discontinued = 
| latest release version = {{wikidata|property|reference|edit|P348}}
| latest release date = {{start date and age|{{wikidata|qualifier|P348|P577}}}}
| latest preview version = 
| latest preview date = <!-- {{Start date and age|YYYY|MM|DD}} -->
| frequently updated = <!-- DO NOT include this parameter unless you know what it does -->
| repo = {{URL|https://github.com/mochajs/mocha}}
| programming language = [[JavaScript]]
| operating system = 
| platform = [[Node.js]]
| size = 
| language = 
| status = 
| genre = [[Test automation framework]]
| license = [[MIT license|MIT]]
| website = {{URL|https://mochajs.org/}}
}}

'''Mocha''' is a [[JavaScript]] test framework for [[Node.js]] programs, featuring browser support, asynchronous testing, test coverage reports, and use of any assertion library.<ref>{{Cite web|url=https://mochajs.org/|title=Mocha - the fun, simple, flexible JavaScript test framework|website=mochajs.org|language=en}}</ref>

== Assertion libraries ==
Mocha can be used with most JavaScript assertion libraries, including:

* should.js
* express.js
* chai
* better-assert
* unexpected

== Usage and examples ==
<syntaxhighlight lang="console">
$ npm install -g mocha
$ mkdir test
$ $EDITOR test/test.js # or open with your favorite editor
</syntaxhighlight>
<syntaxhighlight lang="javascript">
var assert = require("assert")
describe('Foo', function(){
  describe('#getBar(value)', function() {
    it('should return 100 when value is negative') // placeholder
    it('should return 0 when value is positive', function() {
      assert.equal(0, Foo.getBar(10));
    })
  })
})
</syntaxhighlight>
<syntaxhighlight lang="console">
$  mocha
.
1 test complete (1ms)
</syntaxhighlight>
<br/>
For '''asynchronous testing''', invoke the callback, and Mocha will wait for completion.

<syntaxhighlight lang="javascript">
describe('Foo', function(){
  describe('#bar()', function() {
    it('should work without error', function(done) {
      var foo = new Foo(128);
      foo.bar(done);
    })
  })
})
</syntaxhighlight>

== See also ==
{{Portal|Free and open-source software}}
* [[Jasmine (JavaScript framework)|Jasmine]]
* [[List of unit testing frameworks]]
* [[Npm (software)|npm]]
* [[QUnit]]
* [[JavaScript framework]]
* [[JavaScript library]]

==References==
{{Reflist}}

== External links ==
* {{Official website}}
* {{GitHub|mochajs/mocha}}

{{JavaScript}}

[[Category:JavaScript libraries]]
[[Category:JavaScript programming tools]]
[[Category:Software using the MIT license]]
[[Category:2011 software]]