Contents

# Tastes Bitter

Get an email notification when a JavaScript error occurs in your Rails application.

## How it works

The JavaScript hooks into the `window.onerror` event by sending an XHR with the error data which is then emailed.

## Install

Add the gem to your `Gemfile`.

```ruby
gem 'tastes_bitter'
```

Use Bundler to install it.

```console
$ bundle install
```

Run the install generator.

```console
$ bundle exec rails generate tastes_bitter:install
```

## Configure

Open `config/initializers/tastes_bitter.rb` and update the configuration.

```ruby
TastesBitter.configure do |config|

  config.mailer_receiver = "[e-mail]"
  config.mailer_sender = "[e-mail]"
  config.mailer_subject_prefix = "[JavaScript Error] "

end
```

Make sure you have [ActionMailer configured](http://api.rubyonrails.org/classes/ActionMailer/Base.html) in order for emails to be sent.

Add the JavaScript file to `application.js`.

```coffeescript
//= require tastes_bitter/javascript_errors
```

It **does** matter where you include the JavaScript. It will only catch errors that occur *after* it has been loaded into the page. In general, you'll want to include it around the top of `application.js`. This will ensure it catches all errors from any other JavaScript code in your application.

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
tastes_bitter-0.0.2	README.md