last-run

    2.0.0 • Public • Published

    last-run

    NPM version Downloads Build Status Coveralls Status

    Capture and retrieve the last time a function was run.

    Usage

    var lastRun = require('last-run');
    
    function myFunc() {}
    
    myFunc();
    // capture the run after (or before) calling the function
    lastRun.capture(myFunc);
    
    // retrieve the last run time
    lastRun(myFunc);
    //-> outputs the Date.now() when capture was called

    API

    lastRun(fn, [timeResolution]) => [Timestamp]

    Takes a function (fn) and returns a timestamp of the last time the function was captured.

    Returns undefined if the function has not been captured.

    The timestamp is always given in millisecond but the time resolution can be reduced (rounded down). The use case is to be able to compare a build time to a file time attribute. On some file systems, fs.stat time attributes like mtime might have one second precision.

    lastRun.capture(fn, [timestamp])

    Takes a function (fn) and captures the current timestamp with Date.now(). If passed the optional timestamp, captures that time instead of Date.now(). The captured timestamp can then be retrieved using the lastRun function.

    lastRun.release(fn)

    Takes a function (fn) and removes the last run timestamp for it.

    License

    MIT

    Install

    npm i last-run

    DownloadsWeekly Downloads

    1,203,872

    Version

    2.0.0

    License

    MIT

    Unpacked Size

    4.99 kB

    Total Files

    4

    Last publish

    Collaborators

    • yocontra
    • phated