Use the ArrayAssert object, which contains assertions designed to be used specifically with JavaScript Arrays and array-like objects.
<!--
Software License Agreement (BSD License)
Copyright (c) 2009, Yahoo! Inc.
All rights reserved.
Redistribution and use of this software in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this list of conditions and the
following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
* Neither the name of Yahoo! Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission of Yahoo! Inc.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Sources of Intellectual Property Included in the YUI Library
YUI is issued by Yahoo! under the BSD license above. Below is a list of certain publicly available software that is the source of intellectual property in YUI, along with the licensing terms that pertain to thosesources of IP. This list is for informational purposes only and is not intended to represent an exhaustive list of third party contributions to the YUI.
* Douglas Crockford's JSON parsing and stringifying methods: In the JSON Utility, Douglas Crockford's JSON parsing and stringifying methods are adapted from work published at JSON.org. The adapted work is in the public domain.
* Robert Penner's animation-easing algorithms: In the Animation Utility, YUI makes use of Robert Penner's algorithms for easing.
* Geoff Stearns's SWFObject: In the Charts Control and the Uploader versions through 2.7.0, YUI makes use of Geoff Stearns's SWFObject v1.5 for Flash Player detection and embedding. More information on SWFObject can be found here (http://blog.deconcept.com/swfobject/). SWFObject is (c) 2007 Geoff Stearns and is released under the MIT License (http://www.opensource.org/licenses/mit-license.php).
* Diego Perini's IEContentLoaded technique: The Event Utility employs a technique developed by Diego Perini and licensed under GPL. YUI's use of this technique is included under our BSD license with the author's permission.
-->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<title>Array Processing</title>
<style type="text/css">
/*margin and padding on body element
can introduce errors in determining
element position and are not recommended;
we turn them off as a foundation for YUI
CSS treatments. */
body {
margin:0;
padding:0;
}
</style>
<link rel="stylesheet" type="text/css" href="yui_2.7.0b-lib/logger/assets/skins/sam/logger.css" />
<link rel="stylesheet" type="text/css" href="yui_2.7.0b-lib/fonts/fonts-min.css" />
<link rel="stylesheet" type="text/css" href="yui_2.7.0b-lib/yuitest/assets/skins/sam/yuitest.css" />
<script type="text/javascript" src="yui_2.7.0b-lib/yahoo-dom-event/yahoo-dom-event.js"></script>
<script type="text/javascript" src="yui_2.7.0b-lib/logger/logger-min.js"></script>
<script type="text/javascript" src="yui_2.7.0b-lib/yuitest/yuitest-min.js"></script>
<!--there is no custom header content for this example-->
</head>
<body class=" yui-skin-sam">
<h1>Array Processing</h1>
<div class="exampleIntro">
<p>This example shows how to use the <a href="/yui/yuitest/#arrayassert"><code>ArrayAssert</code></a> object, which
contains assertions designed to be used specifically with JavaScript Arrays and array-like objects.</p>
</div>
<!--BEGIN SOURCE CODE FOR EXAMPLE -->
<div id="testLogger"></div>
<script type="text/javascript">
YAHOO.namespace("example.yuitest");
YAHOO.example.yuitest.ArrayTestCase = new YAHOO.tool.TestCase({
//the name of the test case - if not provided, one is automatically generated
name: "Array Tests",
//-------------------------------------------------------------------------
// Setup and teardown
//-------------------------------------------------------------------------
/*
* The setUp() method is used to setup data that necessary for a test to
* run. This method is called immediately before each test method is run,
* so it is run as many times as there are test methods.
*/
setUp : function () {
this.data = new Array (0,1,2,3,4,5);
},
/*
* The tearDown() method is used to clean up the initialization that was done
* in the setUp() method. Ideally, it should free up all memory allocated in
* setUp(), anticipating any possible changes to the data. This method is called
* immediately after each test method is run.
*/
tearDown : function () {
delete this.data;
},
//-------------------------------------------------------------------------
// Basic tests - all method names must begin with "test"
//-------------------------------------------------------------------------
/*
* Test the push() method.
*/
testPush : function() {
//shortcut variables
var ArrayAssert = YAHOO.util.ArrayAssert;
//do whatever data manipulation is necessary
this.data.push(6);
//array-specific assertions
ArrayAssert.isNotEmpty(this.data, "Array should not be empty.");
ArrayAssert.contains(6, this.data, "Array should contain 6.");
ArrayAssert.indexOf(6, this.data, 6, "The value in position 6 should be 6.");
//check that all the values are there
ArrayAssert.itemsAreEqual([0,1,2,3,4,5,6], this.data, "Arrays should be equal.");
},
/*
* Test the pop() method.
*/
testPop : function() {
//shortcut variables
var Assert = YAHOO.util.Assert;
var ArrayAssert = YAHOO.util.ArrayAssert;
//do whatever data manipulation is necessary
var value = this.data.pop();
//array shouldn't be empty
ArrayAssert.isNotEmpty(this.data, "Array should not be empty.");
//basic equality assertion - expected value, actual value, optional error message
Assert.areEqual(5, this.data.length, "Array should have 5 items.");
Assert.areEqual(5, value, "Value should be 5.");
ArrayAssert.itemsAreSame([0,1,2,3,4], this.data, "Arrays should be equal.");
},
/*
* Test the reverse() method.
*/
testReverse : function() {
//shortcut variables
var ArrayAssert = YAHOO.util.ArrayAssert;
//do whatever data manipulation is necessary
this.data = this.data.reverse();
ArrayAssert.itemsAreEqual([5,4,3,2,1,0], this.data, "Arrays should be equal.");
},
/*
* Test the shift() method.
*/
testShift : function() {
//shortcut variables
var Assert = YAHOO.util.Assert;
var ArrayAssert = YAHOO.util.ArrayAssert;
//do whatever data manipulation is necessary
var value = this.data.shift();
//array shouldn't be empty
ArrayAssert.isNotEmpty(this.data, "Array should not be empty.");
//basic equality assertion - expected value, actual value, optional error message
Assert.areEqual(5, this.data.length, "Array should have 6 items.");
Assert.areEqual(0, value, "Value should be 0.");
ArrayAssert.itemsAreEqual([1,2,3,4,5], this.data, "Arrays should be equal.");
},
/*
* Test the splice() method.
*/
testSplice : function() {
//shortcut variables
var Assert = YAHOO.util.Assert;
var ArrayAssert = YAHOO.util.ArrayAssert;
//do whatever data manipulation is necessary
var removed = this.data.splice(1, 2, 99, 100);
//basic equality assertion - expected value, actual value, optional error message
Assert.areEqual(6, this.data.length, "Array should have 6 items.");
//the new items should be there
ArrayAssert.indexOf(99, this.data, 1, "Value at index 1 should be 99.");
ArrayAssert.indexOf(100, this.data, 2, "Value at index 2 should be 100.");
ArrayAssert.itemsAreEqual([0,99,100,3,4,5], this.data, "Arrays should be equal.");
ArrayAssert.itemsAreEqual([1,2], removed, "Removed values should be an array containing 1 and 2.");
},
/*
* Test the unshift() method.
*/
testUnshift : function() {
//shortcut variables
var Assert = YAHOO.util.Assert;
var ArrayAssert = YAHOO.util.ArrayAssert;
//do whatever data manipulation is necessary
this.data.unshift(-1);
//basic equality assertion - expected value, actual value, optional error message
Assert.areEqual(7, this.data.length, "Array should have 7 items.");
//the new item should be there
ArrayAssert.indexOf(-1, this.data, 0, "First item should be -1.");
ArrayAssert.itemsAreEqual([-1,0,1,2,3,4,5], this.data, "Arrays should be equal.");
}
});
YAHOO.util.Event.onDOMReady(function (){
//create the logger
var logger = new YAHOO.tool.TestLogger("testLogger");
YAHOO.tool.TestRunner.add(YAHOO.example.yuitest.ArrayTestCase);
//run the tests
YAHOO.tool.TestRunner.run();
});
</script>
<!--END SOURCE CODE FOR EXAMPLE -->
</body>
</html>
<!-- presentbright.corp.yahoo.com uncompressed/chunked Thu Feb 19 10:53:20 PST 2009 -->
yui_2.7.0b.zip( 4,431 k)Related examples in the same category