Registry / devops / esbuild-plugin-filesize

esbuild-plugin-filesize

library0.4.0jsnpmunverified

An ESBuild plugin that displays filesize information for output bundles after build. Current stable version is 0.4.0. The plugin integrates seamlessly with ESBuild and shows file sizes in kilobytes with color-coded output. It is part of the LinbuduLab nx-plugins ecosystem. Unlike other filesize plugins, this one is specifically tailored for ESBuild's plugin API and provides immediate visual feedback in the console. Releases follow semantic versioning but the package is maintained as part of a monorepo with occasional updates.

devops

npm install esbuild-plugin-filesize

github ↗package ↗

INSTALL

IMPORT

SIG · ESBUILD-PLUGIN-FIL

esbuild-plugin-filesize

devopsjavascriptv0.4.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.

default

✓ import filesizePlugin from 'esbuild-plugin-filesize'

✗ const filesizePlugin = require('esbuild-plugin-filesize')

Package is ESM-only. CommonJS require will fail.

filesizePlugin

✓ import filesizePlugin from 'esbuild-plugin-filesize'

✗ const { filesizePlugin } = require('esbuild-plugin-filesize')

Default export, not named. Do not destructure.

FilesizePluginOptions (type)

✓ import type { FilesizePluginOptions } from 'esbuild-plugin-filesize'

✗ import { FilesizePluginOptions } from 'esbuild-plugin-filesize'

TypeScript type import only. Not a runtime value.

Basic setup of esbuild-plugin-filesize in an ESBuild build script with default options.

import esbuild from 'esbuild'; import filesizePlugin from 'esbuild-plugin-filesize'; await esbuild.build({ entryPoints: ['app.js'], bundle: true, outfile: 'out.js', plugins: [filesizePlugin()], // Optional: filesizePlugin({ showGzipped: true }) });

Debug

Known issues

gotchaPlugin must be called as a function even with no options: filesizePlugin() not filesizePlugin.

fix

Use filesizePlugin() with parentheses.

affects: >=0.1.0

breakingVersion 0.3.0 changed default from showing only uncompressed size to showing both uncompressed and gzipped sizes.

fix

Set showGzipped: false to revert to old behavior.

affects: >=0.3.0

gotchaThe plugin does not support ESBuild's 'write: false' mode because it reads files after writing.

fix

Ensure 'write' is true or use a different method to get file sizes.

affects: >=0.1.0

Errors

Common errors & fixes

Error: Cannot find module 'esbuild-plugin-filesize'

Package not installed or not in node_modules.

fix

Run npm install esbuild-plugin-filesize --save-dev

TypeError: filesizePlugin is not a function

Imported as named export instead of default export.

fix

Use: import filesizePlugin from 'esbuild-plugin-filesize'

Upgrade

Version history

0.4.0latest on npm

Audit

Dependencies

esbuildrequiredPeer dependency required for ESBuild plugin API.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/LinbuduLab/esbuild-plugins ↗

packagehttps://www.npmjs.com/package/esbuild-plugin-filesize ↗