Registry / devops / webpack-dev-stats-viewer-middleware

webpack-dev-stats-viewer-middleware

library1.0.0jsnpmunverified

Express middleware that works with webpack-dev-middleware to expose raw webpack stats at a configurable URL. Version 1.0.0, likely stable with low release cadence. Key differentiator: provides deep visibility into webpack compilation stats (assets, modules, chunks) for debugging and monitoring, leveraging webpack-dev-middleware's serverSideRender flag. Unlike webpack-bundle-analyzer or other visualizers, this package gives raw stats JSON for programmatic inspection.

devops observability web-framework

npm install webpack-dev-stats-viewer-middleware

github ↗package ↗

INSTALL

IMPORT

SIG · WEBPACK-DEV-STATS-

webpack-dev-stats-viewer-middleware

devopsjavascriptv1.0.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

statsViewer

✓ const statsViewer = require('webpack-dev-stats-viewer-middleware');

✗ import statsViewer from 'webpack-dev-stats-viewer-middleware';

Package only provides a CommonJS module (require). No ESM export.

default export (function)

✓ import statsViewer from 'webpack-dev-stats-viewer-middleware';

✗ import { statsViewer } from 'webpack-dev-stats-viewer-middleware';

Default export is a function; named import will not work.

TypeScript type (if available)

✓ import statsViewer from 'webpack-dev-stats-viewer-middleware';

Package does not ship TypeScript types; use @types/ or define own.

Set up an Express app with webpack-dev-middleware and add the stats viewer at /dev-server/stats.

const express = require('express'); const webpack = require('webpack'); const webpackMiddleware = require('webpack-dev-middleware'); const statsViewer = require('webpack-dev-stats-viewer-middleware'); const app = express(); const compiler = webpack({ mode: 'development', entry: './src/index.js' }); app.use('/dev-server/', webpackMiddleware(compiler, { serverSideRender: true })); statsViewer(app, '/dev-server/stats'); app.listen(3000, () => console.log('Server running on port 3000'));

Debug

Known issues

gotchaURL must be under webpack-dev-middleware's path (e.g., /dev-server/stats) and within the same path prefix used for the middleware.

fix

Ensure statsViewer URL is a subpath of the webpack-dev-middleware mount path.

affects: >=1.0.0

gotchawebpack-dev-middleware must be called with serverSideRender: true for the stats object to be attached to the request.

fix

Add { serverSideRender: true } as second argument to webpack-dev-middleware.

affects: >=1.0.0

deprecatedRequire-style import may become deprecated if package adopts ESM in future.

fix

No immediate fix; monitor for ESM support.

affects: >=1.0.0

Errors

Common errors & fixes

TypeError: Cannot read property 'stats' of undefined

webpack-dev-middleware not configured with serverSideRender: true, so req.stats is missing.

fix

Add { serverSideRender: true } to webpack-dev-middleware options.

statsViewer is not a function

Incorrect import; trying to use default import in CJS environment or named import on a default export.

fix

Use const statsViewer = require('webpack-dev-stats-viewer-middleware'); (CJS) or import statsViewer from 'webpack-dev-stats-viewer-middleware' (ESM, if supported).

Upgrade

Version history

1.0.0latest on npm

Audit

Dependencies

webpack-dev-middlewarerequiredPeer dependency - this middleware must be used after webpack-dev-middleware with serverSideRender: true

Agent activity

40 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/configurator/webpack-dev-stats-viewer-middleware ↗

packagehttps://www.npmjs.com/package/webpack-dev-stats-viewer-middleware ↗