feat: add failOnWarn option (#411)

Gugustinette · web-flow · commit d7d499999fe3 · 2025-08-05T22:18:44.000+08:00
diff --git a/src/cli.ts b/src/cli.ts
@@ -27,6 +27,7 @@ cli
   .option('--debug [feat]', 'Show debug logs')
   .option('--target <target>', 'Bundle target, e.g "es2015", "esnext"')
   .option('-l, --logLevel <level>', 'Set log level: info, warn, error, silent')
+  .option('--fail-on-warn', 'Fail on warnings', { default: true })
   .option('-d, --out-dir <dir>', 'Output directory', { default: 'dist' })
   .option('--treeshake', 'Tree-shake bundle', { default: true })
   .option('--sourcemap', 'Generate source map', { default: false })
diff --git a/src/options/index.ts b/src/options/index.ts
@@ -173,6 +173,7 @@ async function resolveConfig(
     clean = true,
     silent = false,
     logLevel = silent ? 'silent' : 'info',
+    failOnWarn = false,
     customLogger,
     treeshake = true,
     platform = 'node',
@@ -207,7 +208,7 @@ async function resolveConfig(
     nodeProtocol,
   } = userConfig
 
-  const logger = createLogger(logLevel, { customLogger })
+  const logger = createLogger(logLevel, { customLogger, failOnWarn })
 
   if (typeof bundle === 'boolean') {
     logger.warn('`bundle` option is deprecated. Use `unbundle` instead.')
diff --git a/src/options/types.ts b/src/options/types.ts
@@ -247,6 +247,11 @@ export interface Options {
    * @default 'info'
    */
   logLevel?: LogLevel
+  /**
+   * If true, fails the build on warnings.
+   * @default false
+   */
+  failOnWarn?: boolean
   /**
    * Custom logger.
    */
@@ -432,6 +437,7 @@ export type ResolvedOptions = Omit<
         | 'filter'
         | 'silent'
         | 'logLevel'
+        | 'failOnWarn'
         | 'customLogger'
       >,
       | 'globalName'
diff --git a/src/utils/logger.ts b/src/utils/logger.ts
@@ -8,6 +8,7 @@ export type LogLevel = LogType | 'silent'
 export interface LoggerOptions {
   customLogger?: Logger
   console?: Console
+  failOnWarn?: boolean
 }
 
 export const LogLevels: Record<LogLevel, number> = {
@@ -34,7 +35,11 @@ const warnedMessages = new Set<string>()
 
 export function createLogger(
   level: LogLevel = 'info',
-  { customLogger, console = globalThis.console }: LoggerOptions = {},
+  {
+    customLogger,
+    console = globalThis.console,
+    failOnWarn = false,
+  }: LoggerOptions = {},
 ): Logger {
   if (customLogger) {
     return customLogger
@@ -57,6 +62,9 @@ export function createLogger(
 
     warn(...msgs: any[]): void {
       const message = format(msgs)
+      if (failOnWarn) {
+        throw new Error(message)
+      }
       warnedMessages.add(message)
       output('warn', `\n${bgYellow` WARN `} ${message}\n`)
     },
@@ -66,6 +74,10 @@ export function createLogger(
       if (warnedMessages.has(message)) {
         return
       }
+
+      if (failOnWarn) {
+        throw new Error(message)
+      }
       warnedMessages.add(message)
 
       output('warn', `\n${bgYellow` WARN `} ${message}\n`)
