@modern-js/main-doc 0.0.0-nightly-20240228170648 → 0.0.0-nightly-20240301170734

package/docs/en/guides/advanced-features/ssr/cache.mdx

@@ -184,3 +184,29 @@ export const cacheOption: CacheOption = {
   staleWhileRevalidate: 1000, // ms
 };
 ```
+
+## Cache Identification
+
+When the rendering cache is activated, Modern.js will identify the cache status of the current request through the response header `x-render-cache`.
+
+The following is an example of a response.
+
+```bash
+< HTTP/1.1 200 OK
+< Access-Control-Allow-Origin: *
+< content-type: text/html; charset=utf-8
+< x-render-cache: hit
+< Date: Thu, 29 Feb 2024 02:46:49 GMT
+< Connection: keep-alive
+< Keep-Alive: timeout=5
+< Content-Length: 2937
+```
+
+The `x-render-cache` may have the following values.
+
+| Name    | Description                                                                |
+| ------- | -------------------------------------------------------------------------- |
+| hit     | Cache hit, returns cached content                                          |
+| stale   | Cache hit, but data is stale, returns cached content while rendering again |
+| expired | Cache hit, returns rendering result after re-rendering                     |
+| miss    | Cache miss                                                                 |

package/docs/zh/guides/advanced-features/ssr/cache.mdx

@@ -187,3 +187,29 @@ export const cacheOption: CacheOption = {
   staleWhileRevalidate: 1000, // ms
 };
 ```
+
+## 缓存标识
+
+当开启渲染缓存后，Modern.js 将通过响应头 `x-render-cache` 来标识当前请求的缓存状态。
+
+下列是一个响应示例
+
+```bash
+< HTTP/1.1 200 OK
+< Access-Control-Allow-Origin: *
+< content-type: text/html; charset=utf-8
+< x-render-cache: hit
+< Date: Thu, 29 Feb 2024 02:46:49 GMT
+< Connection: keep-alive
+< Keep-Alive: timeout=5
+< Content-Length: 2937
+```
+
+`x-render-cache` 可能会有以下几种值
+
+| 名称    | 说明                                               |
+| ------- | -------------------------------------------------- |
+| hit     | 缓存命中，返回缓存内容                             |
+| stale   | 缓存命中，但数据陈旧，返回缓存内容的同时做重新渲染 |
+| expired | 缓存命中，重新渲染后返回渲染结果                   |
+| miss    | 缓存未命中                                         |

package/package.json

@@ -15,17 +15,17 @@
     "modern",
     "modern.js"
   ],
-  "version": "0.0.0-nightly-20240228170648",
+  "version": "0.0.0-nightly-20240301170734",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public",
     "provenance": true
   },
   "dependencies": {
-    "@modern-js/sandpack-react": "0.0.0-nightly-20240228170648"
+    "@modern-js/sandpack-react": "0.0.0-nightly-20240301170734"
   },
   "peerDependencies": {
-    "@modern-js/builder-doc": "0.0.0-nightly-20240228170648"
+    "@modern-js/builder-doc": "0.0.0-nightly-20240301170734"
   },
   "devDependencies": {
     "classnames": "^2",
@@ -35,12 +35,12 @@
     "ts-node": "^10.9.1",
     "typescript": "^5",
     "fs-extra": "^10",
-    "rspress": "1.12.3",
-    "@rspress/shared": "1.12.3",
+    "rspress": "1.13.0",
+    "@rspress/shared": "1.13.0",
     "@types/node": "^16",
     "@types/fs-extra": "9.0.13",
-    "@modern-js/builder-doc": "0.0.0-nightly-20240228170648",
-    "@modern-js/doc-plugin-auto-sidebar": "0.0.0-nightly-20240228170648"
+    "@modern-js/builder-doc": "0.0.0-nightly-20240301170734",
+    "@modern-js/doc-plugin-auto-sidebar": "0.0.0-nightly-20240301170734"
   },
   "scripts": {
     "dev": "rspress dev",