This library gives you instant notification of errors in your site's JavaScript.
Include yeller.js from our CDN in the <head> tag of your site, before all
other <script> tags.
<script src="//js-yellerapp.a.ssl.fastly.net/yeller.js">Then immediately configure Yeller in another <script> tag in your <head>
Yeller.configure({
token: 'YOUR_API_TOKEN_HERE'
});That's it for basic configuration. There are a few more advanced settings later, but let's get you tracking errors first.
yeller.js automatically tracks errors by default, but if you want to manually
track one, you can do that like this:
try {
// your code here
} catch(error) {
Yeller.report(error);
}Yeller keeps track of which environment your application is runing in, and
segregates errors by environment. To set your environment, simply pass it
in in your call to Yeller.configure
Yeller.configure({
token: 'YOUR_API_TOKEN_HERE',
environment: 'production'
});Environments are simply strings. As a default, Yeller will ignore errors sent
in the test or development environments.
yeller.js also lets you attach additional data to your exception. The library
already includes information about the page, the web browser and so on.
try {
// your code here
} catch(error) {
Yeller.report(error, { custom_data: { user_id: user.id }});
}Attaching more debugging information gives you powerful diagnosis across all your exceptions.
Yeller allows you to transform errors before they are sent to the server.
This means that you can override e.g. user id, even for exceptions caught
by Yeller's toplevel exception handler (which uses window.onerror).
If you want to prevent errors from reaching Yeller's server
(e.g. maybe they come from third party scripts on your page),
then simply return false from your transform function.
Yeller.configure({
token: 'YOUR_API_TOKEN_HERE',
environment: 'production'
transform: function (error) {
error.message = "my error";
error['custom-data'].user = {
id: 1
};
return error;
}
});
try {
// your code here
} catch(error) {
Yeller.report(error, { custom_data: { user_id: user.id }});
}