A newer version of this documentation is available.

View Latest

Function: Simple Timer


    Goal: Create a Simple Timer that triggers once per mutation.

    • This function simpleTimer merely demonstrates a basic Evening Timer.

    • Requires a metadata bucket and a source bucket.

    • Will operate on any mutation where the KEY or meta.id starts with "simpletimer:".

    • The result of processing the mutation is a Timer that will be executed approximately 30 seconds in the future.

    • For more details on Timers refer to Timers.

    • For an example of a recurring Timer refer to: Recurring Timer.

    • simpleTimer

    • Input Data/Mutation

    • Output Data/Logged

    function TimerCallback(context) {
        log('From TimerCallback: timer fired with context', context);
        // do any sort of recurring work here, just update a date_stamp in a doc
    function OnUpdate(doc, meta) {
        // You would typically filter to mutations of interest
        if (! meta.id.startsWith("simpletimer:")) return;
        // Make a Date 30 seconds in the future
        var thirtySecFromNow = new Date(); // Get current time & add 30 sec. to it.
        thirtySecFromNow.setSeconds(thirtySecFromNow.getSeconds() + 30);
        // Timers require an id
        var timer_id = meta.id;
        // Timers can access a context when they fire
        var context = {"id": meta.id, "random": Math.random(), "sched": thirtySecFromNow, doc: doc}
        // crate the Timer
        createTimer(TimerCallback, thirtySecFromNow, timer_id, context);
        log("From OnUpdate createTimer(TimerCallback, "+thirtySecFromNow+","+ timer_id+",", context);
    INPUT: KEY simpletimer:1
      "id": 1,
      "type": "simpletimer",
      "data": "ABCDEFG"
    2021-04-10T11:00:33.034-07:00 [INFO] "From TimerCallback: timer fired with context"
    2021-04-10T10:59:56.960-07:00 [INFO] "From OnUpdate createTimer(TimerCallback, Sat Apr 10 2021 11:00:26 GMT-0700 (Pacific Daylight Time),
    simpletimer:1," {"id":"simpletimer:1","random":0.8167888118053206,"sched":"2021-04-10T18:00:26.955Z","doc":{"id":1,"type":"simpletimer","data":"ABCDEFG"}}