@dizmo/functions-trace

Provides a @trace decorator, which traces each method invocation for all methods of a class via a global CONSOLE object, which is by default is the standard console. Further, a @traceable decorator is provided, which can selective enable (or disable) the tracing of a particular class method.

Tracing is applied only, when the global TRACE variable is set to true. It is also possible to set TRACE to a number, in which case tracing is deferred by the corresponding amount of milliseconds. Also, setting it to 0 will imply, that the invocations will be logged as soon as possible - however still asynchronously.

Usage

$3

``sh
npm install @dizmo/functions-trace --save
`

$3

`javascript
const { trace, traceable } = require('@dizmo/functions-trace');
`

$3

`typescript
import { trace, traceable } from '@dizmo/functions-trace';
`

`typescript
@trace / or: @trace(true|false) /
class MyClass {

// @traceable
public method_1() {}

// @traceable(true)
public method_2() {}

@traceable(false)
public method_3() {}
}
`

`typescript
import { Global } from '@dizmo/functions-trace';
`

`typescript
declare const global: Global;
global.TRACE = true; // or e.g. 200 milliseconds
`

Development

$3

`sh
npm run clean
`

$3

`sh
npm run build
`

#### without linting and cleaning:

`sh
npm run -- build --no-lint --no-clean
`

#### with UMD bundling (incl. minimization):

`sh
npm run -- build --prepack
`

#### with UMD bundling (excl. minimization):

`sh
npm run -- build --prepack --no-minify
`

$3

`sh
npm run lint
`

#### with auto-fixing:

`sh
npm run -- lint --fix
`

$3

`sh
npm run test
`

#### without linting, cleaning and (re-)building:

`sh
npm run -- test --no-lint --no-clean --no-build
`

$3

`sh
npm run cover
`

#### without linting, cleaning and (re-)building:

`sh
npm run -- cover --no-lint --no-clean --no-build
`

Documentation

`sh
npm run docs
`

Publish

`sh
npm publish
`

#### initially (if public):

`sh
npm publish --access=public
``

Copyright

© 2020 dizmo AG, Switzerland