vue-version-watcher v1.2

自动检测 Web 系统版本更新（基于 ETag + 静态资源错误 + History API），支持 Vue 或纯原生项目。

🚀 特性

• 无需依赖 Vue Router
• 自动监听 pushState / replaceState / popstate
• 同源静态资源错误检测（防止误报）
• ETag 二次确认（防止网络抖动误报）
• 自动使用 Element Plus 弹窗 / 原生 confirm

📦 安装

npm install vue-version-watcher
# 或
pnpm add vue-version-watcher

💡 使用

import { createApp } from 'vue';
import VueVersionWatcher from 'vue-version-watcher';

const app = createApp(App);

app.use(VueVersionWatcher, {
  checkInterval: 30000,
  silent: false,
  onUpdateDetected: () => {
    console.log('自定义更新逻辑');
  }
});

export interface VersionWatcherOptions {
  /** 检测开关，默认 true */
  enabled?: boolean;
  /** 检测间隔（毫秒），默认 0 不开启定时监测 */
  checkInterval?: number;
  /** 自定义检测路径，默认当前域名根路径 */
  checkPath?: string;
  /** 静默模式，不输出日志 */
  silent?: boolean;
  /** 自定义更新提示函数 */
  onUpdateDetected?: () => void;
  /** 忽略的路径模式（正则表达式） */
  ignorePaths?: RegExp;
}

🧠 原理

1. 通过 HEAD 请求检测 ETag 或 Last-Modified 变化；
2. 捕获同源 JS/CSS 静态资源错误；
3. 自动弹窗提示刷新。

🪪 License

MIT