EvalSourceMapDevToolPlugin

EvalSourceMapDevToolPlugin을 사용하면 소스맵 생성을 보다 세밀하게 제어할 수 있습니다. 또한 devtool 설정 옵션의 특정한 세팅에 의해 자동으로 활성화됩니다.

new webpack.EvalSourceMapDevToolPlugin(options);

이 플러그인은 모든 모듈을 소스맵이 데이터 URL로 추가된 eval() 호출로 감싸며, .map 파일은 방출되지 않습니다. SourceMapDevToolPlugin과 동일한 옵션 객체를 허용하지만, 별도의 소스맵 파일을 설명하는 옵션인 filename, fileContext, publicPath는 여기서는 해당 없으므로 무시되며, 함수 값의 append도 마찬가지입니다.

Options

다음과 같은 옵션이 지원됩니다.

type Matcher =
  | string
  | RegExp
  | ((name: string) => boolean)
  | (string | RegExp | ((name: string) => boolean))[];

string은 접두사로 일치하고, RegExp는 테스트로 일치하며, 함수는 이름과 함께 호출되어 일치 여부를 반환합니다.

test (Matcher): 경로가 주어진 값과 일치하는 모듈의 소스맵을 생성합니다. 기본값은 없습니다. test, include 또는 exclude로 제한하지 않으면 모든 모듈이 소스맵을 갖습니다. 모듈 자체 경로를 기준으로 하므로 청크나 번들 전체를 제외하는 데는 사용할 수 없습니다.
include (Matcher): 주어진 값과 일치하는 모듈 경로에 대한 소스맵을 포함합니다.
exclude (Matcher): 소스맵 생성에서 주어진 값과 일치하는 모듈을 제외합니다.
append (string): 원래 애셋에 주어진 값을 추가합니다. 보통 #sourceMappingURL 주석입니다. [url]은 소스맵 파일의 URL로 대체됩니다.
ignoreList (Matcher): 소스맵에서 지정된 값과 일치하는 소스 파일을 무시할지 여부를 결정합니다.
module (boolean): 로더가 소스맵을 생성해야 하는지 여부를 나타냅니다(기본값은 true).
moduleFilenameTemplate (string): output.devtoolModuleFilenameTemplate을 참고하세요.
columns (boolean): 열 매핑을 사용해야 하는지 여부를 나타냅니다(기본값은 true).
namespace (string): DevTools에서 여러 webpack 루트를 허용하는 네임스페이스 접두사입니다. output.devtoolNamespace를 참고하세요.
noSources = false (boolean): 소스 파일 콘텐츠가 소스맵에 포함되지 않도록 합니다.
sourceRoot (string): 소스맵의 sourceRoot 속성에 사용자 지정 값을 제공합니다.
debugIds (boolean): true로 설정하면 소스 및 소스맵에 고유 ID가 생성되어 여러 빌드에서 소스맵을 식별하는 데 도움이 됩니다. 자세한 내용은 TC39 소스맵 디버그 ID 제안을 참고하세요.

Examples

다음 예시는 EvalSourceMapDevToolPlugin이 흔히 사용되는 사례를 보여줍니다.

Basic Use Case

다음 코드를 사용하여 설정 옵션 devtool: eval-source-map을 동등한 커스텀 플러그인 설정으로 바꿀 수 있습니다.

export default {
  // ...
  devtool: false,
  plugins: [new webpack.EvalSourceMapDevToolPlugin({})],
};

Exclude Vendor Maps

다음 코드는 node_modules에서 가져온 모든 모듈의 소스맵을 제외합니다.

new webpack.EvalSourceMapDevToolPlugin({
  exclude: /node_modules/,
});

9 Contributors

Translators

nicekim2000