Effector Logger

Pretty logger for stores, events, effects and domains.


| !Chrome-DevTools-Console |
| ---------------------------------------------------------------- |
| !Chrome-DevTools-Console-Dark |

Installation

``bash
npm add effector
npm add --dev effector-logger
`

or yarn

`bash
yarn add effector
yarn add -D effector-logger
`

> Note: effector-logger requires effector to be installed

Usage

$3

To make logs more useful we need additional metadata (like names, locations in the code, etc), which is provided by one of the effector plugins.

#### Babel-plugin

Babel-plugin is built-in in the effector package.

Just add it to your babel configuration.

`json
{
"plugins": ["effector/babel-plugin"]
}
`

It is also useful to enable loc generation for dev environment, to see for exact locations of units in the code.

`json
{
"plugins": [["effector/babel-plugin", { "addLoc": true }]]
}
`

Read the docs

#### SWC Plugin

Read effector SWC plugin documentation

$3

Just call attachLogger in your entrypoint module.

NOTE: To "see" the createStore, createEvent, etc calls effector-logger needs to be imported at the very top of your entrypoint module. This way initial states of stores will be properly logged at the moment of attachLogger call.

Update logs are not affected by import order.

`ts
// src/index.tsx
import { attachLogger } from 'effector-logger';

import React from 'react';
import { createRoot } from 'react-dom/client';
import { App } from './app';
import { appStarted } from './shared/app-events';

attachLogger();

appStarted();

createRoot(document.querySelector('#app')).render();
`

After that you will see the logs in your console.

$3

If your app uses scope (e.g. you have Server-Side-Rendering) - you will need to pass it to the logger to work.

`ts
attachLogger({ scope });
`

Updates related to provided scope will be prefixed with scope id.

$3

There optional name prefix to the logs.
It can be useful if there are few instances of your app, which are using different scopes or if you just want prefix that is better than boring scope id.

`ts
attachLogger({
scope,
name: my-cool-app-${appId}, // all logs will be prefixed with this string
});
`

$3

To stop logs just call unsubscribe function.

`ts
const unlogger = attachLogger();

unlogger();
`

$3

Sometimes it is required to hide some events or stores from log.
It is simple to implement: just call configure on your unit.

`ts
import { createEvent } from 'effector';
import { configure } from 'effector-logger';
import { $data, loadDataFx } from './model';

const pageMounted = createEvent();

configure(pageMounted, { log: 'disabled' });

// You can pass multiple units as array
configure([$data, loadDataFx], { log: 'disabled' });
`

$3

By default only non-derived units are logged. If you want to force some unit to be logged, use configure enabled

`ts
import { createEvent } from 'effector';
import { configure } from 'effector-logger';
import { $data, loadDataFx } from './model';

const pageMounted = createEvent();

const mappedMounted = pageMounter.map((x) => x);

configure(mappedMounted, { log: 'enabled' });

// You can pass multiple units as array
configure([$data, loadDataFx], { log: 'enabled' });
`

Redux DevTools support

Redux DevTools is moved to a different package.

See the @effector/redux-devtools-adapter`

Contributors ✨

Thanks go to these wonderful people (emoji key):

Andrey Antropov 💻

Sergey Sova 💻

Sozonov 💻

This project follows the all-contributors specification. Contributions of any kind welcome!

Release process

1. Check out the draft release.
1. All PRs should have correct labels and useful titles. You can review available labels here.
1. Update labels for PRs and titles, next manually run the release drafter action to regenerate the draft release.
1. Review the new version and press "Publish"
1. If required check "Create discussion for this release"