Suggestion: API parity with clearTimeout and clearInterval

[JamesMGreene]

What are your thoughts on completing API parity with the core Timers APIs by adding the top-level methods clearTimeout and clearInterval to this module's API?

Obviously it would be simple to do so:

exports.clearTimeout = function (timer) {
	if (timer instanceof Timeout) {
		timer.clear();
	}
};

exports.clearInterval = function (timer) {
	if (timer instanceof Interval) {
		timer.clear();
	}
};

Happy to submit a PR for this, plus unit tests, if you're good with the suggestion.

[JamesMGreene]

I'd also really like to see these added as I am going to recommend that known consumers of my older module safetimeout (basically the same intent as your module) switch over to safe-timers.

[JamesMGreene]

@ronkorving: Thoughts on this one?

[ronkorving]

Sure, sounds good 👍
I think you don't even really need the if-statements by the way.

This also works in the browser:

var t = setTimeout(function () { console.log('fired'); }, 10);
clearInterval(t);

t does not fire.

[JamesMGreene]

@ronkorving: Well, the browsers' behavior is really just an implementation shortcut/quirk rather than a guaranteed spec-compliant behavior. Regardless, if you are suggesting to keep this module's implementation similarly loose (which it seems like you are), then I'm fine with that.