Registry / devops / vite-plugin-optimize-exclude

vite-plugin-optimize-exclude

library0.0.1jsnpmunverified

A Vite plugin (v0.0.1, stable) that excludes ESM dependencies from Vite's dependency optimization to prevent page reloads caused by 'New dependencies detected'. It scans node_modules and excludes all ESM packages from the pre-bundling process, reducing the likelihood of shared chunk regeneration. Requires Vite >=2.0.0. Differentiator: automates exclusion strategy unlike manual optimizeDeps.exclude configuration.

devops web-framework

npm install vite-plugin-optimize-exclude

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-OPTIMI

vite-plugin-optimize-exclude

devopsjavascriptv0.0.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

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

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import optimizeExclude from 'vite-plugin-optimize-exclude'

✗ const optimizeExclude = require('vite-plugin-optimize-exclude')

ESM-only; CommonJS require will fail as package does not export CJS.

VitePluginOptimizeExclude

✓ import { VitePluginOptimizeExclude } from 'vite-plugin-optimize-exclude'

✗ import { optimizeExclude } from 'vite-plugin-optimize-exclude'

Named export uses PascalCase; exporting type also.

types

✓ import type { Options } from 'vite-plugin-optimize-exclude'

TypeScript types are exported; use type-only import for Options interface.

Basic usage: import and add the plugin to Vite config to automatically exclude ESM dependencies from optimization.

// vite.config.ts import { defineConfig } from 'vite'; import optimizeExclude from 'vite-plugin-optimize-exclude'; export default defineConfig({ plugins: [ optimizeExclude({ // Optional: override default behavior // exclude: ['vue'], }), ], });

Debug

Known issues

gotchaPlugin only works in ESM projects; CJS projects will encounter import errors.

fix

Ensure your project uses ESM (type: 'module' in package.json) and Vite's ESM mode.

affects: >=0.0.1

gotchaExcluding too many dependencies may increase the number of HTTP requests and impact performance.

fix

Monitor bundle size and request count; consider customizing the exclude list if needed.

affects: >=0.0.1

Errors

Common errors & fixes

ERR_REQUIRE_ESM: require() of ES Module not supported

Using CommonJS require() on an ESM-only package.

fix

Switch to import statement or use dynamic import().

TypeError: optimizeExclude is not a function

Using default import incorrectly (e.g., destructuring when package has no named default export).

fix

Use import optimizeExclude from 'vite-plugin-optimize-exclude' without destructuring.

Upgrade

Version history

0.0.1latest on npm

Audit

Dependencies

viterequiredPeer dependency required for plugin functionality

Agent activity

9 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/antfu/vite-plugin-optimize-exclude ↗

packagehttps://www.npmjs.com/package/vite-plugin-optimize-exclude ↗