externalClock

A Clock tells the time. This abstraction allows Serenity/JS to have a single place in the framework responsible for telling the time, and one that can be easily mocked for internal testing.

const now: Timestamp = new Clock().now()

Learn more

• Timestamp
• Duration

Index

Constructors

• constructor

Methods

• toJSON
• setAhead
• tick
• now
• waitFor

Constructors

externalconstructor

• new Clock(checkTime?: () => Date): Clock

• Parameters

  • externalcheckTime: () => Date = ...

  Returns Clock

Methods

externaltoJSON

• toJSON(): JSONObject

• Returns JSONObject

externalsetAhead

• setAhead(duration: Duration): void

• Sets the clock ahead to force early resolution of promises returned by Clock.waitFor.

  Useful for test purposes to avoid unnecessary delays.

  ---

  Parameters

  • externalduration: Duration

  Returns void

externaltick

• tick(): Promise<void>

• Returns a Promise that resolves after one tick of the clock.

  Useful for test purposes to avoid unnecessary delays.

  ---

  Returns Promise<void>

externalnow

• now(): Timestamp

• Returns current time

  ---

  Returns Timestamp

externalwaitFor

• waitFor(duration: Duration): Promise<void>

• Returns a Promise that will be resolved after the given duration

  ---

  Parameters

  • externalduration: Duration

  Returns Promise<void>