Registry / devops / webpack-serve-waitpage

webpack-serve-waitpage

library1.0.2jsnpmunverified

A middleware plugin for webpack-serve that displays a progress page during webpack compilation, replacing the default blank page with a customizable wait screen. Current stable version is 3.0.0 (supports webpack 5 and Node 18). This package is specific to the legacy webpack-serve (v1/v2), not webpack-dev-server. Alternatives include webpack-dev-server's built-in progress overlay or separate plugins like webpack-dashboard.

devops

npm install webpack-serve-waitpage

github ↗package ↗

INSTALL

IMPORT

SIG · WEBPACK-SERVE-WAIT

webpack-serve-waitpage

devopsjavascriptv1.0.2

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.

default

✓ const webpackServeWaitpage = require('webpack-serve-waitpage');

✗ import webpackServeWaitpage from 'webpack-serve-waitpage';

This package is CommonJS only and does not ship ESM. Use require().

types

✓ // Types are already included in the package; no separate import needed

✗ import { WaitpageOptions } from 'webpack-serve-waitpage';

TypeScript definitions are included but not exported; use JSDoc comments or rely on inference.

middleware invocation

✓ app.use(webpackServeWaitpage(options));

✗ app.use(webpackServeWaitpage.middleware(options));

In versions <0.3.0, .middleware() was required. Since 0.3.0, the default export is the factory directly.

Shows how to integrate webpack-serve-waitpage as middleware in a webpack-serve config, with custom theme and disableWhenValid option.

Debug

Known issues

breakingChanged from plugin to middleware. In v0.2.0, you had to use webpackServeWaitpage.middleware(). In v0.3.0, you must use the default export directly: app.use(webpackServeWaitpage(options)).

fix

Update usage: remove .middleware() call. See quickstart.

affects: >=0.3.0

breakingOption 'disableWhenValid' default changed to true in v1.0.0.

fix

If you rely on the wait page always showing, set disableWhenValid: false explicitly.

affects: >=1.0.0

gotchaPackage works only with webpack-serve, not webpack-dev-server. Despite similar names, webpack-serve is a separate tool.

fix

Use webpack-dev-server-waitpage for webpack-dev-server.

affects: *

deprecatedNode.js 10 and below are not supported in v3.0.0.

fix

Upgrade Node.js to v12 or later.

affects: >=3.0.0

gotchaIn v2.0.0, support for webpack 5 was added, but configuration path may differ. Ensure webpack-serve is compatible with webpack 5.

fix

Check webpack-serve compatibility; see migration guides.

affects: >=2.0.0 <3.0.0

Errors

Common errors & fixes

Error: Cannot find module 'webpack-serve-waitpage'

Package not installed or misspelled.

fix

Run npm install -D webpack-serve-waitpage

TypeError: webpackServeWaitpage is not a function

Importing incorrectly – e.g., using default import in ESM or accessing .middleware.

fix

Use const webpackServeWaitpage = require('webpack-serve-waitpage'); and call it directly.

Cannot read property 'includes' of undefined

Bug in v2.1.1 when disableWhenValid is false.

fix

Upgrade to v2.1.0 or v3.0.0.

Upgrade

Version history

1.0.2latest on npm

Audit

Dependencies

webpackrequiredPeer dependency – works with webpack 4 or 5

webpack-serverequiredPeer dependency – requires webpack-serve v1 or v2

Agent activity

11 hits · last 30 days

node

Anthropic

Resources

githubhttps://github.com/elisherer/webpack-serve-waitpage ↗

packagehttps://www.npmjs.com/package/webpack-serve-waitpage ↗