--- createdAt: 2026-01-11 updatedAt: 2026-09-27 priority: 4 title: "vite-env-only: falso errore node:fs con Intlayer" description: Perché vite-env-only segnala un import `node:fs` negato con Intlayer + React-Router + Vite e cosa fare. keywords: - intlayer - vite - react-router - vite-env-only - node:fs - import denied - alias - client bundle slugs: - frequent-questions - vite-env-only-node-fs-false-positive author: aymericzip --- # vite-env-only nega `node:fs` con Intlayer Se hai usato il plugin **vite-env-only** (come suggerito nelle vecchie indicazioni di React-Router v7) e vedi: ```bash Error: [vite-env-only] Import denied * Denied by specifier pattern: /^node:/ * Importer: index.html * Import: "node:fs" ``` …anche se non c’è **`node:fs` nel tuo bundle client**, questo è un **falso positivo**. ## Cosa lo causa `vite-env-only` esegue un controllo basato su Babel **all'inizio della risoluzione del grafo di Vite**, _prima_ di: - aliasing (inclusi i mapping browser vs node di Intlayer), - dead-code elimination, - risoluzione SSR vs client, - moduli virtuali come quelli di React-Router. I pacchetti Intlayer contengono codice che può funzionare sia su Node sia sul browser. In una fase _intermedia_, un modulo built-in di Node come `node:fs` può apparire nel grafo **prima** che Vite lo rimuova dal build client. `vite-env-only` lo rileva e genera un errore immediato, anche se il bundle finale non lo contiene. ## React-Router e le convenzioni sui moduli lato server Nella documentazione di React-Router sulle **convenzioni per i moduli lato server** (https://reactrouter.com/api/framework-conventions/server-modules), il team **suggerisce esplicitamente di usare `vite-env-only`** per evitare che import specifici del server trapelino nel bundle client. Tuttavia, quelle convenzioni si basano su aliasing di Vite, conditional exports e tree-shaking per rimuovere il codice server-only. Sebbene aliasing e conditional exports siano già applicati, alcune utilità basate su Node sono ancora presenti in pacchetti come `@intlayer/core` in quella fase (anche se non vengono mai importate nel client). Poiché il tree-shaking non è ancora stato eseguito, quelle funzioni vengono comunque analizzate da Babel, e `vite-env-only` rileva i loro import `node:` e segnala un falso positivo, anche se vengono correttamente eliminati dal bundle client finale. ## Come risolvere / aggirare ### Consigliato: Rimuovere `vite-env-only` Rimuovi semplicemente il plugin. In molti casi non ti serve. Vite gestisce già le importazioni client vs server tramite la propria risoluzione. Questo risolve il falso errore su `node:fs` senza modifiche a Intlayer. ### Verificare il build finale invece Se vuoi comunque assicurarti che non ci siano built-in di Node nel client, falla **dopo la build**, per esempio: ```bash pnpm build grep -R "node:" dist/ ``` Se non ci sono risultati, i tuoi bundle client sono puliti. ## Riepilogo - `vite-env-only` può generare un errore su `node:fs` perché esegue il controllo troppo presto. - Le convenzioni sui server modules di Vite + Intlayer + React-Router normalmente rimuovono correttamente i riferimenti server-only. - Rimuovere il plugin o verificare l'_output finale_ è generalmente la soluzione migliore.