# log4js

**Repository Path**: li_xu/log4js

## Basic Information

- **Project Name**: log4js
- **Description**: 一个简单可配的 log 系统，用于各种 javascript 环境。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2021-01-21
- **Last Updated**: 2021-01-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# log4js
一个简单可配的 log 系统，用于各种 javascript 环境。

## 特色
- 支持 `debug` 、`info` 、`error` 三个日志级别，使用 `close` 关闭所有日志。
- 支持多模块日志分离，配合 Chrome Filter 可以提高浏览器下的调试体验。 
- chrome/nodejs 下支持漂亮的着色。
- nodejs 下支持输出源码行号。
- 配合 log4js-remote 插件，可以将前端日志通过网络打印到远程。


## 注意
- 日志级别如果不配置，默认是 `info`, 也就是只打印 `info` 、`error` 日志，`debug` 被屏蔽。

## 安装
```
npm i git+https://gitee.com/goodidea/log4js.git
```


## 导入
```javascript
require("log4js")
```

导入后引入了两个全局变量，`log4js` 和 `log`。
- `log4js` 是日志控制对象，可以创建分模块的 log 对象。
- `log` 是默认的 log 对象。默认 log 对象的日志级别可以通过全局变量 log4js_level = 'error' 控制。

全局变量在 windows 环境是 window ，在 nodejs 环境是 global


## 使用
### 简单使用

```

log.debug("test debug")

log.info("test info")

log.error("test info")

```

> 更偷懒的写法如下，偷懒是人类进步的动力！

```

log.d("test debug")

log.i("test info")

log.e("test info")

```


### 分模块使用

```
var logger = log4js.get("main") // main 是模块名

logger.debug("test debug")

logger.info("test info")

logger.error("test info")

```


## 样例
![chrome](./images/chrome.png)
![node](./images/node.png)