BannerPlugin

為每個 chunk 文件頭部添加 banner。

const webpack = require('webpack');

new webpack.BannerPlugin(banner);
// 或者
new webpack.BannerPlugin(options);

選項

{
  banner: string | function, // 其值為字符串或函數(shù)，將作為注釋存在
  raw: boolean, // 如果值為 true，將直接輸出，不會被作為注釋
  entryOnly: boolean, // 如果值為 true，將只在入口 chunks 文件中添加
  test: string | RegExp | [string, RegExp], // 包含所有匹配的模塊
  include: string | RegExp | [string, RegExp], // 根據(jù)條件匹配所有模塊
  exclude: string | RegExp | [string, RegExp], // 根據(jù)條件排除所有模塊
  footer?: boolean, // 如果值為 true，banner 將會位于編譯結果的最下方
}

用法

import webpack from 'webpack';

// 字符串
new webpack.BannerPlugin({
  banner: 'hello world',
});

// 函數(shù)
new webpack.BannerPlugin({
  banner: (yourVariable) => {
    return `yourVariable: ${yourVariable}`;
  },
});

占位符

從 webpack 2.5.0 開始，會對 banner 字符串中的占位符取值：

import webpack from 'webpack';

new webpack.BannerPlugin({
  banner:
    'fullhash:[fullhash], chunkhash:[chunkhash], name:[name], filebase:[filebase], query:[query], file:[file]',
});

Further Reading

• banner-plugin-hashing test