feat: throw error when maximumFileSizeToCacheInBytes found in sw build warnings (#747)

* feat: throw error when `maximumFileSizeToCacheInBytes` found in sw build warnings

* chore: update error format

Author: userquin

examples/vue-router/vite.config.ts

@@ -35,6 +35,10 @@ const pwaOptions: Partial<VitePWAOptions> = {
       },
     ],
   },
+  // showMaximumFileSizeToCacheInBytesWarning: true,
+  // workbox: {
+  //   maximumFileSizeToCacheInBytes: 12000,
+  // },
   devOptions: {
     enabled: process.env.SW_DEV === 'true',
     /* when using generateSW the PWA plugin will switch to classic */
@@ -81,6 +85,7 @@ if (process.env.SW === 'true') {
     buildPlugins: {
       vite: [virtualMessagePlugin()],
     },
+    // maximumFileSizeToCacheInBytes: 1000,
   }
 }
 

src/log.ts

@@ -26,11 +26,18 @@ export function logSWViteBuild(
 }
 
 export function logWorkboxResult(
+  throwMaximumFileSizeToCacheInBytes: boolean,
   strategy: ResolvedVitePWAOptions['strategies'],
   buildResult: BuildResult,
   viteOptions: ResolvedConfig,
   format: 'es' | 'iife' | 'none' = 'none',
 ) {
+  if (throwMaximumFileSizeToCacheInBytes) {
+    const entries = buildResult.warnings.filter(w => w.includes('maximumFileSizeToCacheInBytes'))
+    if (entries.length)
+      throw new Error(`\n${entries.map(w => `  - ${w}`).join('\n')}`)
+  }
+
   const { root, logLevel = 'info' } = viteOptions
 
   if (logLevel === 'silent')

src/modules.ts

@@ -82,7 +82,12 @@ self.addEventListener('activate', (e) => {
   // generate the service worker
   const buildResult = await generateSW(options.workbox)
   // log workbox result
-  logWorkboxResult('generateSW', buildResult, viteOptions)
+  logWorkboxResult(
+    options.throwMaximumFileSizeToCacheInBytes,
+    'generateSW',
+    buildResult,
+    viteOptions,
+  )
 
   return buildResult
 }

src/options.ts

@@ -62,6 +62,7 @@ export async function resolveOptions(ctx: PWAPluginContext): Promise<ResolvedVit
     integration = {},
     buildBase,
     pwaAssets,
+    showMaximumFileSizeToCacheInBytesWarning = false,
   } = options
 
   const basePath = resolveBasePath(base)
@@ -224,6 +225,7 @@ export async function resolveOptions(ctx: PWAPluginContext): Promise<ResolvedVit
       envPrefix,
     },
     pwaAssets: resolvePWAAssetsOptions(pwaAssets),
+    throwMaximumFileSizeToCacheInBytes: !showMaximumFileSizeToCacheInBytesWarning,
   }
 
   // calculate hash only when required

src/types.ts

@@ -393,6 +393,15 @@ export interface VitePWAOptions {
    * @experimental
    */
   pwaAssets?: PWAAssetsOptions
+
+  /**
+   * From version `0.20.2`, the plugin will throw an error if the `maximumFileSizeToCacheInBytes` warning is present when building the service worker.
+   *
+   * If you want the old behavior when building the service worker, set this option to `true`.
+   *
+   * @default false
+   */
+  showMaximumFileSizeToCacheInBytesWarning?: boolean
 }
 
 export interface ResolvedServiceWorkerOptions {
@@ -401,7 +410,7 @@ export interface ResolvedServiceWorkerOptions {
   rollupOptions: RollupOptions
 }
 
-export interface ResolvedVitePWAOptions extends Required<Omit<VitePWAOptions, 'pwaAssets'>> {
+export interface ResolvedVitePWAOptions extends Required<Omit<VitePWAOptions, 'pwaAssets' | 'showMaximumFileSizeToCacheInBytesWarning'>> {
   swSrc: string
   swDest: string
   workbox: GenerateSWOptions
@@ -421,6 +430,7 @@ export interface ResolvedVitePWAOptions extends Required<Omit<VitePWAOptions, 'p
     envPrefix: ResolvedConfig['envPrefix']
   }
   pwaAssets: false | ResolvedPWAAssetsOptions
+  throwMaximumFileSizeToCacheInBytes: boolean
 }
 
 export interface ShareTargetFiles {

src/vite-build.ts

@@ -72,7 +72,13 @@ export async function buildSW(
   // inject the manifest
   const buildResult = await injectManifest(injectManifestOptions)
   // log workbox result
-  logWorkboxResult('injectManifest', buildResult, viteOptions, format)
+  logWorkboxResult(
+    options.throwMaximumFileSizeToCacheInBytes,
+    'injectManifest',
+    buildResult,
+    viteOptions,
+    format,
+  )
 }
 
 function prepareViteBuild(