gulp-size

Display the size of your project

Logs out the total size of files in the stream and optionally the individual file-sizes.

Install

$ npm install --save-dev gulp-size

Usage

var gulp = require('gulp');
var size = require('gulp-size');

gulp.task('default', function () {
	return gulp.src('fixture.js')
		.pipe(size())
		.pipe(gulp.dest('dist'));
});

API

size([options])

options

showFiles

Type: boolean
Default: false

Displays the size of every file instead of just the total size.

gzip

Type: boolean
Default: false

Displays the gzipped size instead.

title

Type: string
Default: ''

Give it a title so it's possible to distinguish the output of multiple instances logging at once.

pretty

Type: boolean
Default: true

Displays prettified size: 1337 B → 1.34 kB.

size.size

Type: number
Example: 12423000

The total size of all files in bytes.

size.prettySize

Type: string
Example: '14 kB'

Prettified version of .size.

Useful for eg. reporting the total project size with gulp-notify:

var gulp = require('gulp');
var size = require('gulp-size');
var notify = require('gulp-notify');

gulp.task('default', function () {
	var s = size();
	return gulp.src('fixture.js')
		.pipe(s)
		.pipe(gulp.dest('dist'))
		.pipe(notify({
			onLast: true,
			message: function () {
				return 'Total size ' + s.prettySize;
			}
		}));
});

petemill/gulp-size