TestCheck (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / Test functions

Message displayed in the status report of tests

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

TestCheck (Function)

In french: TestVérifie

Warning
From version 23, TestVerify is kept for backward compatibility. This function has been replaced with TestCheck.

Writes a result into the status report of a test according to the result of a boolean expression.

Remarks:

This function can only be used in the code of an automated test.
To test the result of a Boolean expression on all platforms, use dbgCheckXXX functions. For more details, see Debugging functions.

Example

// Test de validité d'adresse mail
// On suppose avoir une fonction bEmailValide qui teste la validité d'une adresse mail
// On appelle cette procédure avec des valeurs de test qui représentent des adresses valides, 
// via le paramètre sAdresseEmail
// Dans le compte-rendu de test, pour chaque adresse testée apparaîtra une ligne 
TestCheck(bEmailValide(sAdresseEmail), "Adresse invalide", "OK", ...
	"test de validité de l'adresse mail '" + sAdresse + "': ")

// Pour voir uniquement les adresses invalides dans le compte-rendu de test
TestCheck(bEmailValide(sAdresseEmail), sAdresse + ": Adresse invalide")

Syntax

<Result> = TestCheck(<Boolean expression> [, <Caption if error> [, <Caption if success> [, <Common caption>]]])

<Result>: Boolean

Result of <Boolean expression>.

<Boolean expression>: Boolean

Expression that returns a boolean (True or False).

<Caption if error>: Optional character string

Caption that will be displayed if <Boolean expression> is set to False.

<Caption if success>: Optional character string

Caption that will be displayed if <Boolean expression> is set to True.

<Common caption>: Optional character string

Caption that will be displayed in all cases.

Remarks

Message displayed in the status report of tests

If the boolean expression is set to True:
- if the sum of <Common caption>+<Caption if success> is not empty, TestCheck is equivalent to:
  TestWriteResult(twrInfo, <Common caption>+<Caption if success>)
- if the sum of <Common caption>+<Caption if success> is empty, the function has no action.
If the boolean expression is set to False:
- if the sum of <Common caption>+<Caption if error> is not empty, TestCheck is equivalent to:
  TestWriteResult(twrError, <Common caption>+<Caption if error>)
- if the sum of <Common caption>+<Caption if error> is empty, TestCheck is equivalent to:
  TestWriteResult(twrError, <Standard error message>)

Business / UI classification: Neutral code

Component: wd300testexe.dll