CERQ

CERQ (= Client ERror Queue) is a Javascript for logging client-side Javascript errors.

Distributed under BSD-3 Clause license.

What can it do?

Log Javascript error information such as:

Error message
Error file
Error line
Page URL
Browser name
Browser version
Timestamp (unix)
Before or after the window load event.

What version to use?

The script is available in two versions:

Send error data to Google Analytics as Events cerq-ga.js, cerq-ga-min.js
- Works out of the box!
- Delay in GA showing the events data.
Send error data to Javascript Debug Console (via console.log) cerq.js
- You will have to implement the sendError function.

How to use?

Put the following code in the <head> tag

<script type="text/javascript">
var _cerq=[];(function(a,c){a.onerror=function(){_cerq.push(arguments)};
var b=function(){var a=c.createElement("script");a.type="text/javascript";a.async=!0;
a.src="/js/cerq-ga-min.js";var b=c.getElementsByTagName("script")[0];
b.parentNode.insertBefore(a,b)};a.addEventListener&&(a.addEventListener("load",b,!1),1)
||a.attachEvent&&a.attachEvent("onload",b)||b()})(window,document);
</script>

Note: Be sure to change the script path in a.src as required.

Using version 1 (cerq-ga-min.js minified via Closure)

Format of Event:

category: CERQ  
action:   Error file URL  
label:    JSON encoded error data object

For example:

category: CERQ  
action:   http://www.example.com/js/main.js  
label:    {"m":"Uncaught ReferenceError: abc is not defined","l":299,"d":"before"}

Error data explained:

{
	"m":"Uncaught ReferenceError: abc is not defined",	//error message
	"l":299,											//error line
	"d":"before"										//dom load state i.e. before or after
}

Note: Page URL, Approximate Time, Browser Name & Browser Version are already available in Google Analytics so they have been excluded.

If you are OK with this, then go ahead and use cerq-ga-min.js otherwise you can make changes in cerq-ga.js.

Using version 2 (cerq.js) or version 1 (cerq-ga.js)

For version 2, you need to implement the sendError function to transport the error as per your needs.

See processError function for more details on the error data object.

Tips:

If you enable the time stamp then GA won't be able to group the same error be default, instead you will have to use the help of filters.
Run finished script through Closure for minfying. Closure removes the anonymous function wrapper from the code, which must be put back in as follows:
```
  (function(){ /* Put the code in here */ })();
```

License

Copyright (c) 2012, Prakhar Birla
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
    * Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in the
      documentation and/or other materials provided with the distribution.
    * Neither the name of the <organization> nor the
      names of its contributors may be used to endorse or promote products
      derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL PRAKHAR BIRLA BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

License

birla/cerq

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages