Package detail

logger-clearable

bevry140Artistic-2.04.8.0

A logger that is clearable

clear, es5, esnext, log

readme

logger-clearable

Status of the GitHub Workflow: bevry NPM version NPM downloads
GitHub Sponsors donate button ThanksDev donate button Patreon donate button Liberapay donate button Buy Me A Coffee donate button Open Collective donate button crypto donate button PayPal donate button
Discord server badge Twitch community badge

A logger that is clearable

Usage

Complete API Documentation.

'use strict'

// create our clearable logger
const logger = require('logger-clearable').create()
const method = 'log'

// log the date every second
const timer = setInterval(function () {
    if (method === 'log') {
        const date = new Date()
        const time = date.toISOString()
        logger.log(time)
    } else {
        // the above will actually call: logger.queue(() => time)
        // instead, we can use queue directly:
        // using queue direclty is more performant as
        // any setup for our particular message will happen only if that message will be written
        // this is applicable as logger won't bother writing messages that would be cleared instantly
        // e.g. logger.log('hello').log('world') would otherwise write 'hello' then have to clear it right away
        // instead, logger just skips writing 'hello' and will just write 'world'
        logger.queue(function () {
            const date = new Date()
            const time = date.toISOString()
            return time
        })
    }
}, 100)

// on ctrl+c close the timer and discard any upcoming logs
process.on('SIGINT', () => {
    // stop any more calls to logger
    clearInterval(timer)
    // discard any logger queued updated
    logger.discard()
    // and clear the log
    logger.clear()
})

Install

npm

  • Install: npm install --save logger-clearable
  • Import: import * as pkg from ('logger-clearable')
  • Require: const pkg = require('logger-clearable')

Editions

This package is published with the following editions:

  • logger-clearable aliases logger-clearable/index.cjs which uses the Editions Autoloader to automatically select the correct edition for the consumer's environment
  • logger-clearable/source/index.js is ESNext source code for Node.js 6 || 8 || 10 || 12 || 14 || 16 || 18 || 20 || 21 with Require for modules
  • logger-clearable/edition-node-4/index.js is ESNext compiled for Node.js 4 || 6 || 8 || 10 || 12 || 14 || 16 || 18 || 20 || 21 with Require for modules

TypeScript

This project provides its type information via inline JSDoc Comments. To make use of this in TypeScript, set your maxNodeModuleJsDepth compiler option to 5 or thereabouts. You can accomplish this via your tsconfig.json file like so:

{
  "compilerOptions": {
    "maxNodeModuleJsDepth": 5
  }
}

History

Discover the release history by heading on over to the HISTORY.md file.

Backers

Code

Discover how to contribute via the CONTRIBUTING.md file.

Authors

Maintainers

Contributors

Finances

GitHub Sponsors donate button ThanksDev donate button Patreon donate button Liberapay donate button Buy Me A Coffee donate button Open Collective donate button crypto donate button PayPal donate button

Sponsors

  • Andrew Nesbitt — Software engineer and researcher
  • Balsa — We're Balsa, and we're building tools for builders.
  • Codecov — Empower developers with tools to improve code quality and testing.
  • Poonacha Medappa
  • Rob Morris
  • Sentry — Real-time crash reporting for your web apps, mobile apps, and games.
  • Syntax — Syntax Podcast

Donors

License

Unless stated otherwise all works are:

and licensed under:

changelog

History

v4.8.0 2024 January 2

v4.7.0 2023 December 30

v4.6.0 2023 December 28

v4.5.0 2023 December 6

v4.4.0 2023 November 25

v4.3.0 2023 November 21

v4.2.0 2023 November 15

v4.1.0 2023 November 14

v4.0.0 2023 November 14

  • Updated dependencies, base files, and editions using boundation
  • Minimum required Node.js version changed from node: >=10 to node: >=4 adapting to ecosystem changes

v3.18.0 2023 November 2

v3.17.0 2021 July 30

v3.16.0 2021 July 29

v3.15.0 2021 July 28

v3.14.0 2020 October 29

v3.13.0 2020 September 5

v3.12.0 2020 August 18

v3.11.0 2020 August 4

v3.10.0 2020 July 22

v3.9.0 2020 June 25

v3.8.0 2020 June 22

v3.7.0 2020 June 21

v3.6.0 2020 June 20

v3.5.0 2020 June 11

v3.4.0 2020 June 10

v3.3.0 2020 May 22

v3.2.0 2020 May 21

v3.1.0 2020 May 21

v3.0.0 2020 May 11

  • Updated dependencies, base files, and editions using boundation
  • Minimum required node version changed from node: >=8 to node: >=10 to keep up with mandatory ecosystem changes

v2.3.0 2019 December 9

v2.2.0 2019 December 1

v2.1.0 2019 December 1

v2.0.0 2019 November 18

  • Updated dependencies, base files, and editions using boundation
  • Minimum required node version changed from node: >=4 to node: >=8 to keep up with mandatory ecosystem changes

v1.1.0 2019 November 13

v1.0.1 2019 January 1

v1.0.0 2018 July 27

  • Initial working release