Automatically migrated from Gitolite

Sven Slootweg 07a169994f Fix repository URL 4 years ago
lib 7e1f180cfd v1.0.0 5 years ago
.gitignore c2f7f1168f .gitignore created by brackets-git extension 5 years ago
README.md 8b57ac1e1d Maybe this'll work? 5 years ago
gulpfile.js 07a169994f Fix repository URL 4 years ago
index.coffee 7e1f180cfd v1.0.0 5 years ago
index.js 7e1f180cfd v1.0.0 5 years ago
package.json 07a169994f Fix repository URL 4 years ago

README.md

bluebird-tap-error

Like .tap in Bluebird, but for errors. Sees errors, but doesn't catch them. Handy when you want to peek at errors, but want to do the actual error handling elsewhere.

License

WTFPL or CC0, whichever you prefer. A donation and/or attribution are appreciated, but not required.

Donate

My income consists entirely of donations for my projects. If this module is useful to you, consider making a donation!

You can donate using Bitcoin, PayPal, Gratipay, Flattr, cash-in-mail, SEPA transfers, and pretty much anything else.

Contributing

Pull requests welcome. Please make sure your modifications are in line with the overall code style, and ensure that you're editing the .coffee files, not the .js files.

Build tool of choice is gulp; simply run gulp while developing, and it will watch for changes.

Be aware that by making a pull request, you agree to release your modifications under the licenses stated above.

Usage

A simple example:

var Promise = require("bluebird");
var tapError = require("bluebird-tap-error");

Promise.try(function() {
	return someBrokenAsyncThing();
}).catch(tapError(function(err) {
	console.log("We saw an error!", err);
})).catch(function(err) {
	/* The actual error handling goes here. */
})

API

tapError(func)

Wrap an error handling function in this function to make it tap into errors.

If an error occurred, it will be received by func (like it would happen for a normal .catch). The error is passed through as-is so that it can be handled elsewhere.

Any return value from this callback is ignored - including when the return value is a rejected Promise. You can only look at the error, and nothing else.

  • func: The callback to use.