RFC: Add Events to Raven

[bisrael]

Please do not accept this pull request yet

This adds several events:

document.addEventListener('ravenHandle', myCallback);
document.removeEventListener('ravenHandle', myCallback);

Right now, I'm triggering three events:

• ravenHandle: triggers as Raven gets called from TraceKit to handle an error
  • properties added to event object: stackInfo, options
• ravenSuccess: triggers when Raven has successfully reported an error to sentry
  • properties added to event object: data, src
• ravenFailure: triggers when Raven tried to report an error, but got back an bad response code.
  • properties added to event object: data, src

Discussion Points:

• Callback Names
• Callback Arguments (I definitely do not like what i'm passing now)
• Eventing Mechanism (is it too complex?)

Relevant Issues: #81 and #83

Edit: Updated to match current commits

[mattrobenolt]

First impression, the #1 concern is bloat. I'd like to leverage existing browser events if possible. I don't know too much about real events off the top of my head, but if it requires this much bloat to achieve it in a relatively compatible fashion, I'll just stick with callbacks. One of the goals of Raven is to be as light as possible since we don't want to have to promote deferred loading.

[bisrael]

Bloat is definitely a huge concern. I'm redoing this with DOM Events and we'll take a look at how that works.

[bisrael]

I updated the code to fire native events on the document.

[bisrael]

I also updated the top post with how it works now

[bisrael]

@mattrobenolt - have you had a chance to look over the changes?

[mattrobenolt]

@bisrael, I have not. I'm currently at PyCon, so I'll have to take a closer look after this weekend.

[mattrobenolt]

This looks good to me. Sorry it took so long. :)

[vperron]

Hello, I know the PR is closed and all, but I have stumbled upon libraries that use those messages and have not found much documentation about it...
Did I miss something or would it be nice to actually document the feature ?