https://github.com/stritti/log4js

Log4js - The Logging Framework for JavaScript with no runtime dependencies
https://github.com/stritti/log4js

javascript log4js logging

Last synced: 3 days ago
JSON representation

Log4js - The Logging Framework for JavaScript with no runtime dependencies

• Host: GitHub
• URL: https://github.com/stritti/log4js
• Owner: stritti
• License: apache-2.0
• Created: 2014-03-25T21:56:06.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2023-02-27T22:41:32.000Z (over 1 year ago)
• Last Synced: 2024-10-14T08:13:34.134Z (22 days ago)
• Topics: javascript, log4js, logging
• Language: XSLT
• Homepage: https://stritti.github.io/log4js/
• Size: 3.01 MB
• Stars: 448
• Watchers: 18
• Forks: 58
• Open Issues: 29
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-github-star - log4js - The Logging Framework for JavaScript with no runtime dependencies | stritti | 444 | (XSLT)

README

        
[![Apache License](http://img.shields.io/badge/license-Apache%202.0-blue.svg?style=flat)](LICENSE.txt)

[![Github Releases](https://img.shields.io/github/downloads/atom/atom/latest/total.svg)](https://github.com/stritti/log4js/releases)

[![Built with Grunt](https://cdn.gruntjs.com/builtwith.png)](http://gruntjs.com/)

[![Build Status](https://secure.travis-ci.org/stritti/log4js.png?branch=master)](http://travis-ci.org/stritti/log4js)

Log4js

======

Log4js - The Logging Framework for JavaScript with no runtime dependencies 

| Since [2005](https://github.com/stritti/log4js/commit/0b17184d2a998f6ff884261ba433c3e4f01cc95e)

## Usage

* Download the most current [release](https://github.com/stritti/log4js/releases) and unzip the archive.

* Copy the file `js/log4js.min.js` to your project.

* Add the JavaScript file to head of HTML page:

  ````html

  

    

  

  ````

* Add script for instantiation of Logger:

  ````javascript

  let consoleLog = new Log4js.Logger("consoleTest");

  consoleLog.setLevel(Log4js.Level.ALL);

  let consoleAppender = new Log4js.ConsoleAppender(true);

  consoleLog.addAppender(consoleAppender);

  

  ````

* Then you are able to add logging event:

  ````javascript

  consoleLog.trace('I was traced!')

  ````

Within sources there is a more detailed [example](log4js/src/main/example/index.html).

## Development

The project is seperated in modules. Core JavaScript module is located in subdirectory `log4js` 

### Structure

````

├───log4js: Main JavaScript Log4js module 

├───log4js-servlet: Java Servlet to collect AJAX-Logs serverside

├───log4js-solr: configuration to collect logs using Apache SOLR

├───log4js-site: (outdated) project documentation

 

````

### Log4js

> Main JavaScript module

To build the JavaScript library we use [npm](https://www.npmjs.com/) and [grunt](https://gruntjs.com/). 

````

cd log4js

npm install

grunt build

````

Include then the `target/log4js.min.js` file in your project.

More details in the [Wiki](https://github.com/stritti/log4js/wiki/Development)

### Log4js Servlet

The servlet is Java based project which is compiled using `maven`.

### Log4js SOLR

For more details see [README.md](log4js-solr/README.md) in the subdirectory [log4js-solr](log4js-solr)

### Log4js Site

Outdated documentation.

## Contribution

[Pull Requests](https://github.com/stritti/log4js/pulls) are very welcome.

## Other JavaScript Logger

There are a lot other projects which are started logging in JavaScript:

There is a very active fork of current log4js framework modified for node.js usage: https://github.com/nomiddlename/log4js-node

Further loggers could be found (and added!) in the [Wiki](https://github.com/stritti/log4js/wiki/Other-JavaScript-Logger).

# License

[LICENSE.txt](LICENSE.txt)

[![Analytics](https://ga-beacon.appspot.com/UA-327996-12/stritti/log4js)](https://github.com/igrigorik/ga-beacon)