LittleJS 1.28.0

Engine

Timer

Timer object tracks how long has passed since it was set

Constructor

new Timer(timeLeft, useRealTime)engineUtilities.js:25

Create a timer object set time passed in

timeLeft number optional

How much time left before the timer is elapsed in seconds (undefined = unset)

useRealTime boolean optional, default false

Should the timer keep running even when the game is paused? (useful for UI)

let a = new Timer;    // creates a timer that is not set
a.set(3);             // sets the timer to 3 seconds

let b = new Timer(1); // creates a timer with 1 second left
b.unset();            // unset the timer

Members

Methods

Members

setTime : number|undefinedengineUtilities.js:39
time : number|undefinedengineUtilities.js:37
useRealTime : booleanengineUtilities.js:34

Runs on real time, so it keeps going while the game is paused, see setUseRealTime

Methods

active() → booleanengineUtilities.js:69

Returns true if set and has not elapsed

elapsed() → booleanengineUtilities.js:73

Returns true if set and elapsed

get() → numberengineUtilities.js:77

Get how long since elapsed, returns 0 if not set (returns negative if currently active)

getGlobalTime() → numberengineUtilities.js:95

Get the current global time this timer is based on

getPercent() → numberengineUtilities.js:82

Get percentage elapsed based on time it was set to, returns 0 if not set. Zero-duration timers report 1 (already elapsed).

getSetTime() → numberengineUtilities.js:91

Get the time this timer was set to, returns 0 if not set

isSet() → booleanengineUtilities.js:65

Returns true if set

Set the timer with seconds passed in

timeLeft number optional, default 0

How much time left before the timer is elapsed in seconds

setUseRealTime(useRealTime)engineUtilities.js:54

Set if the timer should keep running even when the game is paused

useRealTime boolean optional, default true
toString() → stringengineUtilities.js:99

Returns this timer expressed as a string

Unset the timer

valueOf() → numberengineUtilities.js:103

Get how long since elapsed, returns 0 if not set (returns negative if currently active)