node/doc/api
Anna Henningsen ac153bd2a6 timers: fail early when callback is not a function
`setTimeout()`, `setInterval()` and `setIntermediate` currently
throw errors when receiving non-function objects as their first
argument, but only do so when trying to execute the callback,
i.e. after the waited time has passed. This may complicate
debugging when a lot of calls to `setTimeout()`/etc. are involved,
so failing as early as possible seems like a good idea.

`setTimeout()` historically ignored an falsy first
argument, while the other functions do not and throw instead.
This patch changes this behaviour to make all three match and
adds remarks in the corresponding documentation.

PR-URL: https://github.com/nodejs/node/pull/4362
Reviewed-By: Jeremiah Senkpiel <fishrock123@rocketmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Brian White <mscdex@mscdex.net>
Reviewed-By: Trevor Norris <trev.norris@gmail.com>
Reviewed-By: Rod Vagg <rod@vagg.org>
2016-01-04 14:56:19 +11:00
..
_toc.markdown deps: update v8 to 4.4.63.9 2015-08-04 11:56:14 -07:00
addons.markdown doc: improve addons.markdown copy 2015-12-23 12:19:42 -08:00
all.markdown deps: update v8 to 4.4.63.9 2015-08-04 11:56:14 -07:00
assert.markdown doc: improve assert.markdown copy 2015-12-28 12:14:49 -08:00
buffer.markdown doc: improvements to buffer.markdown copy 2015-12-23 13:47:54 -08:00
child_process.markdown doc: improve child_process.markdown copy 2015-12-30 10:29:48 -08:00
cluster.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
console.markdown doc: improvements to console.markdown copy 2015-12-30 10:42:29 -08:00
crypto.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
debugger.markdown doc: improvements to debugger.markdown copy 2015-12-30 11:21:13 -08:00
dgram.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
dns.markdown doc: improvements to dns.markdown copy 2015-12-30 10:48:10 -08:00
documentation.markdown doc: standardize references to node.js in docs 2015-12-03 12:28:10 -08:00
domain.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
errors.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
events.markdown doc: improvements to events.markdown copy 2015-12-30 10:50:52 -08:00
fs.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
globals.markdown doc: add links and backticks around names 2015-12-03 13:39:09 -08:00
http.markdown doc: mention that http.Server inherits from net.Server 2015-12-30 12:06:25 -08:00
https.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
index.markdown Remove util.print from docs 2010-11-07 17:22:56 -08:00
modules.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
net.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
os.markdown doc: sort os alphabetically 2015-11-12 17:39:55 -08:00
path.markdown path: make format() consistent and more functional 2015-11-27 11:53:33 +00:00
process.markdown doc: fix formatting in process.markdown 2015-12-29 19:06:23 -08:00
punycode.markdown doc: update links to use https where possible 2015-12-03 13:40:10 -08:00
querystring.markdown doc: sort querystring alphabetically 2015-11-12 17:40:07 -08:00
readline.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
repl.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
stream.markdown doc: add anchors for _transform _flush _writev in stream.markdown 2015-12-30 11:49:47 -08:00
string_decoder.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
synopsis.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
timers.markdown timers: fail early when callback is not a function 2016-01-04 14:56:19 +11:00
tls.markdown doc: improve grammar in tls docs 2015-12-23 17:17:51 -08:00
tty.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
url.markdown doc: url.format - true slash postfix behaviour 2015-12-06 09:02:55 +09:00
util.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
v8.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
vm.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00
zlib.markdown doc: fix, modernize examples in docs 2015-12-17 08:07:29 -08:00