javascript - 如何强制客户端刷新 JavaScript 文件？

Question

我们目前处于私人测试阶段，因此仍在进行相当快速的更改，尽管显然随着使用量开始增加，我们将放慢这一过程。话虽如此，我们遇到的一个问题是，在我们推出包含新 JavaScript 文件的更新后，客户端浏览器仍然使用该文件的缓存版本并且他们看不到更新。显然，在支持电话中，我们可以简单地通知他们进行ctrlF5刷新以确保他们从服务器获取最新文件，但最好在此之前处理此问题。

我们目前的想法是简单地将版本号附加到 JavaScript 文件的名称上，然后在进行更改时，增加脚本上的版本并更新所有引用。这绝对可以完成工作，但更新每个版本的引用可能会很麻烦。

因为我确信我们不是第一个处理这个问题的人，所以我想我会把它扔给社区。当您更新代码时，您如何确保客户端更新他们的缓存？如果您使用上述方法，您是否使用了简化更改的流程？

Answer 1

据我所知，一个常见的解决方案是?<version>在脚本的 src 链接中添加一个。

例如：

<script type="text/javascript" src="myfile.js?1500"></script>

---

我假设此时没有比 find-replace 更好的方法来增加所有脚本标签中的这些“版本号”？

你可能有一个版本控制系统为你做这件事？例如，大多数版本控制系统都有办法在签入时自动注入修订号。

它看起来像这样：

<script type="text/javascript" src="myfile.js?$$REVISION$$"></script>

---

当然，总有像这样更好的解决方案。

Answer 2

将当前时间附加到 URL 确实是一种常见的解决方案。但是，如果您愿意，您也可以在 Web 服务器级别进行管理。可以将服务器配置为为 javascript 文件发送不同的 HTTP 标头。

例如，要强制缓存文件不超过 1 天，您可以发送：

Cache-Control: max-age=86400, must-revalidate

对于测试版，如果您想强制用户始终获取最新版本，您可以使用：

Cache-Control: no-cache, must-revalidate

Answer 3

Google Page-Speed：不要在静态资源的 URL 中包含查询字符串。大多数代理，尤其是 3.0 版的 Squid，不缓存带有“？”的资源。即使响应中存在 Cache-control: public 标头，在他们的 URL 中也是如此。要为这些资源启用代理缓存，请从对静态资源的引用中删除查询字符串，并将参数编码为文件名本身。

在这种情况下，您可以将版本包含在 URL ex: http://abc.com/ v1.2 /script.js 中，并使用 apache mod_rewrite 将链接重定向到http://abc.com/script.js。当您更改版本时，客户端浏览器将更新新文件。

Answer 4

此用法已被弃用： https ://developer.mozilla.org/en-US/docs/Web/HTML/Using_the_application_cache

这个答案只晚了6年，但我在很多地方都没有看到这个答案...... HTML5引入了用于解决这个问题的Application Cache 。我发现我正在编写的新服务器代码正在使存储在人们浏览器中的旧 javascript 崩溃，所以我想找到一种方法来使他们的 javascript 过期。使用如下所示的清单文件：

CACHE MANIFEST
# Aug 14, 2014
/mycode.js

NETWORK:
*

并在每次您希望用户更新其缓存时生成带有新时间戳的文件。作为旁注，如果您添加它，浏览器将不会重新加载（即使用户刷新页面），直到清单告诉它。

Answer 5

如何将文件大小添加为加载参数？

<script type='text/javascript' src='path/to/file/mylibrary.js?filever=<?=filesize('path/to/file/mylibrary.js')?>'></script>

因此，每次更新文件时，“filever”参数都会更改。

当您更新文件并且您的更新导致相同的文件大小时怎么样？几率是多少？

Answer 6

并非所有浏览器都使用“？”缓存文件 在里面。我做了什么来确保它被尽可能多地缓存，我在文件名中包含了版本。

所以stuff.js?123我没有stuff_123.js

我在 apache 中使用mod_redirect（我认为）to have stuff_*.jsto gostuff.js

Answer 7

对于 ASP.NET 页面，我使用以下

前

