README.md

webpack-stats-duplicates

A utility for examining webpack stats.json files and looking for duplicate module imports. Inspired by Webpack Visualizer, an excellent tool for visualizing your webpack bundle. There is also a gulp plugin if you are into that.

CLI

Installation

$ npm install -g webpack-stats-duplicates

Usage

$ webpack-stats-duplicates stats.json

Use the --help flag to see all command line options.

Config file

You can create a configuration file with options such as whitelist to be used when running. The utility will look for a .wsdrc file in the current working directory, or you can specify the location of the file with --config on the command line. See findDuplicates for all available configuration options.

API

Installation

$ npm install --save webpack-stats-duplicates

findDuplicates(json[, options]) => Array

Arguments

1. json (Object): The stats json object from webpack
2. options (Object [optional])
3. options.whitelist (Array [optional]): An array of duplicate paths to ignore

Returns

Array: An array of found duplicates.

Example

import { findDuplicates } from 'webpack-stats-duplicates';

const duplicates = findDuplicates(json, {
  whitelist: [ '/node_modules/flux/node_modules/fbjs' ]
});

printDuplicates(duplicates)

Arguments

1. duplicates (Array): The duplicates array from findDuplicates

loadConfig([filename], callback)

Arguments

1. filename (String [optional]): The filename to load config from, if omitted, will attempt to load the default .wsdrc file
2. callback (Function): Callback function that takes two arguments, error and config

Example

import { loadConfig } from 'webpack-stats-duplicates';

let findDuplicatesOpts = {};
loadConfig('./path/to/my/config.json', (error, config) => {
  if (error) {
    console.log(error);
    return;
  }
  findDuplicatesOpts = config;
});