Bundle size information for a specific package version.

Returned by GET /api/size?package={name}@{version}.

const size = await client.package('react').size('18.2.0');
console.log(size.gzip); // 2670
interface BundleSize {
    assets: BundleAsset[];
    dependencyCount: number;
    dependencySizes: DependencySize[];
    description: string;
    gzip: number;
    hasJSModule: boolean;
    hasJSNext: boolean;
    hasSideEffects: boolean | "unknown";
    isModuleType: boolean;
    name: string;
    scoped: boolean;
    size: number;
    version: string;
}

Properties

assets: BundleAsset[]

Individual assets that make up the bundle

dependencyCount: number

Number of transitive dependencies included in the bundle

dependencySizes: DependencySize[]

Per-dependency size breakdown

description: string

Package description from package.json

gzip: number

Gzip-compressed size in bytes

hasJSModule: boolean

Whether the package exports an ES module via the module field

hasJSNext: boolean

Whether the package exports an ES module via the jsnext:main field

hasSideEffects: boolean | "unknown"

Whether the package is known to have side effects

isModuleType: boolean

Whether the package.json declares "type": "module"

name: string

Package name

scoped: boolean

Whether the package name is scoped (e.g. @scope/pkg)

size: number

Minified size in bytes

version: string

Resolved version