Class TestWaitCondition

Contains extension methods on ITestWaitCondition<T>.

Inheritance

Object

TestWaitCondition

Namespace: Responsible

Assembly: Responsible.dll

Syntax

public static class TestWaitCondition

Methods

AndThen<TFirst, TSecond>(ITestWaitCondition<TFirst>, ITestWaitCondition<TSecond>, String, String, Int32)

Constructs a wait condition, which will first wait for the first condition to be fulfilled, and only then continue waiting on the second. The result of first is discarded. Will complete with a failure, if either condition fails.

Declaration

[Pure]
public static ITestWaitCondition<TSecond> AndThen<TFirst, TSecond>(this ITestWaitCondition<TFirst> first, ITestWaitCondition<TSecond> second, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0)

Parameters

Type	Name	Description
ITestWaitCondition<TFirst>	first	First wait condition to wait on.
ITestWaitCondition<TSecond>	second	Second wait condition to wait on.
String	memberName	Caller member name provided by compiler. May be overridden for custom operators.
String	sourceFilePath	Caller file path provided by compiler. May be overridden for custom operators.
Int32	sourceLineNumber	Source line number provided by compiler. May be overridden for custom operators.

Returns

Type	Description
ITestWaitCondition<TSecond>	A wait condition which is completed with the result of second, once both conditions have been fulfilled.

Type Parameters

Name	Description
TFirst	Result type of first wait condition.
TSecond	Result type of second wait condition and the returned wait condition.

AndThen<TFirst, TSecond>(ITestWaitCondition<TFirst>, Func<TFirst, ITestWaitCondition<TSecond>>, String, String, Int32)

Constructs a wait condition, which will first wait for the first condition to be fulfilled, then construct a second condition using continuation, and continue waiting on it. Will complete with a failure, if either condition, or the continuation function fails.

Declaration

[Pure]
public static ITestWaitCondition<TSecond> AndThen<TFirst, TSecond>(this ITestWaitCondition<TFirst> first, Func<TFirst, ITestWaitCondition<TSecond>> continuation, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0)

Parameters

Type	Name	Description
ITestWaitCondition<TFirst>	first	First wait condition to wait on.
Func<TFirst, ITestWaitCondition<TSecond>>	continuation	Continuation function to build the second wait condition from the result of first.
String	memberName	Caller member name provided by compiler. May be overridden for custom operators.
String	sourceFilePath	Caller file path provided by compiler. May be overridden for custom operators.
Int32	sourceLineNumber	Source line number provided by compiler. May be overridden for custom operators.

Returns

Type	Description
ITestWaitCondition<TSecond>	A wait condition which is completed with the result of the wait condition returned by continuation, once both conditions have been fulfilled.

Type Parameters

Name	Description
TFirst	Result type of first wait condition.
TSecond	Result type of second wait condition and the returned wait condition.

BoxResult<T>(ITestWaitCondition<T>)

Converts a wait condition returning a value type into one returning the same value boxed into Object.

Declaration

[Pure]
public static ITestWaitCondition<object> BoxResult<T>(this ITestWaitCondition<T> condition)
    where T : struct

Parameters

Type	Name	Description
ITestWaitCondition<T>	condition	Wait condition to wrap.

Returns

Type	Description
ITestWaitCondition<Object>	A wait condition which behaves otherwise identically to condition, but returns its result as a boxed object.

Type Parameters

Name	Description
T	Return type of the wait condition to convert.

ExpectWithinSeconds<T>(ITestWaitCondition<T>, Double, String, String, Int32)

Constructs a test instruction, which will enforce a timeout on the provided wait condition. If the condition isn't met within the timeout, the instruction will complete with an error.

Declaration

[Pure]
public static ITestInstruction<T> ExpectWithinSeconds<T>(this ITestWaitCondition<T> condition, double timeout, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0)

Parameters

Type	Name	Description
ITestWaitCondition<T>	condition	Wait condition to wait for.
Double	timeout	Timeout for waiting for the condition, in seconds.
String	memberName	Caller member name provided by compiler. May be overridden for custom operators.
String	sourceFilePath	Caller file path provided by compiler. May be overridden for custom operators.
Int32	sourceLineNumber	Source line number provided by compiler. May be overridden for custom operators.

Returns

Type	Description
ITestInstruction<T>	A test instruction which completes with the result of the condition, or a failure if either the timeout is met, or the condition completes with a failure.

Type Parameters

Name	Description
T	Result type of the wait condition, and the returned instruction.

Select<T1, T2>(ITestWaitCondition<T1>, Func<T1, T2>, String, String, Int32)

Applies a selector to the result of a wait condition when the condition completes, transforming the result type to another type.

Declaration

[Pure]
public static ITestWaitCondition<T2> Select<T1, T2>(this ITestWaitCondition<T1> condition, Func<T1, T2> selector, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0)

Parameters

Type	Name	Description
ITestWaitCondition<T1>	condition	A wait condition to apply the selector to.
Func<T1, T2>	selector	A function to apply to the result of the wait condition.
String	memberName	Caller member name provided by compiler. May be overridden for custom operators.
String	sourceFilePath	Caller file path provided by compiler. May be overridden for custom operators.
Int32	sourceLineNumber	Source line number provided by compiler. May be overridden for custom operators.