<script src="/Scripts/pages/common.js" type="text/javascript"></script>

之后（强制重新加载）

<script src="/Scripts/pages/common.js?ver<%=DateTime.Now.Ticks.ToString()%>" type="text/javascript"></script>

添加 DateTime.Now.Ticks 效果很好。

Answer 8

现在的常见做法是生成内容哈希码作为文件名的一部分，以强制浏览器，尤其是 IE 重新加载 javascript 文件或 css 文件。

例如，

小贩。a7561fb0e9a071baadb9 .js
主要。b746e3eb72875af2caa9 .js

它通常是 webpack 等构建工具的工作。如果有人想尝试使用 webpack，这里有更多详细信息。

Answer 9

对于 ASP.NET，我想下一个具有高级选项（调试/发布模式、版本）的解决方案：

通过这种方式包含的 Js 或 Css 文件：

<script type="text/javascript" src="Scripts/exampleScript<%=Global.JsPostfix%>" />
<link rel="stylesheet" type="text/css" href="Css/exampleCss<%=Global.CssPostfix%>" />

Global.JsPostfix 和 Global.CssPostfix 在 Global.asax 中通过以下方式计算：

protected void Application_Start(object sender, EventArgs e)
{
    ...
    string jsVersion = ConfigurationManager.AppSettings["JsVersion"];
    bool updateEveryAppStart = Convert.ToBoolean(ConfigurationManager.AppSettings["UpdateJsEveryAppStart"]);
    int buildNumber = System.Reflection.Assembly.GetExecutingAssembly().GetName().Version.Revision;
    JsPostfix = "";
#if !DEBUG
    JsPostfix += ".min";
#endif      
    JsPostfix += ".js?" + jsVersion + "_" + buildNumber;
    if (updateEveryAppStart)
    {
        Random rand = new Random();
        JsPosfix += "_" + rand.Next();
    }
    ...
}

Answer 10

如果您正在生成链接到 JS 文件的页面，一个简单的解决方案是将文件的最后修改时间戳附加到生成的链接。

这与 Huppie 的答案非常相似，但可以在没有关键字替换的版本控制系统中使用。它也比附加当前时间要好，因为即使文件根本没有更改，这也会阻止缓存。

Answer 11

在PHP中：

function latest_version($file_name){
    echo $file_name."?".filemtime($_SERVER['DOCUMENT_ROOT'] .$file_name);
}

在HTML中：

<script type="text/javascript" src="<?php latest_version('/a-o/javascript/almanacka.js'); ?>">< /script>

这个怎么运作：

filepath在 HTML 中，按照您的意愿编写and 名称，但仅限于函数中。PHP 获取filetime文件并返回filepath+name+"?"+time最新更改的

Answer 12

我们一直在为用户创建一个 SaaS 并为他们提供一个脚本以附加在他们的网站页面中，并且无法附加带有脚本的版本，因为用户会将脚本附加到他们的网站以获得功能，我不能强迫他们每次更新脚本时更改版本

因此，我们找到了一种在每次用户调用原始脚本时加载新版本脚本的方法

提供给用户的脚本链接

<script src="https://thesaasdomain.com/somejsfile.js" data-ut="user_token"></script>

脚本文件

if($('script[src^="https://thesaasdomain.com/somejsfile.js?"]').length !== 0) {
   init();
} else {
   loadScript("https://thesaasdomain.com/somejsfile.js?" + guid());
}

var loadscript = function(scriptURL) {
   var head = document.getElementsByTagName('head')[0];
   var script = document.createElement('script');
   script.type = 'text/javascript';
   script.src = scriptURL;
   head.appendChild(script);
}

var guid = function() {
    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
        var r = Math.random() * 16 | 0, v = c == 'x' ? r : (r & 0x3 | 0x8);
        return v.toString(16);
    });
}

var init = function() {
    // our main code
}

解释：

用户在他们的网站上附加了提供给他们的脚本，我们使用 jQuery 选择器检查了脚本附带的唯一令牌是否存在，如果不存在，则使用更新的令牌（或版本）动态加载它

这是两次调用相同的脚本，这可能是一个性能问题，但它确实解决了强制脚本不从缓存中加载而不将版本放入给用户或客户端的实际脚本链接的问题

