Yahoo! UI Library

test  3.3.0pr1

Yahoo! UI Library > test > Assert
Search:
 
Filters

static Class Assert

The Assert object provides functions to test JavaScript values against known and expected results. Whenever a comparison (assertion) fails, an error is thrown.

Properties

_asserts - private int

The number of assertions performed.

Methods

_formatMessage

protected static String _formatMessage ( customMessage , defaultMessage )
Formats a message so that it can contain the original assertion message in addition to the custom message.
Parameters:
customMessage <String> The message passed in by the developer.
defaultMessage <String> The message created by the error by default.
Returns: String
The final error message, containing either or both.

_getCount

protected static void _getCount ( )
Returns the number of assertions that have been performed.

_increment

protected static void _increment ( )
Increments the number of assertions that have been performed.

_reset

protected static void _reset ( )
Resets the number of assertions that have been performed to 0.

areEqual

static void areEqual ( expected , actual , message )
Asserts that a value is equal to another. This uses the double equals sign so type cohersion may occur.
Parameters:
expected <Object> The expected value.
actual <Object> The actual value to test.
message <String> (Optional) The message to display if the assertion fails.

areNotEqual

static void areNotEqual ( unexpected , actual , message )
Asserts that a value is not equal to another. This uses the double equals sign so type cohersion may occur.
Parameters:
unexpected <Object> The unexpected value.
actual <Object> The actual value to test.
message <String> (Optional) The message to display if the assertion fails.

areNotSame

static void areNotSame ( unexpected , actual , message )
Asserts that a value is not the same as another. This uses the triple equals sign so no type cohersion may occur.
Parameters:
unexpected <Object> The unexpected value.
actual <Object> The actual value to test.
message <String> (Optional) The message to display if the assertion fails.

areSame

static void areSame ( expected , actual , message )
Asserts that a value is the same as another. This uses the triple equals sign so no type cohersion may occur.
Parameters:
expected <Object> The expected value.
actual <Object> The actual value to test.
message <String> (Optional) The message to display if the assertion fails.

fail

static void fail ( message )
Forces an assertion error to occur.
Parameters:
message <String> (Optional) The message to display with the failure.

isArray

static void isArray ( actual , message )
Asserts that a value is an array.
Parameters:
actual <Object> The value to test.
message <String> (Optional) The message to display if the assertion fails.

isBoolean

static void isBoolean ( actual , message )
Asserts that a value is a Boolean.
Parameters:
actual <Object> The value to test.
message <String> (Optional) The message to display if the assertion fails.

isFalse

static void isFalse ( actual , message )
Asserts that a value is false. This uses the triple equals sign so no type cohersion may occur.
Parameters:
actual <Object> The actual value to test.
message <String> (Optional) The message to display if the assertion fails.

isFunction

static void isFunction ( actual , message )
Asserts that a value is a function.
Parameters:
actual <Object> The value to test.
message <String> (Optional) The message to display if the assertion fails.

isInstanceOf

static void isInstanceOf ( expected , actual , message )
Asserts that a value is an instance of a particular object. This may return incorrect results when comparing objects from one frame to constructors in another frame. For best results, don't use in a cross-frame manner.
Parameters:
expected <Function> The function that the object should be an instance of.
actual <Object> The object to test.
message <String> (Optional) The message to display if the assertion fails.

isNaN

static void isNaN ( actual , message )
Asserts that a value is not a number.
Parameters:
actual <Object> The value to test.
message <String> (Optional) The message to display if the assertion fails.

isNotNaN

static void isNotNaN ( actual , message )
Asserts that a value is not the special NaN value.
Parameters:
actual <Object> The value to test.
message <String> (Optional) The message to display if the assertion fails.

isNotNull

static void isNotNull ( actual , message )
Asserts that a value is not null. This uses the triple equals sign so no type cohersion may occur.
Parameters:
actual <Object> The actual value to test.
message <String> (Optional) The message to display if the assertion fails.

isNotUndefined

static void isNotUndefined ( actual , message )
Asserts that a value is not undefined. This uses the triple equals sign so no type cohersion may occur.
Parameters:
actual <Object> The actual value to test.
message <String> (Optional) The message to display if the assertion fails.

isNull

static void isNull ( actual , message )
Asserts that a value is null. This uses the triple equals sign so no type cohersion may occur.
Parameters:
actual <Object> The actual value to test.
message <String> (Optional) The message to display if the assertion fails.

isNumber

static void isNumber ( actual , message )
Asserts that a value is a number.
Parameters:
actual <Object> The value to test.
message <String> (Optional) The message to display if the assertion fails.

isObject

static void isObject ( actual , message )
Asserts that a value is an object.
Parameters:
actual <Object> The value to test.
message <String> (Optional) The message to display if the assertion fails.

isString

static void isString ( actual , message )
Asserts that a value is a string.
Parameters:
actual <Object> The value to test.
message <String> (Optional) The message to display if the assertion fails.

isTrue

static void isTrue ( actual , message )
Asserts that a value is true. This uses the triple equals sign so no type cohersion may occur.
Parameters:
actual <Object> The actual value to test.
message <String> (Optional) The message to display if the assertion fails.

isTypeOf

static void isTypeOf ( expectedType , actualValue , message )
Asserts that a value is of a particular type.
Parameters:
expectedType <String> The expected type of the variable.
actualValue <Object> The actual value to test.
message <String> (Optional) The message to display if the assertion fails.

isUndefined

static void isUndefined ( actual , message )
Asserts that a value is undefined. This uses the triple equals sign so no type cohersion may occur.
Parameters:
actual <Object> The actual value to test.
message <String> (Optional) The message to display if the assertion fails.

Y.assert

static void Y.assert ( condition , message )
Asserts that a given condition is true. If not, then a Y.Assert.Error object is thrown and the test fails.
Parameters:
condition <Boolean> The condition to test.
message <String> The message to display if the assertion fails.

Y.fail

static void Y.fail ( message )
Forces an assertion error to occur. Shortcut for Y.Assert.fail().
Parameters:
message <String> (Optional) The message to display with the failure.


Copyright © 2010 Yahoo! Inc. All rights reserved.