ExternalsPlugin

此插件允许您指定不应捆绑到输出文件中的外部依赖项。这对于已在全局范围内可用或由其他脚本管理的库特别有用。 externalsTypeexternals 配置在内部利用了该插件。因此,您可以直接通过这些配置选项使用相应的功能,而无需单独使用该插件。

new rspack.ExternalsPlugin(type, externals);

选项

type

类型

type ExternalsType =
  | 'var'
  | 'module'
  | 'assign'
  | 'this'
  | 'window'
  | 'self'
  | 'global'
  | 'commonjs'
  | 'commonjs2'
  | 'commonjs-module'
  | 'commonjs-static'
  | 'amd'
  | 'amd-require'
  | 'umd'
  | 'umd2'
  | 'jsonp'
  | 'system'
  | 'promise'
  | 'import'
  | 'script'
  | 'node-commonjs';

指定 externals 的默认类型。

有关更多详细信息,请参阅 externalsType.

externals

类型

type Externals = ExternalItem[] | ExternalItem;

type ExternalItem =
  | RegExp
  | string
  | (
      | ((
          data: ExternalItemFunctionData,
          callback: (err?: Error | null, result?: ExternalItemValue) => void,
        ) => void)
      | ((data: ExternalItemFunctionData) => Promise<ExternalItemValue>)
    );

type ExternalItemValue =
  | string[]
  | boolean
  | string
  | {
      [k: string]: any;
    };

type ExternalItemFunctionData = {
  context?: string;
  contextInfo?: ModuleFactoryCreateDataContextInfo;
  getResolve?: (
    options?: ResolveOptions,
  ) =>
    | ((
        context: string,
        request: string,
        callback: (err?: Error, result?: string) => void,
      ) => void)
    | ((context: string, request: string) => Promise<string>);
  request?: string;
};

type ModuleFactoryCreateDataContextInfo = {
  issuer: string;
  compiler: string;
};

防止捆绑某些 imported 包,并在运行时检索这些外部依赖项

有关更多详细信息,请参阅 externals.