jasmine/doc/symbols/jasmine.html

1346 lines
28 KiB
HTML
Raw Normal View History

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<meta name="generator" content="JsDoc Toolkit" />
<title>JsDoc Reference - jasmine</title>
<style type="text/css">
/* default.css */
body
{
font: 12px "Lucida Grande", Tahoma, Arial, Helvetica, sans-serif;
width: 800px;
}
.header
{
clear: both;
background-color: #ccc;
padding: 8px;
}
h1
{
font-size: 150%;
font-weight: bold;
padding: 0;
margin: 1em 0 0 .3em;
}
hr
{
border: none 0;
border-top: 1px solid #7F8FB1;
height: 1px;
}
pre.code
{
display: block;
padding: 8px;
border: 1px dashed #ccc;
}
#index
{
margin-top: 24px;
float: left;
width: 160px;
position: absolute;
left: 8px;
background-color: #F3F3F3;
padding: 8px;
}
#content
{
margin-left: 190px;
width: 600px;
}
.classList
{
list-style-type: none;
padding: 0;
margin: 0 0 0 8px;
font-family: arial, sans-serif;
font-size: 1em;
overflow: auto;
}
.classList li
{
padding: 0;
margin: 0 0 8px 0;
}
.summaryTable { width: 100%; }
h1.classTitle
{
font-size:170%;
line-height:130%;
}
h2 { font-size: 110%; }
caption, div.sectionTitle
{
background-color: #7F8FB1;
color: #fff;
font-size:130%;
text-align: left;
padding: 2px 6px 2px 6px;
border: 1px #7F8FB1 solid;
}
div.sectionTitle { margin-bottom: 8px; }
.summaryTable thead { display: none; }
.summaryTable td
{
vertical-align: top;
padding: 4px;
border-bottom: 1px #7F8FB1 solid;
border-right: 1px #7F8FB1 solid;
}
/*col#summaryAttributes {}*/
.summaryTable td.attributes
{
border-left: 1px #7F8FB1 solid;
width: 140px;
text-align: right;
}
td.attributes, .fixedFont
{
line-height: 15px;
color: #002EBE;
font-family: "Courier New",Courier,monospace;
font-size: 13px;
}
.summaryTable td.nameDescription
{
text-align: left;
font-size: 13px;
line-height: 15px;
}
.summaryTable td.nameDescription, .description
{
line-height: 15px;
padding: 4px;
padding-left: 4px;
}
.summaryTable { margin-bottom: 8px; }
ul.inheritsList
{
list-style: square;
margin-left: 20px;
padding-left: 0;
}
.detailList {
margin-left: 20px;
line-height: 15px;
}
.detailList dt { margin-left: 20px; }
.detailList .heading
{
font-weight: bold;
padding-bottom: 6px;
margin-left: 0;
}
.light, td.attributes, .light a:link, .light a:visited
{
color: #777;
font-style: italic;
}
.fineprint
{
text-align: right;
font-size: 10px;
}
</style>
</head>
<body>
<!-- ============================== header ================================= -->
<!-- begin static/header.html -->
<div id="header">
</div>
<!-- end static/header.html -->
<!-- ============================== classes index ============================ -->
<div id="index">
<!-- begin publish.classesIndex -->
<div align="center"><a href="../index.html">Class Index</a>
| <a href="../files.html">File Index</a></div>
<hr />
<h2>Classes</h2>
<ul class="classList">
<li><i><a href="../symbols/_global_.html">_global_</a></i></li>
<li><a href="../symbols/jasmine.html">jasmine</a></li>
<li><a href="../symbols/jasmine.Block.html">jasmine.Block</a></li>
<li><a href="../symbols/jasmine.Clock.html">jasmine.Clock</a></li>
<li><a href="../symbols/jasmine.Env.html">jasmine.Env</a></li>
<li><a href="../symbols/jasmine.JsApiReporter.html">jasmine.JsApiReporter</a></li>
2009-10-27 23:49:23 +00:00
<li><a href="../symbols/jasmine.Matchers.html">jasmine.Matchers</a></li>
<li><a href="../symbols/jasmine.MultiReporter.html">jasmine.MultiReporter</a></li>
<li><a href="../symbols/jasmine.NestedResults.html">jasmine.NestedResults</a></li>
<li><a href="../symbols/jasmine.Reporter.html">jasmine.Reporter</a></li>
<li><a href="../symbols/jasmine.Runner.html">jasmine.Runner</a></li>
<li><a href="../symbols/jasmine.Spec.html">jasmine.Spec</a></li>
<li><a href="../symbols/jasmine.Spy.html">jasmine.Spy</a></li>
<li><a href="../symbols/jasmine.Suite.html">jasmine.Suite</a></li>
<li><a href="../symbols/jasmine.util.html">jasmine.util</a></li>
</ul>
<hr />
<!-- end publish.classesIndex -->
</div>
<div id="content">
<!-- ============================== class title ============================ -->
<h1 class="classTitle">
Namespace jasmine
</h1>
<!-- ============================== class summary ========================== -->
<p class="description">
<br /><i>Defined in: </i> <a href="../symbols/src/src_base.js.html">base.js</a>.
</p>
<!-- ============================== constructor summary ==================== -->
<table class="summaryTable" cellspacing="0" summary="A summary of the constructor documented in the class jasmine.">
<caption>Namespace Summary</caption>
<thead>
<tr>
<th scope="col">Constructor Attributes</th>
<th scope="col">Constructor Name and Description</th>
</tr>
</thead>
<tbody>
<tr>
<td class="attributes">&nbsp;</td>
<td class="nameDescription" >
<div class="fixedFont">
<b><a href="../symbols/jasmine.html">jasmine</a></b>
</div>
<div class="description">Top level namespace for Jasmine, a lightweight JavaScript BDD/spec/testing framework.</div>
</td>
</tr>
</tbody>
</table>
<!-- ============================== properties summary ===================== -->
<table class="summaryTable" cellspacing="0" summary="A summary of the fields documented in the class jasmine.">
<caption>Field Summary</caption>
<thead>
<tr>
<th scope="col">Field Attributes</th>
<th scope="col">Field Name and Description</th>
</tr>
</thead>
<tbody>
2009-10-30 00:03:24 +00:00
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">
jasmine.<b><a href="../symbols/jasmine.html#.DEFAULT_UPDATE_INTERVAL">DEFAULT_UPDATE_INTERVAL</a></b>
2009-10-30 00:03:24 +00:00
</div>
<div class="description">Default interval for event loop yields.</div>
2009-10-30 00:03:24 +00:00
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">
jasmine.<b><a href="../symbols/jasmine.html#.details">details</a></b>
</div>
<div class="description"></div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">
jasmine.<b><a href="../symbols/jasmine.html#.Reporters">Reporters</a></b>
</div>
<div class="description">JasmineReporters.reporter
Base object that will get called whenever a Spec, Suite, or Runner is done.</div>
</td>
</tr>
</tbody>
</table>
<!-- ============================== methods summary ======================== -->
<table class="summaryTable" cellspacing="0" summary="A summary of the methods documented in the class jasmine.">
<caption>Method Summary</caption>
<thead>
<tr>
<th scope="col">Method Attributes</th>
<th scope="col">Method Name and Description</th>
</tr>
</thead>
<tbody>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.any">any</a></b>(clazz)
</div>
<div class="description">Returns a matchable 'generic' object of the class type.</div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.createSpy">createSpy</a></b>(name)
</div>
<div class="description"></div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.createSpyObj">createSpyObj</a></b>(baseName, methodNames)
</div>
<div class="description">Creates a more complicated spy: an Object that has every property a function that is a spy.</div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.ExpectationResult">ExpectationResult</a></b>(params)
</div>
<div class="description"></div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.FakeTimer">FakeTimer</a></b>()
</div>
<div class="description"></div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.getEnv">getEnv</a></b>()
</div>
<div class="description">Getter for the Jasmine environment.</div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.include">include</a></b>(url, opt_global)
</div>
2009-10-27 20:33:22 +00:00
<div class="description">Adds suite files to an HTML document so that they are executed, thus adding them to the current
Jasmine environment.</div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.isDomNode">isDomNode</a></b>(obj)
</div>
<div class="description">Returns true if the object is a DOM Node.</div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.isSpy">isSpy</a></b>(putativeSpy)
</div>
<div class="description">Determines whether an object is a spy.</div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.log">log</a></b>(message)
</div>
<div class="description"></div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.MessageResult">MessageResult</a></b>(text)
</div>
<div class="description"></div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.pp">pp</a></b>(value)
</div>
<div class="description">Pretty printer for expecations.</div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.PrettyPrinter">PrettyPrinter</a></b>()
</div>
<div class="description">Base class for pretty printing for expectation results.</div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.Queue">Queue</a></b>(env)
</div>
<div class="description"></div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.StringPrettyPrinter">StringPrettyPrinter</a></b>()
</div>
<div class="description"></div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.TrivialReporter">TrivialReporter</a></b>(doc)
</div>
<div class="description"></div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.WaitsBlock">WaitsBlock</a></b>(env, timeout, spec)
</div>
<div class="description"></div>
</td>
</tr>
<tr>
<td class="attributes">&lt;static&gt; &nbsp;</td>
<td class="nameDescription">
<div class="fixedFont">jasmine.<b><a href="../symbols/jasmine.html#.WaitsForBlock">WaitsForBlock</a></b>(env, timeout, latchFunction, message, spec)
</div>
<div class="description"></div>
</td>
</tr>
</tbody>
</table>
<!-- ============================== events summary ======================== -->
<!-- ============================== constructor details ==================== -->
<div class="details"><a name="constructor"> </a>
<div class="sectionTitle">
Namespace Detail
</div>
<div class="fixedFont">
<b>jasmine</b>
</div>
<div class="description">
Top level namespace for Jasmine, a lightweight JavaScript BDD/spec/testing framework.
</div>
</div>
<!-- ============================== field details ========================== -->
<div class="sectionTitle">
Field Detail
</div>
<a name=".DEFAULT_UPDATE_INTERVAL"> </a>
2009-10-30 00:03:24 +00:00
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>DEFAULT_UPDATE_INTERVAL</b>
2009-10-30 00:03:24 +00:00
</div>
<div class="description">
Default interval for event loop yields. Small values here may result in slow test running. Zero means no updates until all tests have completed.
2009-10-30 00:03:24 +00:00
</div>
<hr />
<a name=".details"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>details</b>
</div>
<div class="description">
</div>
<hr />
<a name=".Reporters"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>Reporters</b>
</div>
<div class="description">
JasmineReporters.reporter
Base object that will get called whenever a Spec, Suite, or Runner is done. It is up to
descendants of this object to do something with the results (see json_reporter.js)
<br />
<i>Defined in: </i> <a href="../symbols/src/src_Reporters.js.html">Reporters.js</a>.
</div>
<!-- ============================== method details ========================= -->
<div class="sectionTitle">
Method Detail
</div>
<a name=".any"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>any</b>(clazz)
</div>
<div class="description">
Returns a matchable 'generic' object of the class type. For use in expecations of type when values don't matter.
</div>
2009-10-27 20:33:22 +00:00
<pre class="code">// don't care about which function is passed in, as long as it's a function
expect(mySpy).wasCalledWith(jasmine.any(Function));</pre>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{Class}</span> <b>clazz</b>
</dt>
<dd></dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dd>matchable object of the type clazz</dd>
</dl>
<hr />
<a name=".createSpy"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>createSpy</b>(name)
</div>
<div class="description">
</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<b>name</b>
</dt>
<dd></dd>
</dl>
<hr />
<a name=".createSpyObj"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>createSpyObj</b>(baseName, methodNames)
</div>
<div class="description">
2009-10-27 20:33:22 +00:00
Creates a more complicated spy: an Object that has every property a function that is a spy. Used for stubbing something
large in one call.
</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{String}</span> <b>baseName</b>
</dt>
<dd>name of spy class</dd>
<dt>
<span class="light fixedFont">{Array}</span> <b>methodNames</b>
</dt>
<dd>array of names of methods to make spies</dd>
</dl>
<hr />
<a name=".ExpectationResult"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>ExpectationResult</b>(params)
</div>
<div class="description">
</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<b>params</b>
</dt>
<dd></dd>
</dl>
<hr />
<a name=".FakeTimer"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>FakeTimer</b>()
</div>
<div class="description">
<br />
<i>Defined in: </i> <a href="../symbols/src/src_mock-timeout.js.html">mock-timeout.js</a>.
</div>
<hr />
<a name=".getEnv"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>getEnv</b>()
</div>
<div class="description">
Getter for the Jasmine environment. Ensures one gets created
</div>
<hr />
<a name=".include"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>include</b>(url, opt_global)
</div>
<div class="description">
2009-10-27 20:33:22 +00:00
Adds suite files to an HTML document so that they are executed, thus adding them to the current
Jasmine environment.
</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{String}</span> <b>url</b>
</dt>
<dd>path to the file to include</dd>
<dt>
<span class="light fixedFont">{Boolean}</span> <b>opt_global</b>
</dt>
<dd></dd>
</dl>
<hr />
<a name=".isDomNode"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">{Boolean}</span>
<span class="light">jasmine.</span><b>isDomNode</b>(obj)
</div>
<div class="description">
Returns true if the object is a DOM Node.
</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{Object}</span> <b>obj</b>
</dt>
<dd>object to check</dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dd><span class="light fixedFont">{Boolean}</span> </dd>
</dl>
<hr />
<a name=".isSpy"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">{Boolean}</span>
<span class="light">jasmine.</span><b>isSpy</b>(putativeSpy)
</div>
<div class="description">
Determines whether an object is a spy.
</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{<a href="../symbols/jasmine.Spy.html">jasmine.Spy</a>|Object}</span> <b>putativeSpy</b>
</dt>
<dd></dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dd><span class="light fixedFont">{Boolean}</span> </dd>
</dl>
<hr />
<a name=".log"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>log</b>(message)
</div>
<div class="description">
</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<b>message</b>
</dt>
<dd></dd>
</dl>
<hr />
<a name=".MessageResult"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>MessageResult</b>(text)
</div>
<div class="description">
</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<b>text</b>
</dt>
<dd></dd>
</dl>
<hr />
<a name=".pp"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">{String}</span>
<span class="light">jasmine.</span><b>pp</b>(value)
</div>
<div class="description">
Pretty printer for expecations. Takes any object and turns it into a human-readable string.
</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<b>value</b>
</dt>
<dd>{Object} an object to be outputted</dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dd><span class="light fixedFont">{String}</span> </dd>
</dl>
<hr />
<a name=".PrettyPrinter"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>PrettyPrinter</b>()
</div>
<div class="description">
Base class for pretty printing for expectation results.
<br />
<i>Defined in: </i> <a href="../symbols/src/src_PrettyPrinter.js.html">PrettyPrinter.js</a>.
</div>
<hr />
<a name=".Queue"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>Queue</b>(env)
</div>
<div class="description">
<br />
<i>Defined in: </i> <a href="../symbols/src/src_Queue.js.html">Queue.js</a>.
</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<b>env</b>
</dt>
<dd></dd>
</dl>
<hr />
<a name=".StringPrettyPrinter"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>StringPrettyPrinter</b>()
</div>
<div class="description">
<br />
<i>Defined in: </i> <a href="../symbols/src/src_PrettyPrinter.js.html">PrettyPrinter.js</a>.
</div>
<hr />
<a name=".TrivialReporter"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>TrivialReporter</b>(doc)
</div>
<div class="description">
<br />
<i>Defined in: </i> <a href="../symbols/src/lib_TrivialReporter.js.html">TrivialReporter.js</a>.
</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<b>doc</b>
</dt>
<dd></dd>
</dl>
<hr />
<a name=".WaitsBlock"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>WaitsBlock</b>(env, timeout, spec)
</div>
<div class="description">
<br />
<i>Defined in: </i> <a href="../symbols/src/src_WaitsBlock.js.html">WaitsBlock.js</a>.
</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<b>env</b>
</dt>
<dd></dd>
<dt>
<b>timeout</b>
</dt>
<dd></dd>
<dt>
<b>spec</b>
</dt>
<dd></dd>
</dl>
<hr />
<a name=".WaitsForBlock"> </a>
<div class="fixedFont">&lt;static&gt;
<span class="light">jasmine.</span><b>WaitsForBlock</b>(env, timeout, latchFunction, message, spec)
</div>
<div class="description">
<br />
<i>Defined in: </i> <a href="../symbols/src/src_WaitsForBlock.js.html">WaitsForBlock.js</a>.
</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<b>env</b>
</dt>
<dd></dd>
<dt>
<b>timeout</b>
</dt>
<dd></dd>
<dt>
<b>latchFunction</b>
</dt>
<dd></dd>
<dt>
<b>message</b>
</dt>
<dd></dd>
<dt>
<b>spec</b>
</dt>
<dd></dd>
</dl>
<!-- ============================== event details ========================= -->
<hr />
</div>
<!-- ============================== footer ================================= -->
<div class="fineprint" style="clear:both">
Documentation generated by <a href="http://www.jsdoctoolkit.org/" target="_blank">JsDoc Toolkit</a> 2.1.0 on Sat Jan 23 2010 13:48:21 GMT-0800 (PST)
</div>
</body>
</html>