jongallery-itsaerrorreporter
This module full automaticly reports error-events by pop-up an error-dialog.
Catching errors during development (logging) are prominent available now.
Also error-events during production will be shown to the users.
By default it listens to:
- window.onerror
- broadcasted ‘error’-events
- error-loggings
All listeners can be (un)set.
The broadcasted ‘error’-events must confirm the following rules:
- Do not fire Y.fire(‘error’) –> because ‘error’ is a dom-event, the subscriber could fail to catch the event under some circumstances.
- Always fire through the instance (sub-class of EventTarget) –> for instance: yourModel.fire(‘error’);
- Always make sure your instance targets Y. Either by yourModel.addTarget(Y);, or by yourModel.publish(‘error’, {broadcast: 1}); which also could be done inside the class-definition.
Examples
Documentation
Usage
ErrorReport when fireing an ‘error’-event
YUI({gallery: 'gallery-2013.06.20-02-07'}).use('gallery-itsaerrorreporter', 'model', function(Y) {
var mymodel, facade;
mymodel = new Y.Model();
facade = {src: 'webapplication', msg: 'Simulating an error'};
mymodel.addTarget(Y);
mymodel.fire('error', facade);
// the event is caught and leads to an error-pop-up
});
ErrorReport when logging an ‘error’
YUI({gallery: 'gallery-2013.06.20-02-07'}).use('gallery-itsaerrorreporter', function(Y) {
Y.log('logging an error', 'error', 'webapp');
// the logging is caught and leads to an error-pop-up
});
Disabling error-messages when logging an ‘error’
YUI({gallery: 'gallery-2013.06.20-02-07'}).use('gallery-itsaerrorreporter', 'model', function(Y) {
var mymodel, facade;
Y.ITSAErrorReporter.reportErrorLogs(false);
mymodel = new Y.Model();
facade = {src: 'webapplication', msg: 'Simulating an error'};
mymodel.addTarget(Y);
mymodel.fire('error', facade);
// the event is caught and leads to an error-pop-up
});
License
Copyright (c) 2013 Its Asbreuk