编程 如何在单页应用(SPA)中实现版本更新检测机制

2024-11-18 21:33:53 +0800 CST views 657

纯前端怎么实现检测版本更新,请看这篇!


单页应用(Single Page Application,简称SPA)是一种现代Web应用程序架构,通过动态重载页面中的部分内容来提供更流畅和更响应式的用户体验。由于SPA在客户端(用户的浏览器)运行大量的JavaScript代码,并且与传统的多页应用不同,它不会每次操作都从服务器重新加载整个页面内容,因此在性能和用户体验上有显著优势。然而,这种应用也存在一定弊端。譬如,当服务端更新时(接口请求体和响应体结构发生变化),用户所使用的网页静态资源没有同步更新,可能导致报错。


前言

在传统的多页Web应用中,每次用户访问页面时,都会从服务器获取最新的页面和资源,因此版本更新相对简单,用户总是能获取到最新的版本。然而,SPA在首次加载后,前端的静态资源会缓存在浏览器内存中,并且在整个使用过程中通常不会自动重新加载。这种特性意味着如果应用有新的版本发布,用户可能仍在使用旧版本,无法立即获得最新的功能、修复或安全更新。


怎么实现?

我们想实现这样一个效果,场景是:

当工程师发版完成后,客户端检测到有版本更新,给用户一个更新提示,让用户知道有新版本发布。

先来实现这个弹窗:

import { Modal } from 'antd';

function updateNotice() {
    Modal.confirm({
        title: '更新提示',
        content: '检测到新版本,建议立即更新以确保平台正常使用。',
        okText: '确认更新',
        cancelText: '稍后更新',
        onOk: () => {
            window.location.reload();
        },
    });
}

方案一:比较构建文件的hash值

此方案需要webpack开启打包文件带上hash值,具体配置不在此处展开。

通过定期获取服务器的前端资源,匹配资源中的 <script> 标签,对比前后标签是否一致,来检测是否有新的版本发布。

// 存储当前脚本标签的哈希值集合
let scriptHashes = new Set();
let timer = undefined;

/**
 * 从首页获取脚本标签的哈希值集合
 * @returns {Promise<Set<string>>} 返回包含脚本标签的哈希值的集合
 */
async function fetchScriptHashes() {
    // 获取首页HTML内容
    const html = await fetch('/').then((res) => res.text());
    // 正则表达式匹配所有<script>标签
    const scriptRegex = /<script(?:\s+[^>]*)?>(.*?)<\/script\s*>/gi;
    // 获取匹配到的所有<script>标签内容
    const scripts = html.match(scriptRegex) ?? [];
    // 将脚本标签内容存入集合并返回
    return new Set(scripts);
}

/**
 * 比较当前脚本标签的哈希值集合与新获取的集合,检测是否有更新
 */
async function compareScriptHashes() {
    // 获取新的脚本标签哈希值集合
    const newScriptHashes = await fetchScriptHashes();

    if (scriptHashes.size === 0) {
        // 初次运行时,存储当前脚本标签哈希值
        scriptHashes = newScriptHashes;
    } else if (
        scriptHashes.size !== newScriptHashes.size ||
        ![...scriptHashes].every((hash) => newScriptHashes.has(hash))
    ) {
        // 如果脚本标签数量或内容发生变化,则认为有更新
        console.info('更新了', {
            oldScript: [...scriptHashes],
            newScript: [...newScriptHashes],
        });
        // 清除定时器
        clearInterval(timer);
        // 提示用户更新
        updateNotice();
    } else {
        // 没有更新
        console.info('没更新', {
            oldScript: [...scriptHashes],
        });
    }
}

// 每60秒检查一次是否有新的脚本标签更新
timer = setInterval(compareScriptHashes, 60000);

方案二:利用HTTP协议的缓存机制,比较Etag或last-modified前后是否一致

本方案与方案一类似,但更直接地利用了 HTTP 协议提供的缓存控制机制,以确定页面是否发生了变化。

let versionTag = null; // 版本标识
let timer = undefined;

/**
 * 获取首页的 ETag 或 Last-Modified 值,作为当前版本标识
 * @returns {Promise<string|null>} 返回 ETag 或 Last-Modified 值
 */
const getVersionTag = async () => {
    const response = await fetch('/', {
        cache: 'no-cache',
    });
    return response.headers.get('etag') || response.headers.get('last-modified');
};

/**
 * 比较当前的 ETag 或 Last-Modified 值与最新获取的值
 */
const compareTag = async () => {
    const newVersionTag = await getVersionTag();

    if (versionTag === null) {
        // 初次运行时,存储当前的 ETag 或 Last-Modified 值
        versionTag = newVersionTag;
    } else if (versionTag !== newVersionTag) {
        // 如果 ETag 或 Last-Modified 发生变化,则认为有更新
        console.info('更新了', {
            oldVersionTag: versionTag,
            newVersionTag: newVersionTag,
        });
        // 清除定时器
        clearInterval(timer);
        // 提示用户更新
        updateNotice();
    } else {
        // 没有更新
        console.info('没更新', {
            oldVersionTag: versionTag,
            newVersionTag: newVersionTag,
        });
    }
};

// 每60秒检查一次是否有新的 ETag 或 Last-Modified 值
timer = setInterval(compareTag, 60000);

总结

为了确保用户始终使用最新的版本并体验到最佳的功能和安全性,SPA应用需要实现版本检测和更新提示机制。当应用有新版本发布时,可以提示用户刷新页面或自动重新加载,以确保用户获取到最新的应用代码和资源。

推荐文章

PHP 允许跨域的终极解决办法
2024-11-19 08:12:52 +0800 CST
使用Python提取图片中的GPS信息
2024-11-18 13:46:22 +0800 CST
Golang Sync.Once 使用与原理
2024-11-17 03:53:42 +0800 CST
如何将TypeScript与Vue3结合使用
2024-11-19 01:47:20 +0800 CST
Go 协程上下文切换的代价
2024-11-19 09:32:28 +0800 CST
Linux 常用进程命令介绍
2024-11-19 05:06:44 +0800 CST
Golang在整洁架构中优雅使用事务
2024-11-18 19:26:04 +0800 CST
LangChain快速上手
2025-03-09 22:30:10 +0800 CST
gin整合go-assets进行打包模版文件
2024-11-18 09:48:51 +0800 CST
Web浏览器的定时器问题思考
2024-11-18 22:19:55 +0800 CST
JS 箭头函数
2024-11-17 19:09:58 +0800 CST
淘宝npm镜像使用方法
2024-11-18 23:50:48 +0800 CST
Vue3的虚拟DOM是如何提高性能的?
2024-11-18 22:12:20 +0800 CST
IP地址获取函数
2024-11-19 00:03:29 +0800 CST
php机器学习神经网络库
2024-11-19 09:03:47 +0800 CST
Vue3 组件间通信的多种方式
2024-11-19 02:57:47 +0800 CST
PHP服务器直传阿里云OSS
2024-11-18 19:04:44 +0800 CST
CSS 媒体查询
2024-11-18 13:42:46 +0800 CST
对多个数组或多维数组进行排序
2024-11-17 05:10:28 +0800 CST
程序员茄子在线接单