纯前端实现：检测部署更新并提示用户刷新网页

作者：编译时光时间：2026-10-26 09:22:17浏览：212

本文介绍了一种纯前端方案，用于在重新部署网页后自动通知用户刷新。通过轮询打包生成的脚本Hash值变化，无需后端配合即可实现版本更新检测。文章提供了基于轮询机制的Updater类代码示例及测试步骤，帮助开发者提升用户体验，确保用户及时获取新功能。

1.目标场景

应用上线后，用户可能仍停留在旧页面，且不清楚网页已重新部署。在跳转页面时，若JavaScript连接的Hash发生变化，可能导致报错无法跳转，同时用户也无法体验到新功能。

2.思考解决方案

针对上述问题，我们开始思考解决思路。

若后端能配合，我们可以利用webSocket与后端进行实时通讯。前端部署完成后，后端发送通知，前端检测到Message后进行提示。此外，还可以优化使用EvnentSource，它与socket类似，但仅支持后端向前端推送消息，前端无需发送消息，这符合我们的需求。

上述方案需要后端配合，但由于公司后端资源紧张，我们需要寻找纯前端的实现方式。

重新进行思考...

经过与团队讨论，我们得出一个方案：在项目根目录放置一个JSON文件，写入固定的key值，在打包时修改该值，然后在代码中通过轮询判断是否有变化，若有变化则提示用户。

1.目标场景

这确实是康老师经典不知道。

1.目标场景

然而，实现后发现过于繁琐，需要手动配置JSON文件并在打包时修改。我们继续寻找更简单的方案，进入第二轮讨论。

第二轮讨论的方案是利用打包后生成的script src的hash值进行判断。每次打包都会生成唯一的hash值，只要通过轮询判断其发生变化，即可确定已重新部署。

1.目标场景

3.代码实现

interface Options {
    timer?: number
}
export class Updater {
    oldScript: string[] //存储第一次值也就是script 的hash 信息
    newScript: string[] //获取新的值 也就是新的script 的hash信息
    dispatch: Record<string, Function[]> //小型发布订阅通知用户更新了
    constructor(options: Options) {
        this.oldScript = [];
        this.newScript = []
        this.dispatch = {}
        this.init() //初始化
        this.timing(options?.timer)//轮询
    }
    async init() {
        const html: string = await this.getHtml()
        this.oldScript = this.parserScript(html)
    }
    async getHtml() {
        const html = await fetch('/').then(res => res.text());//读取index html
        return html
    }
    parserScript(html: string) {
        const reg = new RegExp(/<script(?:\s+[^>]*)?>(.*?)<\/script\s*>/ig) //script正则
        return html.match(reg) as string[] //匹配script标签
    }
    //发布订阅通知
    on(key: 'no-update' | 'update', fn: Function) {
        (this.dispatch[key] || (this.dispatch[key] = [])).push(fn)  
        return this;
    }
    compare(oldArr: string[], newArr: string[]) {
        const base = oldArr.length
        const arr = Array.from(new Set(oldArr.concat(newArr)))
        //如果新旧length 一样无更新
        if (arr.length === base) {
            this.dispatch['no-update'].forEach(fn => {
                fn()
            })
        } else {
            //否则通知更新
            this.dispatch['update'].forEach(fn => {
                fn()
            })
        }
    }
    timing(time = 10000) {
         //轮询
        setInterval(async () => {
            const newHtml = await this.getHtml()
            this.newScript = this.parserScript(newHtml)
            this.compare(this.oldScript, this.newScript)
        }, time)
    }
}

代码用法

//实例化该类
const up = new Updater({
    timer:2000
})
//未更新通知
up.on('no-update',()=>{
   console.log('未更新')
})
//更新通知
up.on('update',()=>{
    console.log('更新了')
})