redux-logic-test

library2.0.0jsnpmunverified

redux-logic-test provides testing utilities specifically designed to simplify the integration and unit testing of Redux Logic modules. It offers a `createMockStore` function that sets up a Redux store with a `redux-logic` middleware instance, allowing developers to easily inject logic, initial state, and mocked dependencies (like an API service) for isolated testing. The utility also includes built-in action tracking and a `whenComplete` helper to ensure all asynchronous logic operations have finished before assertions are made. The current stable version is 2.0.0, which primarily relaxed peer dependency constraints for Redux and Redux Logic without introducing API breaking changes. Release cadence is tied to updates in its core dependencies, `redux` and `redux-logic`, aiming for compatibility rather than frequent feature additions. Its key differentiator is its direct integration with `redux-logic`'s specific patterns, offering a more tailored testing experience than generic Redux testing utilities.

testing observability

npm install redux-logic-test

github ↗package ↗

INSTALL

IMPORT

SIG · REDUX-LOGIC-TEST

redux-logic-test

testingjavascriptv2.0.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

createMockStore

✓ import { createMockStore } from 'redux-logic-test';

✗ import createMockStore from 'redux-logic-test';

createMockStore is a named export, not a default export.

createMockStore (CommonJS)

✓ const { createMockStore } = require('redux-logic-test');

✗ const createMockStore = require('redux-logic-test').default.createMockStore;

While older versions or some transpilation might result in `default.createMockStore`, the direct named import is the correct CJS pattern for many modern setups.

Type (if using TypeScript)

✓ import type { MockStore } from 'redux-logic-test';

For TypeScript, import types explicitly to avoid bundling unnecessary runtime code.

This example demonstrates setting up a mock Redux store with `redux-logic-test`, including a sample logic, mocked dependencies, initial state, and reducer. It dispatches actions, waits for logic completion, and logs the resulting state and dispatched actions for verification.

import { createMockStore } from 'redux-logic-test'; import { createLogic } from 'redux-logic'; const API = { get: (url) => Promise.resolve({ data: `Fetched data from ${url}` }) }; const fooLogic = createLogic({ type: 'FOO', process({ API, getState, action }, dispatch, done) { API.get(`/api/${action.payload}`) .then(results => { dispatch({ type: 'FOO_SUCCESS', payload: results.data }); }) .catch(error => { dispatch({ type: 'FOO_FAILURE', payload: error.message }); }) .finally(() => done()); } }); const logic = [fooLogic]; const injectedDeps = { API }; const initialState = { some: 'state' }; const reducer = (state = initialState, action) => { switch(action.type) { case 'FOO_SUCCESS': return { ...state, lastFetch: action.payload }; default: return state; } }; async function runTest() { const store = createMockStore({ initialState, reducer, logic, injectedDeps }); store.dispatch({ type: 'FOO', payload: 'item123' }); store.dispatch({ type: 'BAR' }); // Will be tracked but not processed by logic await store.whenComplete(); // Wait for fooLogic to finish console.log('Final State:', store.getState()); console.log('Dispatched Actions:', store.actions); // Example assertions (in a real test framework like Jest) // expect(store.getState().lastFetch).toBe('Fetched data from /api/item123'); // expect(store.actions).toEqual([ // { type: 'FOO', payload: 'item123' }, // { type: 'BAR' }, // { type: 'FOO_SUCCESS', payload: 'Fetched data from /api/item123' } // ]); } runTest();

Debug

Known issues

breakingVersion 2.0.0 relaxed peer dependency constraints for 'redux' and 'redux-logic'. While not a direct API breaking change in 'redux-logic-test', ensure your project's `redux` and `redux-logic` versions are compatible with the newly allowed ranges, especially if upgrading from a version that had stricter requirements. This could lead to runtime errors if older versions of peer dependencies are used that are not compatible with the relaxed range.

fix

Review and update your project's 'redux' and 'redux-logic' peer dependencies to satisfy the new ranges specified in redux-logic-test@2.0.0. Run `npm install` or `yarn install` to ensure correct versions are resolved.

affects: >=2.0.0

gotchaIt is crucial to install `rxjs`, `redux`, and `redux-logic` as peer dependencies. `redux-logic-test` itself is a dev dependency, but its functionality relies heavily on these runtime dependencies being present in your project. Forgetting to install `rxjs` is a common oversight as it's an indirect dependency of `redux-logic`.

fix

Ensure `npm install rxjs redux redux-logic --save` (or `--save-dev` if only for testing) is run, in addition to `npm install redux-logic-test --save-dev`.

affects: >=0.1.0

gotchaAlways call `store.whenComplete()` (or `store.logicMiddleware.whenComplete()`) and `await` it in async tests to ensure all asynchronous logic operations have finished before making assertions. Failing to do so can lead to flaky tests where assertions run before the logic has had a chance to dispatch final actions or update state.

fix

Wrap your assertions in an async block and await `store.whenComplete()` before verifying state or actions: `await store.whenComplete(); expect(store.actions).toEqual([...]);`

affects: >=0.1.0

Errors

Common errors & fixes

TypeError: Cannot read properties of undefined (reading 'createLogicMiddleware')

redux-logic is not installed or incorrectly resolved, which redux-logic-test depends on to create the middleware.

fix

Ensure 'redux-logic' is correctly installed in your project: `npm install redux-logic --save`.

TypeError: Cannot read properties of undefined (reading 'Observable')

rxjs, a peer dependency of redux-logic, is missing or incorrectly resolved.

fix

Install 'rxjs' in your project: `npm install rxjs --save`.

Error: Peer dependency 'redux' is not installed.

The 'redux' package, a peer dependency of redux-logic-test, is missing.

fix

Install 'redux' in your project: `npm install redux --save`.

ReferenceError: require is not defined

Attempting to use CommonJS `require()` syntax in an ES Modules environment without proper configuration, or vice-versa with `import`.

fix

Ensure your project is configured for either ES Modules (using `import`) or CommonJS (using `require`). If using ES Modules, ensure your `package.json` has `"type": "module"` and use `import { createMockStore } from 'redux-logic-test';`. If using CommonJS, use `const { createMockStore } = require('redux-logic-test');`.

Upgrade

Version history

2.0.0latest on npm

Audit

Dependencies

reduxrequiredPeer dependency required for the underlying Redux store functionality.

redux-logicrequiredPeer dependency, this library provides test utilities specifically for redux-logic.

rxjsrequiredIndirectly required as a peer dependency of redux-logic.

Agent activity

17 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/jeffbski/redux-logic-test ↗

packagehttps://www.npmjs.com/package/redux-logic-test ↗