Registry /
web-framework / vite-plugin-react-fallback-throttle
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslnode 18–223 runs
build_error
glibcnode 18–223 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
reactFallbackThrottle
✓ import reactFallbackThrottle from 'vite-plugin-react-fallback-throttle'
✗ const reactFallbackThrottle = require('vite-plugin-react-fallback-throttle')
ESM-only package; does not support CommonJS require. The default export is a function.
ReactFallbackThrottleOptions
✓ import type { ReactFallbackThrottleOptions } from 'vite-plugin-react-fallback-throttle'
✗ import { ReactFallbackThrottleOptions } from 'vite-plugin-react-fallback-throttle'
Options type is only available as a type import; value import will fail at runtime.
Plugin
✓ import reactFallbackThrottle from 'vite-plugin-react-fallback-throttle'
✗ import { vitePluginReactFallbackThrottle } from 'vite-plugin-react-fallback-throttle'
The default export is the Vite plugin function; there is no named export for it.
Shows how to add the plugin to a Vite config with React 19 and a custom throttle delay of 200ms.
import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';
import reactFallbackThrottle from 'vite-plugin-react-fallback-throttle';
export default defineConfig({
plugins: [
react(),
reactFallbackThrottle({ throttleMs: 200 }),
],
});
Debug
Known issues
gotchaThe plugin only works with React 19 (react-dom ^19.0.0). Using it with older React versions will have no effect.fixEnsure your project uses react-dom@^19.0.0.
affects: <0.1.0 || >=0.1.0
gotchaThe default export is a function that returns a Vite plugin object, not the plugin object itself. Forgetting to call it with options will cause an error.fixAlways invoke the imported function: reactFallbackThrottle({ throttleMs: 300 }). affects: >=0.1.0
breakingIn v0.1.0, the plugin could not correctly handle pre-bundled React DOM dependencies. This was fixed in v0.1.1.fixUpgrade to v0.1.1 or later.
affects: 0.1.0
gotchaThe plugin does not support CommonJS require(); it is ESM-only. Using require() will fail at runtime.fixUse dynamic import() or switch to ESM.
affects: >=0.1.0
Errors
Common errors & fixes
Error: The plugin react-fallback-throttle requires a function export, but got an object.
Using import reactFallbackThrottle from ... incorrectly as a plugin object without invoking the function.
fixCall the imported function: reactFallbackThrottle({ throttleMs: 300 }). TypeError: reactFallbackThrottle is not a function
Trying to use CommonJS require() on an ESM-only package.
fixUse import reactFallbackThrottle from 'vite-plugin-react-fallback-throttle'.
Vite: The plugin 'react-fallback-throttle' is not supported by your version of Vite.
Using a Vite version outside the supported range (>=2.3.0 <9.0.0).
fixUpdate Vite to a compatible version: npm install vite@6.
Audit
Dependencies
react-domrequiredThe plugin patches FALLBACK_THROTTLE_MS in react-dom's internal configuration; only works with React 19.
viterequiredVite plugin architecture requirement; must be version 2.3.0 or later.