|
Sep
06
|
|
This post represents an exhaustive list of supported value equatable object types. Relevant implementation details and code samples are available for each.
- Primitive types: int, uint, Number, Boolean, and String
- Coerced types: Date, XML, XMLList, Namespace, and QName
- Complex types: Array, ByteArray, and IList
Primitive types:
Numerics
Assert.areEqual( 123.456, 123.456 );
Assert.areNotEqual( 123, 123.456 );
// Note: The following will pass in FUnit but fail in FlexUnit.
// The condition (NaN == NaN) will actually fail in
// ActionScript so special handling is required.
Assert.areEqual( NaN, NaN ); Boolean
Assert.areEqual( true, true );
Assert.areNotEqual( true, false );
// Although 'isTrue' or 'isFalse' is more appropriate here.
Assert.isTrue( true ); String
Assert.areEqual( "hello world!", "hello world!" );
Assert.areNotEqual( "hello world!", "goodbye world!" );
// The StringAssert class is better suited for more
// advanced string assertions.
StringAssert.areEqualIgnoringCase( "hello!", "HELLO!" );
StringAssert.isEmpty( "" );
StringAssert.contains( "world", "hello world!" );
StringAssert.startsWith( "hello", "hello world!" );
StringAssert.endsWith( "!", "hello world!" );
// and so on ... Coerced types:
Important Note: In order to maintain simplicity in expected behavior, value coercion is limited to global top-level classes only. A ‘quick-reference’ should not be necessary while writing equality tests. The only top-level classes not currently handled are Error and RegExp. This is largely due to the fact that they are immutable objects (cannot be changed after they are created). Pending further discussions and/or feedback, value coercion for these types will likely be added as well.
Date
Assert.areEqual( new Date(123456), new Date(123456) );
Assert.areNotEqual( new Date(123456), new Date(654321) );
// Note: Unlike the .NET environment ActionScript does not
// treat dates as a value type. Therefore, FUnit will
// coerce the Date class to evaluate equality.
// For reference equality use 'Assert.areSame()'.
Assert.areNotSame( new Date(123456), new Date(123456) ); XML / XMLList
var xml1:XML = <value>Hello World</value>;
var xml2:XML = <value>Hello World</value>;
Assert.areEqual( xml1, xml2 );
// Similar to Date class value coercion, FUnit can distinguish
// value equality from reference equality.
Assert.areNotSame( xml1, xml2 ); Namespace / QName
var ns1:Namespace =
new Namespace( "funit", "http://www.funit.org/2009/" );
var ns2:Namespace =
new Namespace( "funit", "http://www.funit.org/2009/" );
Assert.areEqual( ns1, ns2 );
Assert.areNotSame( ns1, ns2 );
var qname1:QName =
new QName ( "http://www.funit.org/2009/", "funit" );
var qname2:QName =
new QName ( "http://www.funit.org/2009/", "funit" );
Assert.areEqual( qname1, qname2 );
Assert.areNotSame( qname1, qname2 );Complex types:
Array
Assert.areEqual( ["x", "y", "z"], ["x", "y", "z"] );
Assert.areNotEqual( ["x", "y", "z"], ["x", "y", "a"] );
// Associative Arrays are also handled.
var array1:Array = new Array();
array1["firstName"] = "John";
array1["middleName"] = "Adam";
array1["lastName"] = "Doe";
var array2:Array = new Array();
array2["firstName"] = "John";
array2["middleName"] = "Adam";
array2["lastName"] = "Doe";
Assert.areEqual( array1, array2 );
// Complex recursive arrays are also handled by internally
// checking for re-entrant behaviors and preventing stack
// overflow.
var recursive1:Array = new Array( null, ["x", "y", "z"], [] );
recursive1[0] = recursive1;
var recursive2:Array = new Array( null, ["x", "y", "z"], [] );
recursive2[0] = recursive2;
// Note: No stack overflow will occur here, but more variations
// and complex samples are needed to ensure all potential
// loopholes are handled.
Assert.areEqual( recursive1, recursive2 ); ByteArray
var array1:ByteArray = new ByteArray();
array1.writeDouble( Math.PI );
array1.writeUTF( "Hello World" );
array1.writeObject( ["x", "y", "z"] );
var array2:ByteArray = new ByteArray();
array2.writeDouble( Math.PI );
array2.writeUTF( "Hello World" );
array2.writeObject( ["x", "y", "z"] );
Assert.areEqual( array1, array2 );
Assert.areNotSame( array1, array2 ); IList
var set1:ArrayCollection =
new ArrayCollection( ["x", "y", "z"] );
var set2:ArrayCollection =
new ArrayCollection( ["x", "y", "z"] );
Assert.areEqual( set1, set2 );
Assert.areNotSame( set1, set2 );
|
|
|
