# Web 中的缓存行为

> Customize the Web cache behavior.

在 Unity Web 平台中，缓存 API 允许您将缓存在 `.data` 文件和 [AssetBundle](/engine/6000.0/manual/working-in-unity/assets-and-media/asset-workflow/asset-bundles-intro.md) 中的资产数据存储在浏览器缓存中。浏览器缓存的存储限制（例如最大文件大小、最大整体缓存大小和驱逐条件）取决于您使用的浏览器和平台。有关更多信息，请参阅[浏览器存储限制和驱逐条件](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API/Browser_storage_limits_and_eviction_criteria)。

## 数据缓存##data-caching

要访问**数据缓存**，请从**文件 (File)** > **构建设置 (Build Settings)** > **播放器设置 (Player Settings)** 中打开 Web 的**发布设置 (Publishing Settings)**。这样，浏览器会将主数据文件缓存到 IndexedDB 数据库中。

使用默认浏览器 HTTP 缓存并不能保证浏览器缓存特定响应。这是因为浏览器 HTTP 缓存空间有限，浏览器可能无法缓存过大的文件。

为了提高加载速度，`IndexedDB` 允许您缓存超过浏览器限制的文件。当你缓存更多的文件时，就增加了在下一次运行该构建版本时，已下载的内容在用户机器上可用的几率。

数据缓存仅为 HTTP 响应缓存 IndexedDB 缓存中的 `.data` 文件。要缓存 [AssetBundle](/engine/6000.0/manual/working-in-unity/assets-and-media/asset-workflow/asset-bundles-intro.md)，需要启用数据缓存并覆盖 `unityInstance.Module.cacheControl()`。为此，请确保 `Module.cacheControl(url)` 返回所请求的 AssetBundle URL 的 `must-revalidate`。例如，可以在 `createUnityInstance()` 返回的 Promise 的实现回调中覆盖 `unityInstance.Module.cacheControl()` 函数。有关 `createUnityInstance()` 的更多信息，请参阅[压缩构建和服务器配置](/engine/6000.0/manual/platform-specific/webgl/building-distribution/deploying.md)。

## 自定义 Web 缓存行为##customize-web-cache-behavior

默认情况下，Web 缓存会存储资产数据文件 `.data` 和 AssetBundle 文件 `.bundle`，并在从缓存加载它们之前重新验证它们。您可以通过添加新的[ Web 模板](/engine/6000.0/manual/platform-specific/webgl/building-distribution/templates.md)来更改 UnityLoader 配置来更改此行为。

以下示例显示了向 `index.html` 文件中的 UnityLoader 配置添加自定义 cacheControl 函数的情况。

```
var config = {
   // ...
#if USE_DATA_CACHING
   cacheControl: function (url) {
     // Caching enabled for .data and .bundle files.
     // Revalidate if file is up to date before loading from cache
     if (url.match(/\.data/) || url.match(/\.bundle/)) {
         return "must-revalidate";
     }

     // Caching enabled for .mp4 and .custom files
     // Load file from cache without revalidation.
     if (url.match(/\.mp4/) || url.match(/\.custom/)) {
         return "immutable";
     }

     // Disable explicit caching for all other files.
     // Note: the default browser cache may cache them anyway.
     return "no-store";
   },
#endif
   // ...
}
```

`cacheControl` 函数将请求的 URL 作为参数并返回以下之一：

* `must-revalidate` - 如果函数返回 [must-revalidate](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control#must-revalidate)，则缓存会返回到启用状态，并在从缓存加载文件之前重新验证文件。

* `immutable` - 如果函数返回 [immutable](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control#immutable)，则启用缓存并从缓存加载文件，无需重新验证。

* `no-store` - 如果该函数返回 [no-store](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control#no-store)，则禁用缓存。

浏览器会自动存储（缓存）某些文件类型，例如 .html、.js、.css、.json、.jpg、.png，因此它们不需要显式存储在 Web 缓存中。Web 缓存的典型候选对象包括大型文件和使用自定义文件格式的文件。