Function requestModuleFromServer

packages/vite/hmr/client/utils.ts:165–196

(spec: string)

}

export async function requestModuleFromServer(spec: string): Promise<string> {
	const isSfcArtifact = (s: string) => /(?:^|\/)sfc-[a-f0-9]{8}\.mjs$/i.test(s) || /\/_ns_hmr\/src\/sfc\//.test(s) || /__NSDOC__\/_ns_hmr\/src\/sfc\//.test(s);
	// Ignore Vite/virtual helper or empty specs
	if (/^\/?\0/.test(spec) || /plugin-vue:export-helper/.test(spec)) {
		if (__NS_ENV_VERBOSE__) console.log('[hmr-fetch] skipping virtual helper', spec);
		return Promise.reject(new Error('virtual-helper-skip'));
	}
	// Short-circuit device artifact paths (SFC compiled files) – never ask the server for these
	try {
		if (isSfcArtifact(spec)) {
			return Promise.reject(new Error('artifact-path-disallowed'));
		}
	} catch {}
	// Special-case JSON package metadata requests at project root ONLY: some modules reference '/package.json' during dev.
	// Intentionally narrow match to '/package.json' to avoid intercepting relative imports that should be inlined.
	if (/^\/?package\.json(?:\/index)?$/.test(spec)) {
		// Let the server send the JSON-wrapped ESM code; we will write it as-is.
		// We still go through the normal request flow below, but short-circuit index heuristics.
	}
	// Cache hit: return immediately
	if (moduleFetchCache.has(spec)) {
		if (__NS_ENV_VERBOSE__) console.log('[hmr-fetch] cache hit', spec);
		return Promise.resolve(moduleFetchCache.get(spec)!);
	}
	// Construct HTTP ESM URL for this spec and cache it
	const origin = httpOriginForVite || deriveHttpOrigin(hmrWsUrl);
	if (!origin) return Promise.reject(new Error('no-http-origin'));
	const url = origin + '/ns/m' + (spec.startsWith('/') ? spec : '/' + spec);
	if (__NS_ENV_VERBOSE__) console.log('[hmr-fetch] resolved', spec, '→', url);
	moduleFetchCache.set(spec, url);
	return Promise.resolve(url);
}

// Centralized safe dynamic import wrapper to guard anomalous specifiers
export async function safeDynImport(spec: string): Promise<any> {