免责声明：如果性能对您来说是个大问题，请不要使用。

Answer 13

jQuery 函数 getScript 也可以用来确保每次页面加载时确实加载了一个 js 文件。

我是这样做的：

$(document).ready(function(){
    $.getScript("../data/playlist.js", function(data, textStatus, jqxhr){
         startProgram();
    });
});

在http://api.jquery.com/jQuery.getScript/检查函数

默认情况下，$.getScript() 将缓存设置为 false。这会将时间戳查询参数附加到请求 URL，以确保浏览器在每次请求时下载脚本。

Answer 14

我的同事刚刚在http://www.stefanhayden.com/blog/2006/04/03/css-caching-hack/上发布（参考 css）后找到了对该方法的引用。很高兴看到其他人正在使用它并且它似乎有效。我假设此时没有比 find-replace 更好的方法来增加所有脚本标签中的这些“版本号”？

Answer 15

在 asp.net mvc 中，您可以使用@DateTime.UtcNow.ToString()作为 js 文件版本号。版本号随日期自动更改，您强制客户端浏览器自动刷新 js 文件。我使用这种方法，效果很好。

<script src="~/JsFilePath/JsFile.js?v=@DateTime.UtcNow.ToString()"></script>

Answer 16

一种解决方案是在获取资源时将带有时间戳的查询字符串附加到 URL。这利用了浏览器不会缓存从带有查询字符串的 URL 获取的资源这一事实。

您可能根本不希望浏览器不缓存这些资源；您更有可能希望它们被缓存，但您希望浏览器在文件可用时获取文件的新版本。

最常见的解决方案似乎是在文件名本身中嵌入时间戳或修订号。这需要做更多的工作，因为您的代码需要修改以请求正确的文件，但这意味着，例如，您的snazzy_javascript_file.js(ie snazzy_javascript_file_7.js) 版本 7 会缓存在浏览器上，直到您发布版本 8，然后您的代码更改为取而代之snazzy_javascript_file_8.js。

Answer 17

使用 a file.js?V=1over a的优点fileV1.js是您不需要在服务器上存储多个版本的 JavaScript 文件。

我看到的问题file.js?V=1是，您可能在另一个 JavaScript 文件中有依赖代码，在使用新版本的库实用程序时会中断。

为了向后兼容，我认为最好使用jQuery.1.3.js新页面并让现有页面使用jQuery.1.1.js，直到您准备好升级旧页面（如有必要）。

Answer 18

使用版本GET变量来防止浏览器缓存。

附加?v=AUTO_INCREMENT_VERSION到 url 的末尾可以防止浏览器缓存 - 避免任何和所有缓存的脚本。

Answer 19

虽然它是特定于框架的，但 Django 1.4 具有静态文件应用程序功能，其工作方式与上述答案中的“greenfelt”站点类似

Answer 20

通过标签助手在 ASP.NET Core 中进行缓存清除将为您处理此问题，并允许您的浏览器保留缓存的脚本/css，直到文件更改。只需将标签助手 asp-append-version="true" 添加到您的脚本 (js) 或链接 (css) 标记中：

<link rel="stylesheet" href="~/css/site.min.css" asp-append-version="true"/>

Dave Paquette 有一个很好的例子和解释缓存破坏here（页面底部）缓存破坏

Answer 21

location.reload(true);

见https://www.w3schools.com/jsref/met_loc_reload.asp

我动态调用这行代码，以确保已从 Web 服务器而不是从浏览器的缓存中重新检索 javascript，以逃避此问题。

Answer 22

一种简单的方法。编辑 htaccess

RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_URI} \.(jpe?g|bmp|png|gif|css|js|mp3|ogg)$ [NC]
RewriteCond %{QUERY_STRING} !^(.+?&v33|)v=33[^&]*(?:&(.*)|)$ [NC]
RewriteRule ^ %{REQUEST_URI}?v=33 [R=301,L]

Answer 23

您可以将文件版本添加到文件名中，如下所示：

https://www.example.com/script_fv25.js

fv25 => 文件版本号。25

