vite-plugin-node-polyfills

A Vite plugin to polyfill Node's Core Modules for browser environments. Supports node: protocol imports.

Why do I need this?

Module "stream" has been externalized for browser compatibility. Cannot access "stream.Readable" in client code.

Since browsers do not support Node's Core Modules, packages that use them must be polyfilled to function in browser environments. In an attempt to prevent runtime errors, Vite produces errors or warnings when your code references builtin modules such as fs or path.

Getting Started

Install the package as a dev dependency.

1# npm
2npm install --save-dev vite-plugin-node-polyfills
3
4# pnpm
5pnpm install --save-dev vite-plugin-node-polyfills
6
7# yarn
8yarn add --dev vite-plugin-node-polyfills

Add the plugin to your vite.config.ts file.

1import { defineConfig } from 'vite'
2import { nodePolyfills } from 'vite-plugin-node-polyfills'
3
4// https://vitejs.dev/config/
5export default defineConfig({
6  plugins: [
7    nodePolyfills({
8      // Whether to polyfill `node:` protocol imports.
9      protocolImports: true,
10    }),
11  ],
12})