vite-plugin-build-version-file 0.1.15 → 0.1.16

package/README.md

@@ -387,10 +387,18 @@ checkVersion()
 ```ts
 import { clearUrlCache } from 'vite-plugin-build-version-file/client'
 
-await clearUrlCache('/vue-app/')
+await clearUrlCache({
+  urls: ['/vue-app/', '/vue-app/index.html'],
+  redirectUrl: '/vue-app/'
+})
 ```
 
-`url` 可省略；省略时默认使用 `location.origin + location.pathname`，不包含当前 query/hash：
+参数对象可省略。无参时按顺序检测以下两组 URL：
+
+1. `location.origin + location.pathname`
+2. 第一组 URL 拼接 `index.html`
+
+两组完成后，默认携带随机时间戳跳转到第一组 URL：
 
 ```ts
 await clearUrlCache()
@@ -853,10 +861,18 @@ Recommendations:
 ```ts
 import { clearUrlCache } from 'vite-plugin-build-version-file/client'
 
-await clearUrlCache('/vue-app/')
+await clearUrlCache({
+  urls: ['/vue-app/', '/vue-app/index.html'],
+  redirectUrl: '/vue-app/'
+})
 ```
 
-The `url` argument is optional. When omitted, `location.origin + location.pathname` is used without the current query/hash:
+The options object is optional. Without arguments, the following URL groups are checked in order:
+
+1. `location.origin + location.pathname`
+2. The first URL with `index.html` appended
+
+After both groups complete, the method navigates to the first URL with a random timestamp:
 
 ```ts
 await clearUrlCache()

package/dist/client.cjs

@@ -37,6 +37,14 @@ function createCacheBustedUrl(url) {
   targetUrl.hash = hash;
   return targetUrl.href;
 }
+function createIndexUrl(url) {
+  const targetUrl = new URL(url);
+  if (!targetUrl.pathname.endsWith("/")) {
+    targetUrl.pathname += "/";
+  }
+  targetUrl.pathname += "index.html";
+  return targetUrl.href;
+}
 function loadIframe(url) {
   return new Promise((resolve) => {
     document.getElementById(IFRAME_ID)?.remove();
@@ -59,7 +67,7 @@ function loadIframe(url) {
     document.documentElement.appendChild(iframe);
   });
 }
-async function clearUrlCache(url = window.location.origin + window.location.pathname) {
+async function clearTargetUrlCache(url) {
   const targetUrl = new URL(url, window.location.href).href;
   console.info(`[vite-plugin-build-version] Clear cache for ${targetUrl}`);
   await Promise.allSettled([
@@ -70,10 +78,24 @@ async function clearUrlCache(url = window.location.origin + window.location.path
       (response) => response.arrayBuffer()
     )
   ]);
+  await loadIframe(createCacheBustedUrl(targetUrl));
+}
+async function clearUrlCache(options = {}) {
+  const defaultUrl = window.location.origin + window.location.pathname;
+  const urls = options.urls ?? [defaultUrl, createIndexUrl(defaultUrl)];
+  const redirectUrl = new URL(
+    options.redirectUrl ?? urls[0] ?? defaultUrl,
+    window.location.href
+  ).href;
   try {
-    await loadIframe(createCacheBustedUrl(targetUrl));
+    for (const url of urls) {
+      try {
+        await clearTargetUrlCache(url);
+      } catch {
+      }
+    }
   } finally {
-    window.location.replace(createCacheBustedUrl(targetUrl));
+    window.location.replace(createCacheBustedUrl(redirectUrl));
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/client.d.cts

@@ -1,3 +1,7 @@
-declare function clearUrlCache(url?: string): Promise<void>;
+interface ClearUrlCacheOptions {
+    urls?: string[];
+    redirectUrl?: string;
+}
+declare function clearUrlCache(options?: ClearUrlCacheOptions): Promise<void>;
 
-export { clearUrlCache };
+export { type ClearUrlCacheOptions, clearUrlCache };

package/dist/client.d.ts

@@ -1,3 +1,7 @@
-declare function clearUrlCache(url?: string): Promise<void>;
+interface ClearUrlCacheOptions {
+    urls?: string[];
+    redirectUrl?: string;
+}
+declare function clearUrlCache(options?: ClearUrlCacheOptions): Promise<void>;
 
-export { clearUrlCache };
+export { type ClearUrlCacheOptions, clearUrlCache };

package/dist/client.mjs

@@ -13,6 +13,14 @@ function createCacheBustedUrl(url) {
   targetUrl.hash = hash;
   return targetUrl.href;
 }
+function createIndexUrl(url) {
+  const targetUrl = new URL(url);
+  if (!targetUrl.pathname.endsWith("/")) {
+    targetUrl.pathname += "/";
+  }
+  targetUrl.pathname += "index.html";
+  return targetUrl.href;
+}
 function loadIframe(url) {
   return new Promise((resolve) => {
     document.getElementById(IFRAME_ID)?.remove();
@@ -35,7 +43,7 @@ function loadIframe(url) {
     document.documentElement.appendChild(iframe);
   });
 }
-async function clearUrlCache(url = window.location.origin + window.location.pathname) {
+async function clearTargetUrlCache(url) {
   const targetUrl = new URL(url, window.location.href).href;
   console.info(`[vite-plugin-build-version] Clear cache for ${targetUrl}`);
   await Promise.allSettled([
@@ -46,10 +54,24 @@ async function clearUrlCache(url = window.location.origin + window.location.path
       (response) => response.arrayBuffer()
     )
   ]);
+  await loadIframe(createCacheBustedUrl(targetUrl));
+}
+async function clearUrlCache(options = {}) {
+  const defaultUrl = window.location.origin + window.location.pathname;
+  const urls = options.urls ?? [defaultUrl, createIndexUrl(defaultUrl)];
+  const redirectUrl = new URL(
+    options.redirectUrl ?? urls[0] ?? defaultUrl,
+    window.location.href
+  ).href;
   try {
-    await loadIframe(createCacheBustedUrl(targetUrl));
+    for (const url of urls) {
+      try {
+        await clearTargetUrlCache(url);
+      } catch {
+      }
+    }
   } finally {
-    window.location.replace(createCacheBustedUrl(targetUrl));
+    window.location.replace(createCacheBustedUrl(redirectUrl));
   }
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-build-version-file",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "A Vite plugin that emits version.json and injects version metadata into HTML.",
   "license": "MIT",
   "type": "module",