Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

logplease

Package Overview
Dependencies
Maintainers
1
Versions
18
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

logplease

Simple Javascript logger for Node.js and Browsers

  • 1.2.3
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
12K
decreased by-25.41%
Maintainers
1
Weekly downloads
 
Created
Source

logplease

Simple Javascript logger for Node.js and Browsers

DEMO Open the dev tools to see the log output

Screenshot

logplease does two simple things: output log messages to the console and to a file (Node.js only). Inspired by log4js and debug.

Features

  • Log messages to stdout or a file in Node.js or Browsers
  • Log levels
  • Customize the log messages
  • Colors!

Install

npm install logplease

Examples

Node.js
npm run example
Browser

Open example/index.html in your browser.

Usage

Node.js / Webpack

const Logger = require('logplease');

// Create loggers, see 'options' below for details
const logger1  = Logger.create('daemon',  { filename: 'debug.log', useColors: false, appendFile: true });
const logger2  = Logger.create('utils',   { color: Logger.Colors.Yellow });
const logger3  = Logger.create('logger3', { color: Logger.Colors.Magenta, showTimestamp: false, showLevel: false });

// Set global log level
Logger.setLogLevel(Logger.LogLevel.INFO)

// CAVEAT: log functions can't take any parameters. If you need params, use string interpolation.
const number = 5;
logger1.debug(`This is a log message #${number}`);
logger1.info(`This is a log message #${number}`);
logger1.warn(`This is a log message #${number}`);
logger1.error(`This is a log message #${number}`);

logger2.debug(`This is a log message #${number}`);
logger2.info(`This is a log message #${number}`);
logger2.warn(`This is a log message #${number}`);
logger2.error(`This is a log message #${number}`);

logger3.debug(`This is a log message #${number}`);
logger3.info(`This is a log message #${number}`);
logger3.warn(`This is a log message #${number}`);
logger3.error(`This is a log message #${number}`);

Browser

Copy dist/logplease.min.js to your javascripts directory and include it in your html. See example/index.html for details.

<body>
    <script type="text/javascript" src="logplease.min.js" charset="utf-8"></script>
    <script type="text/javascript">
      var logger  = Logger.create('logger name');
      logger.debug(`This is a log message`);
      logger.info(`This is a log message`);
      logger.warn(`This is a log message`);
      logger.error(`This is a log message`);  
    </script>
</body>

Log level

You can set a global log level to display only the wanted log messages.

const Logger = require('logplease');
Logger.setLogLevel(Logger.LogLevel.ERROR) // Show only ERROR messages
// or
Logger.setLogLevel('ERROR')

Log levels:

DEBUG
INFO
WARN
ERROR
NONE

Colors

You can set a color per logger.

const Logger = require('logplease');
const logger = Logger.create("logger name", { color: Logger.Colors.Yellow });

Colors:

Black, Red, Green, Yellow, Blue, Magenta, Cyan, Grey, White

Options

You can customize your logger.

const Logger = require('logplease');
const logger = Logger.create("logger name", options);

Available options and defaults:

const options = {
  useColors: true,     // Enable colors
  color: Colors.White, // Set the color of the logger
  showTimestamp: true, // Display timestamp in the log message
  showLevel: true,     // Display log level in the log message
  filename: null,      // Set file path to log to a file
  appendFile: true,    // Append logfile instead of overwriting
};

Build

Install build dependencies:

npm install

The build command will build the browser distributable. Note that for Node.js it is not needed to run the build command.

npm run build:dist

The distributable file will be located in dist/logplease.min.js

Build the browser example:

npm run build_examples

Keywords

FAQs

Package last updated on 15 Apr 2016

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc