Registry / devops / rollup-plugin-output-size

rollup-plugin-output-size

library2.0.0jsnpmunverified

A Rollup plugin that displays output bundle sizes (uncompressed and gzipped) for assets, chunks, and entries. Current stable version is 2.0.0, released 2025, with peer dependency on Rollup ^2.0.0 || ^3.0.0 || ^4.0.0. Ships TypeScript types. Key differentiators: lightweight (zero dependencies since v2.0.0), uses Node.js built-in gzip and util.styleText, provides customization options (bytes, hide, gzip, silent, summary, handle), and exports utility functions (format, summarize). Actively maintained, with breaking changes in v2.0.0 requiring Node >=20.12.0 and removal of deprecated RollupOutputSizeOptions interface.

devops

npm install rollup-plugin-output-size

github ↗package ↗

INSTALL

IMPORT

SIG · ROLLUP-PLUGIN-OUTP

rollup-plugin-output-size

devopsjavascriptv2.0.0

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.

outputSize (default)

✓ import outputSize from 'rollup-plugin-output-size'

✗ const outputSize = require('rollup-plugin-output-size')

ESM-only since v2.0.0; CommonJS require returns { default: outputSize }

format

✓ import { format } from 'rollup-plugin-output-size'

✗ const { format } = require('rollup-plugin-output-size'); // works in CJS but preferred ESM

Named export for utility function; available in both ESM and CJS via the package's dual format

summarize

✓ import { summarize } from 'rollup-plugin-output-size'

✗ import summarize from 'rollup-plugin-output-size'

Named export, not default; used for custom summary output

Options

✓ import type { Options } from 'rollup-plugin-output-size'

✗ import { Options } from 'rollup-plugin-output-size' // Value not exported at runtime

TypeScript type only; do not import as value

Shows full configuration with all options and custom handle callback using format utility.

import outputSize from 'rollup-plugin-output-size'; import { format, summarize } from 'rollup-plugin-output-size'; export default { input: 'src/index.js', output: { dir: 'dist' }, plugins: [ outputSize({ bytes: true, gzip: ['chunk', 'entry'], hide: false, silent: false, summary: true, handle(info) { console.log(format(info)); } }) ] };

Debug

Known issues

breakingRequires Node.js >=20.12.0 in v2.0.0

fix

Update Node.js to 20.12.0 or later

affects: >=2.0.0

deprecatedRollupOutputSizeOptions interface removed in v2.0.0

fix

Replace with Options interface (import type { Options } from 'rollup-plugin-output-size')

affects: >=2.0.0

gotchaCommonJS require returns { default: outputSize } not outputSize directly

fix

Use ESM import or destructure: const { default: outputSize } = require('rollup-plugin-output-size')

affects: >=2.0.0

gotchaSummary total gzip size is sum of individual gzip sizes, not archive-level

fix

Use archiver for accurate total gzip size

affects: >=1.0.0

gotchaOptions type not available as runtime value; only as TypeScript type import

fix

Import type: import type { Options } from 'rollup-plugin-output-size'

affects: >=1.4.0

deprecatedRollupOutputSizeOptions interface deprecated since v1.4.0 and removed in v2.0.0

fix

Use Options interface

affects: <2.0.0

Errors

Common errors & fixes

Error [ERR_REQUIRE_ESM]: require() of ES Module

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

fix

Switch to ESM (import outputSize from 'rollup-plugin-output-size') or use dynamic import()

TypeError: outputSize is not a function

Using default import from CommonJS require but did not destructure .default

fix

const outputSize = require('rollup-plugin-output-size').default;

TypeError: (0 , plugin_1.default) is not a function

Incorrect import of default export when using TypeScript and CommonJS

fix

Use import outputSize from 'rollup-plugin-output-size'

Cannot find module 'node:util' or 'node:zlib'

Node.js version <20.12.0 missing required built-in APIs

fix

Update Node.js to >=20.12.0

Upgrade

Version history

2.0.0latest on npm

Audit

Dependencies

rolluprequiredpeer dependency; the plugin hooks into Rollup's build system

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/Arnesfield/rollup-plugin-output-size ↗

packagehttps://www.npmjs.com/package/rollup-plugin-output-size ↗