performance.printFileSize#

• Type:

type PrintFileSizeOptions =
  | boolean
  | {
      total?: boolean;
      detail?: boolean;
      compressed?: boolean;
      include?: (asset: PrintFileSizeAsset) => boolean;
    };

• Default: true

Whether to print the file sizes after production build.

Default Outputs#

The default output log is as follows:

Disable Outputs#

If you don't want to print any information, you can disable it by setting printFileSize to false:

export default {
  performance: {
    printFileSize: false,
  },
};

Options#

You can customize the output format through the options.

total#

• Type: boolean
• Default: true

Whether to output the total size of all static assets.

export default {
  performance: {
    printFileSize: {
      total: false,
    },
  },
};

detail#

• Type: boolean
• Default: true

Whether to output the size of each static asset.

If you don't need to view the size of each static asset, you can set detail to false. In this case, only the total size will be output:

export default {
  performance: {
    printFileSize: {
      detail: false,
    },
  },
};

compressed#

• Type: boolean
• Default: false when output.target is node, otherwise true

Whether to output the gzip-compressed size of each static asset.

If you don't need to view the gzipped size, you can set compressed to false. This can save some gzip computation time for large projects:

export default {
  performance: {
    printFileSize: {
      compressed: false,
    },
  },
};

include#

• Type:

type PrintFileSizeAsset = {
  /**
   * The name of the static asset.
   * @example 'index.html', 'static/js/index.[hash].js'
   */
  name: string;
  /**
   * The size of the static asset in bytes.
   */
  size: number;
};
type Include = (asset: PrintFileSizeAsset) => boolean;

• Default: undefined

A filter function to determine which static assets to print.

If returned false, the static asset will be excluded and not included in the total size or detailed size.

For example, only output static assets larger than 10kB:

export default {
  performance: {
    printFileSize: {
      include: (asset) => asset.size > 10 * 1000,
    },
  },
};

Or only output .js files larger than 10kB:

export default {
  performance: {
    printFileSize: {
      include: (asset) => /\.js$/.test(asset.name) && asset.size > 10 * 1000,
    },
  },
};

exclude#

• Type:

type Exclude = (asset: PrintFileSizeAsset) => boolean;

• Default: (asset) => /\.(?:map|LICENSE\.txt)$/.test(asset.name)

A filter function to determine which static assets to exclude. If both include and exclude are set, exclude will take precedence.

Rsbuild defaults to excluding source map and license files, as these files do not affect page load performance.

For example, exclude .html files in addition to the default:

export default {
  performance: {
    printFileSize: {
      exclude: (asset) =>
        /\.(?:map|LICENSE\.txt)$/.test(asset.name) ||
        /\.html$/.test(asset.name),
    },
  },
};