<p><strong>Please note: this is incomplete and work in progress!</strong></p>
<h2>Predefined assertions</h2>
<ul>
<li>equals(x, y)</li>
<li>notEquals(x, y)</li>
<li>isTrue(x)</li>
<li>isDefined(x)</li>
<li>isUndefined(x)</li>
<li>isFalse(x)</li>
<li>isNull(x)</li>
<li>raises(exception, code, context)</li>
<li>matches(pattern, string)</li>
</ul>
<h2>TestCase</h2>
<h3>constructor(title, opts)</h3>
<p>Invocation:</p>
<pre>
<code>
var case = new TestCase('Widget tests');
var case = new TestCase('Widget tests', {runStrategy: 'async'});
</code>
</pre>
<p>Use async run strategy when test cases mustn’t be run immediately<br />
after test setup, for example when during setup a document is<br />
loaded into the browser and the browser will signal when the<br />
document has finished loading through a callback.</p>
<p>Note: code inside tests will still run sequentially. In some<br />
cases, e.g. testing interfaces, this means you will do something to<br />
affect the interface and then test the effect, before the interface<br />
thread has had a chance to apply your request. Control of flow<br />
inside tests is work in progress.</p>
<p>Alias:</p>
<pre>
<code>
var spec = new Specification();
</code>
</pre>
<h3>setTests(hash)</h3>
<p>Define test cases, optionally with setup and teardown.</p>
<pre>
<code>
var case = new TestCase();
case.tests = {
setUp: function() {
this.plusFactor = 4;
},
testOperation: function() {
assert.equals(8, 2+2+this.plusFactor);
},
tearDown: function() {
// release resources if necessary
}
}
</code>
</pre>
<p>Every test is run in a context created ex-novo and accessible from<br />
the test itself via the ‘this’ identifier.</p>
<p>Aliases: setTests(), ‘stateThat’. ‘setUp’ is also aliased to<br />
‘given’. ‘stateThat’ and ‘given’ allow a more Behaviour-Driven<br />
Development style.</p>
<pre>
<code>
var spec = new Specification();
spec.stateThat = {
given: function() {
this.plusFactor = 4;
},
'Adding two and two and plus factor yields eight': function() {
assert.equals(8, 2+2+this.plusFactor);
},
tearDown: function() {
// release resources if necessary
}
}
</code>
</pre>
<h3>run()</h3>
<p>Runs tests with strategy defined at construction time.</p>
<pre>
<code>
var case = new TestCase();
case.tests = { ... };
case.run();
</code>
</pre>
<h3>setUp(fn)</h3>
<p>Alternative style for defining setup.</p>
<h3>test(desc, code)</h3>
<p>Alternative style for defining tests. Can be called multiple<br />
times.</p>
<h3>tearDown(fn)</h3>
<p>Alternative style for defining teardown.</p>
<h3>verify()</h3>
<p><span class="caps">BDD</span>-style alias for run().</p>
<pre>
<code>
var spec = new Specification();
spec.stateThat = { ... };
spec.verify();
</code>
</pre>
<h3>given(fn)</h3>
<p><span class="caps">BDD</span>-alias for setUp().</p>
<h3>states(desc, fn)</h3>
<p><span class="caps">BDD</span>-style alias for test().</p>
2008-10-05T10:16:41-07:00
63753
reference
56497
Reference
2008-10-05T10:16:41-07:00
19322