Registry / web-framework / base-href-webpack-plugin

base-href-webpack-plugin

library3.0.1jsnpmunverified

Webpack plugin (v3.0.1, stable) that extends html-webpack-plugin to programmatically insert or update the <base href="" /> tag in the HTML head. Active release with support for Webpack 5 (v3.x), Webpack 4 (v2.x), and Webpack 3 (v1.x). Key differentiators: automatic base href injection without manual template editing; leaves template untouched if option omitted; ships TypeScript types. Alternatives typically require manual HTML template modification.

web-framework

npm install base-href-webpack-plugin

github ↗package ↗

INSTALL

IMPORT

SIG · BASE-HREF-WEBPACK-

base-href-webpack-plugin

web-frameworkjavascriptv3.0.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.

BaseHrefWebpackPlugin

✓ const { BaseHrefWebpackPlugin } = require('base-href-webpack-plugin');

✗ const BaseHrefWebpackPlugin = require('base-href-webpack-plugin');

Named export, not default. CommonJS require style. For ESM: import { BaseHrefWebpackPlugin } from 'base-href-webpack-plugin';

BaseHrefWebpackPlugin (default)

✓ import BaseHrefWebpackPlugin from 'base-href-webpack-plugin';

✗ import { BaseHrefWebpackPlugin } from 'base-href-webpack-plugin';

Plugin also has a default export. Named import is recommended for clarity.

BaseHrefWebpackPluginConfig

✓ type BaseHrefWebpackPluginConfig = { baseHref: string }

TypeScript type for options object. Exported from package.

Shows how to add BaseHrefWebpackPlugin to webpack config, requiring both html-webpack-plugin and the plugin itself.

// webpack.config.js const HtmlWebpackPlugin = require('html-webpack-plugin'); const { BaseHrefWebpackPlugin } = require('base-href-webpack-plugin'); module.exports = { plugins: [ new HtmlWebpackPlugin(), new BaseHrefWebpackPlugin({ baseHref: '/' }) ] };

Debug

Known issues

breakingVersion 3.x requires Webpack 5 and html-webpack-plugin ^4.0.0

fix

Upgrade webpack to ^5.0.0 and html-webpack-plugin to ^4.0.0

affects: >=3.0.0

breakingVersion 2.x requires Webpack 4

fix

Use v3.x for Webpack 5 or stay on v2.x for Webpack 4

affects: >=2.0.0 <3.0.0

gotchaIf baseHref option is not provided, the plugin silently does nothing - does not warn

fix

Always provide baseHref option to ensure the tag is inserted

affects: >=1.0.0

Errors

Common errors & fixes

TypeError: Cannot destructure property 'BaseHrefWebpackPlugin' of 'require(...)' as it is undefined.

Using default import or require incorrectly.

fix

Use const { BaseHrefWebpackPlugin } = require('base-href-webpack-plugin'); (named import)

Error: Cannot find module 'html-webpack-plugin'

html-webpack-plugin is a peer dependency and not installed.

fix

Run npm install --save-dev html-webpack-plugin

Error: webpack.version is not defined - plugin requires webpack 5

Using plugin v3 with Webpack 4 or earlier.

fix

Use v2.x for Webpack 4 or upgrade to Webpack 5

Upgrade

Version history

3.0.1latest on npm

Audit

Dependencies

html-webpack-pluginrequiredpeer dependency: plugin requires html-webpack-plugin to operate

webpackrequiredpeer dependency: plugin is a webpack plugin

Agent activity

11 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/dzonatan/base-href-webpack-plugin ↗

packagehttps://www.npmjs.com/package/base-href-webpack-plugin ↗