Added by: Sam Deering
Now with AngularJS support!
The two projects mentioned are trying to emulate log4j for the Java platform. Who needs all that functionality when all that I really want to do is log messages? If you need something which carries a lot of weight, or has tons of features, go grab one of those projects. However, if you want something super lightweight, that doesn't require any third party libraries, then LogJS is probably for you.
LogJS is 4k uncompressed and less than 1k compressed and minified. It doesn't require jQuery or any other third party libraries. It comes with four simple appenders which can be used together or standalone. It's easy to write new appenders. It's not carrying around baggage to make it compatible with old browsers from days gone by. It has a set of tests to make sure it keeps on working.
LogJS can't do any logging itself - it needs an appender to do that. Essentially, an appender is the connection between the logger and the location for log messages to be sent. LogJS comes with a console appender to utilize the browser console, a DOM appender which will create a window to show log messages, a local storage appender which saves messages to a persistent store, and finally a CORS (Cross-Origin Resource Sharing) appender which can send messages to a server for storage.
It is possible to run as many appenders, or as few as you want. It's also possible to run without any appenders so that no logging is performed. This way, the logging can be left in the code without violating JSLint rules such as 'console.log'.
Simple. Add the following to your
Then, put one of the logging calls into your scripts:
var x = 10; LogJS.info('The value of x is ' + x);
Right. This is where the Appenders come into play. After your script for LogJS, add the following and re-issue the logging statement:
Now you will see a log message in the console. Try loading another appender, such as the DOM appender, and you'll get a nifty in-page logging pane. This is where Appenders come in really handy! You can add as many, or as few, appenders as you want or need.
Some appenders require some configuration options to run, such as the
LocalStorageAppender. You can
set the interval between serializations and the maximum size of the buffer to maintain. For example:
Due to the use of
Date.now, this library doesn't work with IE8, Firefox 3.5 or 3.6,
or Opera 10.5-11.5. All other browsers should work just fine. It has been officially tested with Chrome 23+ for OSX,
Firefox 19+ for OSX, and Safari 6+ for OSX.
The only requirement is to load AngularJS before you load LogJS and appenders. See
for a quick and dirty example of AngularJS integration.
You can contact me at firstname.lastname@example.org
Module stats last updated: 2017-10-13 15:00:03