LogJS ===== Lightweight logging for JavaScript
npm install logjs-umdLogJS
=====
Lightweight logging for JavaScript
_Now with AngularJS support!_
Why would anyone want another logging framework for JavaScript? What's the point when there are
perfectly good solutions such as Log4JS and Log4Javascript? Well, that's always a complicated
answer, but my reasons were these:
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 section:
Then, put one of the logging calls into your scripts:
var x = 10;
LogJS.info('The value of x is ' + x);
That's it!
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. It's important
to note that the configuration for the appender is undefined, but should be passed as an object like below.
For example:
Due to the use of Object.defineProperty() and 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 /test/angular/index.html
for a quick and dirty example of AngularJS integration.
You can contact me at bfattori@gmail.com