npmpackage.info

Gathering detailed insights and metrics for unplugin-version-injector

Gathering detailed insights and metrics for unplugin-version-injector

unplugin-version-injector - 2.1.1 | npmpackage.info

unplugin-version-injector

unplugin-version-injector is a powerful and lightweight plugin that automatically injects the version number and build timestamp into all HTML files. It supports Webpack 4/5, Vite, and Rollup, making it ideal for both Single Page Applications (SPA) and Multi-Page Applications (MPA).

2.1.1

16

TypeScript

220.12 kB

Installations

npm install unplugin-version-injector

Developer Guide

BETA

Typescript

No

Module System

ESM

Node Version

20.18.1

NPM Version

10.8.2

Pull Requests

Open

0

Total

1

Closed

0

Merged

1

Issues

Open

0

Total

0

Closed

0

Releases

5

v2.1.1

Updated on Jun 06, 2025

v2.1.0

Updated on Jun 04, 2025

v2.0.0

Updated on Apr 18, 2025

v2.0.0-beta.1

Updated on Apr 18, 2025

v1.0.3

Updated on Mar 06, 2025

View All 5 releases

Languages

1

TypeScript

TypeScript (100%)

Developer

nianyi778

Download Statistics

Total Downloads

0

Last Day

0

Last Week

0

Last Month

0

Last Year

0

GitHub Statistics

16 Stars

20 Commits

2 Forks

1 Watchers

1 Branches

2 Contributors

Updated on Jun 09, 2025

Maintainers

1

View All 2 Contributors

Package Meta Information

Latest Version

2.1.1

Package Id

unplugin-version-injector@2.1.1

Unpacked Size

220.12 kB

Size

33.41 kB

File Count

15

NPM Version

10.8.2

Node Version

20.18.1

Published on

Jun 05, 2025

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

0%

NaN

Compared to previous day

Last Week

0%

NaN

Compared to previous week

Last Month

0%

NaN

Compared to previous month

Last Year

0%

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dev Dependencies

7

@types/node tsup rollup typescript vite webpack webpack-sources

🚀 `unplugin-version-injector` - 自动注入版本号与构建时间

🇬🇧 English README | 🇨🇳 中文文档

📌 插件简介

unplugin-version-injector 是一个轻量级插件，可在构建时自动向所有 HTML 文件注入 版本号、构建时间戳 和 项目名。支持 Webpack 4/5、Vite 和 Rollup，适用于 SPA / MPA 项目。

✨ 功能亮点

✅ 自动注入 <meta name="version"> 和 <meta name="project"> 到 HTML <head>
✅ 自动注入 <script>，控制台输出 项目名、版本号 和 构建时间
✅ 支持 Webpack 4 / 5、Vite、Rollup
✅ 完美兼容多页面应用（MPA）
✅ 支持自定义版本号、项目名、时间格式，默认读取 package.json
✅ 控制台输出支持自动适配深/浅主题配色

📦 安装

1# 使用 yarn
2yarn add -D unplugin-version-injector
3
4# 使用 npm
5npm install -D unplugin-version-injector

🚀 使用方法

📌 Vite

vite.config.ts 中配置：

1import versionInjector from 'unplugin-version-injector/vite';
2
3export default {
4  plugins: [versionInjector()],
5};

📌 Webpack 4/5

webpack.config.js 中配置：

1const versionInjector = require('unplugin-version-injector/webpack');
2
3module.exports = {
4  plugins: [
5    versionInjector({
6      version: '1.2.3', // 可选，自定义版本号
7      name: 'MyApp'     // 可选，自定义项目名
8    }),
9  ],
10};

📌 Rollup

rollup.config.js 中配置：

1import versionInjector from 'unplugin-version-injector/rollup';
2
3export default {
4  plugins: [versionInjector()],
5};

🧪 示例输出

构建后的 HTML 文件中将自动注入：

1<head>
2  <meta name="version" content="1.2.3">
3  <meta name="project" content="MyApp">
4</head>
5<body>
6  ...
7  <script data-injected="unplugin-version-injector">
8    console.log(...);
9  </script>
10</body>

控制台输出（根据主题自适应配色）：

🟦 Project: MyApp
🟢 Version: 1.2.3
🟡 Build Time: 2024-06-04T12:00:00.000Z

🔧 配置项说明

选项	类型	说明	默认值
`version`	`string`	自定义版本号	自动读取 package.json
`name`	`string`	自定义项目名	自动读取 package.json
`log`	`boolean`	是否输出控制台日志	`true`
`formatDate`	`Date => string`	自定义时间格式函数	ISO 格式

🎨 控制台配色自动适配说明

插件自动判断浏览器是否为暗色模式（window.matchMedia('(prefers-color-scheme: dark')）；
深色模式下将使用亮色字体以确保可读性；
你也可以重写 <script> 注入逻辑以自定义样式。

📜 开源许可

MIT License © 2024 Nian YI

🔥 unplugin-version-injector —— 最轻巧的版本信息注入解决方案！

Empty State

No vulnerabilities found.

Empty State

No security vulnerabilities found.