# @~lisfan/logger

> 调试日志打印器

Latest version **1.3.4** (published 2017-12-15) · MIT license · 0 weekly downloads

## Install

```sh
npm install @~lisfan/logger
pnpm add @~lisfan/logger
yarn add @~lisfan/logger
bun add @~lisfan/logger
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.3.4 |
| Published | 2017-12-15 |
| First published | 2017-10-16 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | lisfan |
| Maintainers | lisfan |
| Keywords | log, logger, debug, console, output |

## Links

- npm: https://www.npmjs.com/package/@~lisfan/logger
- Repository: https://github.com/lisfan/logger
- Homepage: https://github.com/lisfan/logger#readme
- Issues: https://github.com/lisfan/logger/issues
- npm.io page: https://npm.io/package/@~lisfan/logger

## Dependencies (1)

- [@~lisfan/validation](https://npm.io/package/@~lisfan/validation.md) ^1.0.0

## Alternatives

- [cli-color](https://npm.io/package/cli-color.md) — 3.4M weekly downloads
- [log](https://npm.io/package/log.md) — 1.3M weekly downloads
- [logstash-client](https://npm.io/package/logstash-client.md) — 4.5K weekly downloads
- [@nocobase/plugin-logger](https://npm.io/package/@nocobase/plugin-logger.md) — 2.0K weekly downloads
- [child-process-debug](https://npm.io/package/child-process-debug.md) — 695 weekly downloads

## Recent versions

- 1.3.4 (latest) — 2017-12-15
- 1.1.0-beta.0 (beta) — 2017-10-18
- 1.1.0-alpha.1 (alpha) — 2017-10-18
- 1.3.3 — 2017-12-14
- 1.3.2 — 2017-12-14
- 1.3.1 — 2017-11-06
- 1.3.0 — 2017-11-03
- 1.2.3 — 2017-11-03
- 1.2.3-0 — 2017-11-03
- 1.2.2 — 2017-11-03
- 1.2.2-0 — 2017-11-03
- 1.3.0-rc.2 — 2017-10-31
- 1.3.0-rc.1 — 2017-10-31
- 1.3.0-rc.0 — 2017-10-31
- 1.2.0-rc.4 — 2017-10-31
- … 15 more at https://npm.io/package/@~lisfan/logger/versions

## README

# logger

## 日志打印器

[API documentation](https://lisfan.github.io/logger/)

## Feature 特性

- 解决提交时因eslint提示console的语句无法通过问题
- 仅在开发环境打印日志，生产环境不打印日志

## Detail 详情

- 在console上包装了一层，支持console的所有的方法（包含部分非标准APi，但不包含未被废弃的API），部分API做了变化和新增加，未提及的保原效果不变，只是在原api上封装了一层进行代理运行，API使用方法可以参考[console API](https://developer.mozilla.org/en-US/docs/Web/API/Console/group)
  - 新增的isActivated、color、enable、disable方法
  - 调整error方法的作用：打印时会抛出错误，阻止脚本执行
  - 调整table方法的作用：如果数据非array或object类型，则使用this.log打印
- 若需要在生产环境下调式日志，可以更改或设置LS离线存储的值
   - localStorage设置`IS_DEV`为true
   - localStorage设置`LOGGER_RULES`配置命名空间规则
- 支持配置整个命名空间是否输出日志
- 支持配置命名空间下某个实例方法是否输出日志

## Install 安装

```bash
npm install -S @~lisfan/logger
```

## Usage 起步

```js
import Logger from '@~lisfan/logger'

// 配置规则
Logger.configRules({
   request:true, // 该命名空间支持打印输出
   request.error:false, // 该命名空间下的error方法不支持打印输出
   response:false // 该命名空间不支持打印输出
})

const logger = new Logger() // 默认打印器，命名空间为`logger`
const loggerRequest = new Logger('request') // 创建命名空间为`request`的打印器
const loggerResponse = new Logger('response')

// 创建打印器，但关闭调试功能
const loggerDebug = new Logger({
   name: 'debug',
   debug: false
})

loggerRequest.log('请求url')    =>    [request]: 请求url
loggerRequest.error('请求url')    =>    // 无内容打印
loggerResponse.error('响应数据')    =>    // 无内容打印
loggerDebug.log('请求url')    =>     // 无内容打印
```

---
_Source: https://npm.io/package/@~lisfan/logger · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._