Skip emitFile() in astro:scripts plugin during serve mode

crazylogic03 · crazylogic03 · commit 4f06150b3ddc · 2026-03-25T18:24:01.000+05:30
Guard the buildStart hook in vite-plugin-scripts to skip this.emitFile() when Vite is running in serve mode. emitFile() is a Rollup build-time API that Vite stubs out during dev, producing a spurious warning: [WARN] [vite] [plugin:astro:scripts] context method emitFile() is not supported in serve mode. The fix captures the Vite command via the config hook and returns early from buildStart when command === 'serve'. Fixes #16026 Fixes #15975
diff --git a/.changeset/fix-emitfile-serve-warning.md b/.changeset/fix-emitfile-serve-warning.md
@@ -0,0 +1,5 @@
+---
+'astro': patch
+---
+
+Fixes the `emitFile() is not supported in serve mode` warning that appears during `astro dev` when using integrations that inject before-hydration scripts (e.g. `@astrojs/react`)
diff --git a/packages/astro/src/vite-plugin-scripts/index.ts b/packages/astro/src/vite-plugin-scripts/index.ts
@@ -1,4 +1,4 @@
-import type { Plugin as VitePlugin } from 'vite';
+import type { Plugin as VitePlugin, ConfigEnv } from 'vite';
 import type { AstroSettings } from '../types/astro.js';
 import type { InjectedScriptStage } from '../types/public/integrations.js';
 import { ASTRO_VITE_ENVIRONMENT_NAMES } from '../core/constants.js';
@@ -14,8 +14,12 @@ export const PAGE_SCRIPT_ID = `${SCRIPT_ID_PREFIX}${'page' as InjectedScriptStag
 export const PAGE_SSR_SCRIPT_ID = `${SCRIPT_ID_PREFIX}${'page-ssr' as InjectedScriptStage}.js`;
 
 export default function astroScriptsPlugin({ settings }: { settings: AstroSettings }): VitePlugin {
+	let command: 'build' | 'serve';
 	return {
 		name: 'astro:scripts',
+		config(_: any, env: ConfigEnv) {
+			command = env.command;
+		},
 
 		resolveId: {
 			filter: {
@@ -58,6 +62,7 @@ export default function astroScriptsPlugin({ settings }: { settings: AstroSettin
 			},
 		},
 		buildStart() {
+			if (command === 'serve') return;
 			const hasHydrationScripts = settings.scripts.some((s) => s.stage === 'before-hydration');
 			if (
 				hasHydrationScripts &&

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +'astro': patch
 +---
++
 +Fixes the `emitFile() is not supported in serve mode` warning that appears during `astro dev` when using integrations that inject before-hydration scripts (e.g. `@astrojs/react`)