parse-human-timeout-duration
v0.1.7
Published
Basically timestring-notsep but checks the range limits for valid JS setTimeout() timespans.
Downloads
5
Maintainers
Readme
parse-human-timeout-duration
Basically timestring-notsep but checks the range limits for valid JS setTimeout() timespans.
API
This module exports one function:
parseHumanTimeoutDuration(dura[, opts])
Takes a human-readable timespan dura
.
Returns false
(see below) or a number (see below).
opts
is an optional options object that supports these keys:
optional
: If true anddura
is one of the non-durationsfalse
,'never'
or'off'
, returnfalse
instead of complaining.unit
: Desired unit of measurement for the result number. Can be'sec'
(default) or'ms'
.min
: Complain if the result would be less than this. Defaults to0
.descr
: Text to annotate error messages with if an error occurrs.lookup
: A dictionary object.dura
is used as the key to look up the real duration.
parseHumanTimeoutDuration(opts)
If called with an object as first argument, and the second argument is
false-y or missing, the first is used as opts
.
In this case you have to specify the dura
as…
opts.key
ifopts.lookup
is used, oropts.duration
otherwise.
Usage
see test/usage.js.
Known issues
- Needs more/better tests and docs.
License
ISC