Time system

You can verify the timers of a MockTimeSystem.

The samples use the TimeSpan helpers (5.Seconds(), 100.Milliseconds()) from aweXpect.Chronology.

Timer

A MockTimeSystem creates timers as ITimerMock. You can verify how often the timer callback was executed without blocking the test thread:

MockTimeSystem timeSystem = new();
ITimerMock timer = (ITimerMock)timeSystem.Timer.New(
    _ => { }, null, TimeSpan.Zero, TimeSpan.FromMilliseconds(10));

await Expect.That(timer).Executed().AtLeast(3.Times()).Within(5.Seconds());

Executed() accepts a quantifier (AtLeast, AtMost, Exactly, Between, Never, Once; at least once by default). Without .Within(timeout), it checks ITimerMock.ExecutionCount once and does not wait. With .Within(timeout), it checks the count again in the interval of .CheckEvery(interval) (default Customize.aweXpect.Settings().DefaultCheckInterval) until the quantifier is decided or the timeout expires, so an upper bound like .Never() or .AtMost(…) waits for the full timeout:

await Expect.That(timer).Executed().AtLeast(3.Times()).Within(5.Seconds()).CheckEvery(10.Milliseconds());

A timeout of the evaluation (e.g. .WithTimeout(…)) that is not shorter than .Within(timeout) lets the last check decide; a cancellation before that leaves the expectation inconclusive.

For example, for a timer that never fires, Expect.That(timer).Executed().AtLeast(3.Times()).Within(100.Milliseconds()) fails with:

Failure message
Expected that timer
has executed at least 3 times within 0:00.100,
but it was not executed

Timer​

Timer