https://github.com/litert/logger.js
A logs-recorder for LiteRT framework.
https://github.com/litert/logger.js
javascript js log logger logging nodejs
Last synced: 3 months ago
JSON representation
A logs-recorder for LiteRT framework.
- Host: GitHub
- URL: https://github.com/litert/logger.js
- Owner: litert
- License: other
- Created: 2018-02-24T08:53:38.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2026-03-31T15:04:23.000Z (3 months ago)
- Last Synced: 2026-03-31T17:09:54.004Z (3 months ago)
- Topics: javascript, js, log, logger, logging, nodejs
- Language: TypeScript
- Homepage: https://fenying.net
- Size: 321 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: LICENSE
Awesome Lists containing this project
README
# LiteRT/Logger
[](https://www.npmjs.com/package/@litert/logger "Stable Version")
[](https://github.com/litert/logger/blob/master/LICENSE)
[](https://nodejs.org/dist/latest-v8.x/)
[](https://github.com/litert/logger.js/issues)
[](https://github.com/litert/logger.js/releases "Stable Release")
A logs writer for LiteRT framework.
## Features
- [x] Log stack trace.
- [x] Enable/Disable log levels.
- [x] Custom levels.
- [x] Custom formats.
- [x] Custom output drivers.
## Requirement
- TypeScript v5.0.0 (or newer)
- Node.js v18.0.0 (or newer)
## Installation
Install by NPM:
```sh
npm i @litert/logger --save
```
## Quick Start
Simple usage:
```ts
// The imported module is a LoggerFactory singleton object, so you can use it directly.
import LoggerFactory from "@litert/logger";
const logger = LoggerFactory.createLogger('Demo');
logger.info('Hello, world!');
logger.warning('Hello, world!');
// Now, just disable a level, and it will not be printed.
logger.setLevelOptions({ levels: ['error'], enabled: false });
logger.error('Hello, world! (WILL NOT BE PRINTED)');
// let's turn on the stack trace, print 2 lines of stack trace.
//
// without specifying levels, all levels will be affected.
logger.setLevelOptions({ traceDepth: 2 });
logger.notice('Hello, world!');
```
Use custom log formatter:
```ts
import LoggerFactory from "@litert/logger";
LoggerFactory.setLevelOptions({ enabled: true });
const logger = LoggerFactory.createLogger('Demo');
logger.setLevelOptions({
formatter: function(log, subj, lv, dt, traces): string {
if (traces?.length) {
return `${new Date(dt).toISOString()} - ${subj} - ${lv} - ${log}
${traces.join('\n ')}
`;
}
return `${new Date(dt).toISOString()} - ${subj} - ${lv} - ${log}`;
}
});
logger.info('Hello, world!');
logger.warning('Hello, world!');
logger.setLevelOptions({ traceDepth: 2 });
logger.error('Hello, world!');
```
More Examples:
- [Quick Start](./src/examples/quick-start.ts)
- [Custom log levels](./src/examples/custom-levels.ts)
- [Custom log formatter](./src/examples/custom-formatter.ts)
- [Custom log output driver](./src/examples/custom-driver.ts)
- [Using factory](./src/examples/using-factory.ts)
## License
This library is published under [Apache-2.0](./LICENSE) license.