并在您的 .htaccess 中放置此块，该块将从链接中删除版本部分：

RewriteEngine On
RewriteRule (.*)_fv\d+\.(js|css|txt|jpe?g|png|svg|ico|gif) $1.$2 [L]

所以最后的链接是：

https://www.example.com/script.js

Answer 24

前端选项

我专门为那些无法更改后端任何设置的人编写了这段代码。在这种情况下，防止缓存过长的最佳方法是：

new Date().getTime()

然而，对于大多数程序员来说，缓存可能是几分钟或几小时，所以上面的简单代码最终会迫使所有用户下载“浏览的每个页面”。为了指定该项目在不重新加载的情况下保留多长时间，我编写了这段代码并在下面留下了几个示例：

// cache-expires-after.js v1
function cacheExpiresAfter(delay = 1, prefix = '', suffix = '') { // seconds
    let now = new Date().getTime().toString();
    now = now.substring(now.length - 11, 10); // remove decades and milliseconds
    now = parseInt(now / delay).toString();
    return prefix + now + suffix;
};

// examples (of the delay argument):
// the value changes every 1 second
var cache = cacheExpiresAfter(1);
// see the sync
setInterval(function(){
    console.log(cacheExpiresAfter(1), new Date().getSeconds() + 's');
}, 1000);

// the value changes every 1 minute
var cache = cacheExpiresAfter(60);
// see the sync
setInterval(function(){
    console.log(cacheExpiresAfter(60), new Date().getMinutes() + 'm:' + new Date().getSeconds() + 's');
}, 1000);

// the value changes every 5 minutes
var cache = cacheExpiresAfter(60 * 5); // OR 300

// the value changes every 1 hour
var cache = cacheExpiresAfter(60 * 60); // OR 3600

// the value changes every 3 hours
var cache = cacheExpiresAfter(60 * 60 * 3); // OR 10800

// the value changes every 1 day
var cache = cacheExpiresAfter(60 * 60 * 24); // OR 86400

// usage example:
let head = document.head || document.getElementsByTagName('head')[0];
let script = document.createElement('script');
script.setAttribute('src', '//unpkg.com/sweetalert@2.1.2/dist/sweetalert.min.js' + cacheExpiresAfter(60 * 5, '?'));
head.append(script);

// this works?
let waitSwal = setInterval(function() {
    if (window.swal) {
        clearInterval(waitSwal);
        swal('Script successfully injected', script.outerHTML);
    };
}, 100);

Answer 25

一个简单的技巧，对我来说可以很好地防止新旧 javascript 文件之间的冲突。这意味着：如果发生冲突并发生错误，将提示用户按 Ctrl-F5。

在页面顶部添加类似

<h1 id="welcome"> Welcome to this page <span style="color:red">... press Ctrl-F5</span></h1>

看起来像

让这行 javascript 成为加载页面时最后执行的代码：

document.getElementById("welcome").innerHTML = "Welcome to this page"

如果没有发生错误，上面的欢迎问候语将几乎不可见，几乎立即被替换为

Answer 26

如果您使用的是 PHP 和 Javascript，那么以下内容应该对您有用，尤其是在您对文件进行多次更改的情况下。因此，每次您都无法更改其版本。因此，想法是在 PHP 中创建一个随机数，然后将其分配为 JS 文件的一个版本。

$fileVersion = rand();
<script src="addNewStudent.js?v=<?php echo $fileVersion; ?>"></script>

Answer 27

最简单的解决方案？根本不要让浏览器缓存。附加当前时间（以毫秒为单位）作为查询。

（您仍处于测试阶段，因此您可以为不优化性能提出合理的理由。但这里是 YMMV。）

Answer 28

下面为我​​工作：

<head>
<meta charset="UTF-8">
<meta http-equiv="cache-control" content="no-cache, must-revalidate, post-check=0, pre-check=0" />
<meta http-equiv="cache-control" content="max-age=0" />
<meta http-equiv="expires" content="0" />
<meta http-equiv="expires" content="Tue, 01 Jan 1980 1:00:00 GMT" />
<meta http-equiv="pragma" content="no-cache" />
</head>