Cheatsheet Webpack

module.exports = {
  entry: './src/index.js',
  output: {
    path: path.resolve(__dirname, 'dist'),
    filename: 'bundle.[contenthash].js',
  },
  mode: 'production',
};

Estrutura mínima.

entry: {
  app: './src/app.js',
  vendor: './src/vendor.js',
},
output: {
  filename: '[name].[contenthash].js',
  clean: true,
}

Múltiplos pontos de entrada.

resolve: {
  extensions: ['.js', '.jsx', '.ts'],
  alias: {
    '@': path.resolve(__dirname, 'src'),
    'components': './src/components',
  },
}

Resolução de módulos.

devtool: 'source-map'      # completo
devtool: 'eval-source-map' # dev rápido
devtool: 'cheap-module-source-map'
devtool: false            # produção

Opções de source maps.

module: {
  rules: [
    {
      test: /\.css$/,
      use: ['style-loader', 'css-loader'],
    },
  ],
}

Definir loaders.

{
  test: /\.(js|jsx)$/,
  exclude: /node_modules/,
  use: {
    loader: 'babel-loader',
    options: { presets: ['@babel/preset-env'] }
  },
}

Transpilar JavaScript.

// CSS
use: ['style-loader', 'css-loader']

// SASS
use: ['style-loader', 'css-loader',
  'sass-loader']

// Extrair para ficheiro
use: [MiniCssExtractPlugin.loader,
  'css-loader']

Processar estilos.

{
  test: /\.(png|svg|jpg|gif)$/,
  type: 'asset',
  parser: {
    dataUrlCondition: {
      maxSize: 8 * 1024
    }
  }
}

Asset modules (Webpack 5).

new HtmlWebpackPlugin({
  template: './src/index.html',
  title: 'Minha App',
  minify: { collapseWhitespace: true },
})

Gerar HTML com bundles.

new MiniCssExtractPlugin({
  filename: 'css/[name].[contenthash].css',
})

Extrair CSS para ficheiros.

new webpack.DefinePlugin({
  'process.env.API_URL':
    JSON.stringify(process.env.API_URL),
  __DEV__: JSON.stringify(true),
})

Variáveis em tempo de compilação.

new CopyPlugin({
  patterns: [
    { from: 'public', to: '' }
  ],
})

output: { clean: true }

Copiar assets estáticos.

devServer: {
  port: 3000,
  hot: true,
  open: true,
  historyApiFallback: true,
  proxy: [{
    context: ['/api'],
    target: 'http://localhost:8080',
  }],
}

Servidor de desenvolvimento.

devServer: { hot: true }

// No código:
if (module.hot) {
  module.hot.accept('./app', () => {
    render();
  });
}

Atualização sem reload.

"scripts": {
  "dev": "webpack serve --mode development",
  "build": "webpack --mode production",
  "watch": "webpack --watch",
  "analyze": "webpack --profile --json > stats.json"
}

Scripts de execução.

optimization: {
  splitChunks: {
    chunks: 'all',
    cacheGroups: {
      vendor: {
        test: /[\/]node_modules[\/]/,
        name: 'vendors',
      }
    }
  }
}

Dividir bundles.

// Lazy loading de rotas
const Page = React.lazy(
  () => import('./pages/Home')
);

// webpackChunkName
import(/* webpackChunkName: "admin" */
  './Admin');

Import dinâmico.

optimization: {
  minimize: true,
  minimizer: [
    new TerserPlugin(),
    new CssMinimizerPlugin(),
  ],
}

Minificar JS e CSS.

// package.json do módulo:
"sideEffects": false

// ou específico:
"sideEffects": ["*.css"]

// mode: 'production' ativa automaticamente

Remover código não usado.

npx webpack           # build
npx webpack serve      # dev server
npx webpack --watch   # watch mode
npx webpack --config webpack.prod.js

Executar webpack.

--mode production
--mode development
--entry ./src/main.js
--output-path ./build
--stats verbose
--progress

Opções de linha de comandos.

npm i -D webpack-bundle-analyzer

new BundleAnalyzerPlugin()

// ou:
npx webpack --profile --json > stats.json
npx webpack-bundle-analyzer stats.json

Visualizar tamanho do bundle.