Returns

Type	Description
ITestWaitCondition<T2>	A wait condition whose result is the result of invoking selector on the result of condition.

Type Parameters

Name	Description
T1	Return type of the initial wait condition.
T2	Return type of the selector and the returned wait condition.

ThenRespondWith<TWait, TResult>(ITestWaitCondition<TWait>, String, ITestInstruction<TResult>, String, String, Int32)

Constructs a test responder, which will wait for the provided condition, and then continue executing the provided instruction. Will complete with a failure if the wait condition or instruction completes with a failure.

Declaration

[Pure]
public static ITestResponder<TResult> ThenRespondWith<TWait, TResult>(this ITestWaitCondition<TWait> condition, string description, ITestInstruction<TResult> instruction, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0)

Parameters

Type	Name	Description
ITestWaitCondition<TWait>	condition	Condition to wait on before executing instruction.
String	description	Description of the responder which is constructed.
ITestInstruction<TResult>	instruction	Instruction to execute after condition has been met.
String	memberName	Caller member name provided by compiler. May be overridden for custom operators.
String	sourceFilePath	Caller file path provided by compiler. May be overridden for custom operators.
Int32	sourceLineNumber	Source line number provided by compiler. May be overridden for custom operators.

Returns

Type	Description
ITestResponder<TResult>	A test responder composed of condition and instruction.

Type Parameters

Name	Description
TWait	Result type of the wait condition.
TResult	Result type of the instruction and the returned responder.

ThenRespondWith<TWait, TResult>(ITestWaitCondition<TWait>, String, Func<TWait, ITestInstruction<TResult>>, String, String, Int32)

Constructs a test responder, which will wait for condition to complete, construct a test instruction using selector, and continue executing the returned instruction. Will complete with a failure if the wait condition, selector, or constructed instruction completes with a failure.

Declaration

[Pure]
public static ITestResponder<TResult> ThenRespondWith<TWait, TResult>(this ITestWaitCondition<TWait> condition, string description, Func<TWait, ITestInstruction<TResult>> selector, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0)

Parameters

Type	Name	Description
ITestWaitCondition<TWait>	condition	Condition to wait on before calling selector.
String	description	Description of the responder which is constructed.
Func<TWait, ITestInstruction<TResult>>	selector	Function to construct the instruction part of the responder, from the result of condition.
String	memberName	Caller member name provided by compiler. May be overridden for custom operators.
String	sourceFilePath	Caller file path provided by compiler. May be overridden for custom operators.
Int32	sourceLineNumber	Source line number provided by compiler. May be overridden for custom operators.

Returns

Type	Description
ITestResponder<TResult>	A test responder composed of condition and selector.

Type Parameters

Name	Description
TWait	Result type of the wait condition.
TResult	Result type of the instruction and the returned responder.

ThenRespondWithAction<TWait>(ITestWaitCondition<TWait>, String, Action<TWait>, String, String, Int32)

Constructs a test responder, which will wait for the given condition, and then continue executing a synchronous action, returning a non-null object. Will complete with a failure if the wait condition or action completes with a failure.

Declaration

[Pure]
public static ITestResponder<object> ThenRespondWithAction<TWait>(this ITestWaitCondition<TWait> condition, string description, Action<TWait> action, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0)

Parameters

Type	Name	Description
ITestWaitCondition<TWait>	condition	Condition to wait on before executing action.
String	description	Description of the responder which is constructed.
Action<TWait>	action	Synchronous action to execute with the result of condition.
String	memberName	Caller member name provided by compiler. May be overridden for custom operators.
String	sourceFilePath	Caller file path provided by compiler. May be overridden for custom operators.
Int32	sourceLineNumber	Source line number provided by compiler. May be overridden for custom operators.

Returns

Type	Description
ITestResponder<Object>	A test responder composed of condition and action.

Type Parameters

Name	Description
TWait	Result type of the wait condition.

ThenRespondWithFunc<TWait, TResult>(ITestWaitCondition<TWait>, String, Func<TWait, TResult>, String, String, Int32)

Constructs a test responder, which will wait for the provided condition, and then continue executing a synchronous function, returning its result. Will complete with a failure if the wait condition or function completes with a failure.

Declaration

[Pure]
public static ITestResponder<TResult> ThenRespondWithFunc<TWait, TResult>(this ITestWaitCondition<TWait> condition, string description, Func<TWait, TResult> selector, [CallerMemberName] string memberName = "", [CallerFilePath] string sourceFilePath = "", [CallerLineNumber] int sourceLineNumber = 0)

Parameters

Type	Name	Description
ITestWaitCondition<TWait>	condition	Condition to wait on before executing selector.
String	description	Description of the responder which is constructed.
Func<TWait, TResult>	selector	Synchronous function to execute with the result of condition. The returned value will be the result of the returned responder.
String	memberName	Caller member name provided by compiler. May be overridden for custom operators.
String	sourceFilePath	Caller file path provided by compiler. May be overridden for custom operators.
Int32	sourceLineNumber	Source line number provided by compiler. May be overridden for custom operators.

Returns

Type	Description
ITestResponder<TResult>	A test responder composed of condition and selector.

Type Parameters

Name	Description
TWait	Result type of the wait condition.
TResult	Result type of the instruction and the returned responder.