Registry / devops / webpack-plugin-hash-output

webpack-plugin-hash-output

library3.2.1jsnpmunverified

A Webpack plugin that replaces chunkhash placeholders with an MD5 hash of the final file content, computed after all other plugins (like UglifyJsPlugin) have run. v3.2.1 requires Webpack >=4. Unlike other hash plugins that compute hashes earlier, this plugin ensures that any change in the build pipeline—including minification configuration—is reflected in the output hash, preventing cache conflicts. It supports sourcemaps partially and has known ordering requirements with plugins like HtmlWebpackPlugin. Maintained on GitHub, low release cadence (last release 2020).

devops

npm install webpack-plugin-hash-output

github ↗package ↗

INSTALL

IMPORT

SIG · WEBPACK-PLUGIN-HAS

webpack-plugin-hash-output

devopsjavascriptv3.2.1

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.

HashOutput

✓ const HashOutput = require('webpack-plugin-hash-output');

✗ import HashOutput from 'webpack-plugin-hash-output';

Plugin does not ship ESM; use CommonJS require. A default import via Babel/TypeScript may work if configured, but direct require is safest.

HashOutput

✓ import HashOutput from 'webpack-plugin-hash-output';

✗ import { HashOutput } from 'webpack-plugin-hash-output';

The default export is the constructor. Named import will not work. Use default import or require.

HashOutput

✓ new HashOutput({ validateOutput: true })

✗ new HashOutput().someMethod()

The plugin only has a constructor; no public methods. Configuration is via options object (optional).

Configures webpack to replace chunkhash with content-based MD5 hash, placed before HtmlWebpackPlugin.

Debug

Known issues

gotchaPlugin must be listed before other plugins like HtmlWebpackPlugin to correctly update asset references. Incorrect order will cause stale hashes in HTML.

fix

Place new HashOutput() before any plugin that uses asset filenames, e.g., HtmlWebpackPlugin.

affects: >=3.0.0

gotchaSourcemaps are only partially supported. The sourcemap filename is not updated; only the reference inside the chunk is changed, and the sourcemap's 'file' field is updated. This can cause sourcemap lookup failures.

fix

Avoid using devtool sourcemaps with this plugin if correct sourcemap filenames are critical.

affects: >=1.0.0

breakingVersion 3.0.0 dropped support for webpack <4. (Breaking change from v2 to v3).

fix

Upgrade to webpack >=4 or stay on v2 (which supports webpack 3).

affects: <3.0.0

deprecatedThe 'validateOutput' option is deprecated since v3.2.0 and may be removed in future releases.

fix

Remove { validateOutput: true } from options; the validation is now always on.

affects: >=3.2.0

gotchaWhen using multiple entry points, all chunk filenames are hashed. Ensure output.filename uses [chunkhash] or [contenthash].

fix

Set output.filename to include [chunkhash] (e.g., '[name].[chunkhash].js').

affects: >=1.0.0

Errors

Common errors & fixes

Module not found: Can't resolve 'webpack-plugin-hash-output'

Plugin not installed or not in node_modules.

fix

Run npm install webpack-plugin-hash-output --save-dev and ensure the path is correct in the webpack config.

TypeError: HashOutput is not a constructor

Using named import instead of default import, or incorrect require.

fix

Use const HashOutput = require('webpack-plugin-hash-output'); (no destructuring).

ValidationError: Invalid options object. Hash Output Plugin has been initialized using an options object that does not match the API schema.

Passing invalid options to the constructor (e.g., misspelled option).

fix

Check that options are valid: currently only optional 'validateOutput' (deprecated) exists.

The plugin 'webpack-plugin-hash-output' may conflict with other plugins. Please ensure it is the first plugin in the 'emit' phase.

Plugin detects other plugins registered before it that might interfere (e.g., HtmlWebpackPlugin).

fix

Move new HashOutput() to the top of the plugins array.

Upgrade

Version history

3.2.1latest on npm

Audit

Dependencies

webpackrequiredPeer dependency required for plugin functionality

Agent activity

16 hits · last 30 days

node

OpenAI (training)

Amazon

Resources

githubhttps://github.com/scinos/webpack-plugin-hash-output ↗

packagehttps://www.npmjs.com/package/webpack-plugin-hash-output ↗