gem-hunter
Language: TypeScript
Rollup/Vite/Rolldown plugin to generate a stats JSON file with a bundle-stats webpack-compatible structure
Rollup/Vite/Rolldown plugin to generate a stats JSON file with a bundle-stats webpack-compatible structure.
Note
This plugin generates a webpack-compatible stats JSON file for programmatic usage, inspection, or integration with other compatible tools. To analyze your Rollup/Vite/Rolldown bundle, use rollup-plugin-bundle-stats instead.
npm install --dev rollup-plugin-webpack-stats
or
yarn add --dev rollup-plugin-webpack-stats
or
pnpm add -D rollup-plugin-webpack-stats
// rollup.config.js import webpackStatsPlugin from 'rollup-plugin-webpack-stats'; export default { plugins: [ // add it as the last plugin webpackStatsPlugin(), ], };
// vite.config.js import { defineConfig } from 'vite'; import webpackStatsPlugin from 'rollup-plugin-webpack-stats'; export default defineConfig((env) => ({ plugins: [ // Output webpack-stats.json file webpackStatsPlugin(), ], }));
fileName - the JSON filepath relative to the build folder or absolute(default: webpack-stats.json)transform - access and mutate the resulting stats after the conversion: (stats: WebpackStatsFilterd, sources: TransformSources, bundle: OutputBundle) => WebpackStatsFilterdmoduleOriginalSize - extract module original size or rendered size (default: false)write - format and write the stats to disk(default: fs.write(filename, JSON.stringify(stats, null, 2)))excludeAssets - exclude matching assets: string | RegExp | ((filepath: string) => boolean) | Array<string | RegExp | ((filepath: string) => boolean)>excludeModules - exclude matching modules: string | RegExp | ((filepath: string) => boolean) | Array<string | RegExp | ((filepath: string) => boolean)>// rollup.config.js import webpackStatsPlugin from 'rollup-plugin-webpack-stats'; module.exports = { plugins: [ // add it as the last plugin webpackStatsPlugin({ filename: 'artifacts/stats.json', }), ], };
// rollup.config.js import webpackStatsPlugin from 'rollup-plugin-webpack-stats'; export default { plugins: [ // add it as the last plugin webpackStatsPlugin({ excludeAssets: /\.map$/, }), ], };
// for the the modern and legacy outputs import { defineConfig } from 'vite'; import legacy from '@vitejs/plugin-legacy'; import webpackStatsPlugin from 'rollup-plugin-webpack-stats'; export default defineConfig((env) => ({ build: { rollupOptions: { output: { plugins: [ // Output webpack-stats-modern.json file for the modern build // Output webpack-stats-legacy.json file for the legacy build // Stats are an output plugin, as plugin-legacy works by injecting // an additional output, that duplicates the plugins configured here webpackStatsPlugin((options) => { const isLegacy = options.format === 'system'; return { fileName: `webpack-stats${isLegacy ? '-legacy' : '-modern'}.json`, }; }), ], }, }, }, plugins: [ legacy({ /* Your legacy config here */ }), ], }));
import { defineConfig } from 'vite'; import webpackStatsPlugin from 'rollup-plugin-webpack-stats'; export default defineConfig((env) => ({ build: { rollupOptions: { output: { plugins: [ webpackStatsPlugin({ transform: (stats) => { // Find the target chunk entry const mainChunkIndex = stats.chunks?.findIndex((chunk) => chunk.names?.includes('main') ); // When the tartget chunk is found, set the initial flag to true if ( typeof mainChunkIndex !== 'undefined' && stats?.chunks?.[mainChunkIndex] ) { stats.chunks[mainChunkIndex] = { ...stats.chunks[mainChunkIndex], initial: true, }; } // return the modified stats object return stats; }, }), ], }, }, }, }));
Analyze bundle stats(bundle size, assets, modules, packages) and compare the results between different builds. Support for webpack, rspack, vite, rolldown and rollup.
Output vite/rollup/rolldown stats.
nvm use
npm install
npm run prepare