gcf

gulp-check-filesize

Logs the size of a given file and warns if a defined limit is exceeded

Showing:

Popularity

Downloads/wk

1.1K

Maintenance

No Maintenance Data Available

Package

Dependencies

4

Size (min+gzip)

14.7KB

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

gulp-check-filesize

check-filesize plugin for gulp

This plugin logs the size of a given file. If you set a filesize limit, it logs a warning if the limit is exceeded.

Usage

First, install gulp-check-filesize as a development dependency:

npm install --save-dev gulp-check-filesize

Then, add it to your gulpfile.js:

var checkFilesize = require("gulp-check-filesize");

gulp.src("css/**/*.css")
    .pipe(checkFilesize()
    .pipe(gulp.dest("./dist"));

This produces a log that will look something like this:

$ gulp css
[19:30:55] Using gulpfile /var/www/project/gulpfile.js
[19:30:57] Starting 'css'...
[19:30:57] Size of main.css : 16.4 kB
[19:30:57] Finished 'css' after 502 ms

enable gzip

You can enable the gzip option to also check the filesize after gzip compression.

var checkFilesize = require("gulp-check-filesize");

gulp.src("css/**/*.css")
    .pipe(checkFilesize({
        enableGzip: true
    })
    .pipe(gulp.dest("./dist"));

This produces a log that will look something like this:

$ gulp css
[19:30:55] Using gulpfile /var/www/project/gulpfile.js
[19:30:57] Starting 'css'...
[19:30:57] Size of main.css: 114.32 kB (19.47 kB gzipped)
[19:30:57] Finished 'css' after 502 ms

Setting filesize limit

You can specify a maximum filesize (in Byte). If the filesize is exceeded, the plugin will log a warning (see also fileSizeLimitGzipped):

var checkFilesize = require("gulp-check-filesize");

gulp.src("css/**/*.css")
    .pipe(checkFilesize({
        fileSizeLimit: 16384 // 16384 === 16kb
    })
    .pipe(gulp.dest("./dist"));
$ gulp css
[19:30:55] Using gulpfile /var/www/project/gulpfile.js
[19:30:57] Starting 'css'...
[19:30:57] WARNING: cloudBackup.css exceeded filesize limit of 16 kB: 16.4 kB
[19:30:57] Finished 'css' after 502 ms

API

checkFilesize(options)

You can pass an optional options object to the plugin.

options.enableGzip

Type: Boolean
Default: false

Output gzipped filesize as well

options.filesizeLimit

Type: Number
Default: undefined

Your filesize limit in Bytes

options.filesizeLimitGzipped

Type: Number
Default: undefined

Your filesize limit for gzipped files in Bytes

License

MIT License

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100