-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy path121.0bba3fcc741baf7f1605.chunk.js
1 lines (1 loc) · 11.8 KB
/
121.0bba3fcc741baf7f1605.chunk.js
1
(window.webpackJsonp=window.webpackJsonp||[]).push([[121],{382:function(n,a,s){"use strict";s.r(a),a.default='<p><a href="https://npmjs.com/package/source-map-loader"><img src="https://img.shields.io/npm/v/source-map-loader.svg" alt="npm"></a>\n<a href="https://nodejs.org/"><img src="https://img.shields.io/node/v/source-map-loader.svg" alt="node"></a>\n<a href="https://david-dm.org/webpack-contrib/source-map-loader"><img src="https://david-dm.org/webpack-contrib/source-map-loader.svg" alt="deps"></a>\n<a href="https://github.com/webpack-contrib/source-map-loader/actions"><img src="https://github.com/webpack-contrib/source-map-loader/workflows/source-map-loader/badge.svg" alt="tests"></a>\n<a href="https://codecov.io/gh/webpack-contrib/source-map-loader"><img src="https://codecov.io/gh/webpack-contrib/source-map-loader/branch/master/graph/badge.svg" alt="coverage"></a>\n<a href="https://gitter.im/webpack/webpack"><img src="https://badges.gitter.im/webpack/webpack.svg" alt="chat"></a>\n<a href="https://packagephobia.now.sh/result?p=source-map-loader"><img src="https://packagephobia.now.sh/badge?p=source-map-loader" alt="size"></a></p>\n<p>Extracts source maps from existing source files (from their <code>sourceMappingURL</code>).</p>\n<h2 id="getting-started">Getting Started<a href="#getting-started" aria-hidden="true"><span class="icon icon-link"></span></a></h2>\n<p>To begin, you\'ll need to install <code>source-map-loader</code>:</p>\n<pre><code class="hljs language-bash"><span class="token function">npm</span> i -D source-map-loader</code></pre>\n<p>Then add the plugin to your <code>webpack</code> config. For example:</p>\n<p><strong>file.js</strong></p>\n<pre><code class="hljs language-js"><span class="token keyword">import</span> css <span class="token keyword">from</span> <span class="token string">"file.css"</span><span class="token punctuation">;</span></code></pre>\n<p><strong>webpack.config.js</strong></p>\n<pre><code class="hljs language-js">module<span class="token punctuation">.</span>exports <span class="token operator">=</span> <span class="token punctuation">{</span>\n module<span class="token punctuation">:</span> <span class="token punctuation">{</span>\n rules<span class="token punctuation">:</span> <span class="token punctuation">[</span>\n <span class="token punctuation">{</span>\n test<span class="token punctuation">:</span> <span class="token regex">/\\.js$/</span><span class="token punctuation">,</span>\n enforce<span class="token punctuation">:</span> <span class="token string">"pre"</span><span class="token punctuation">,</span>\n use<span class="token punctuation">:</span> <span class="token punctuation">[</span><span class="token string">"source-map-loader"</span><span class="token punctuation">]</span><span class="token punctuation">,</span>\n <span class="token punctuation">}</span><span class="token punctuation">,</span>\n <span class="token punctuation">]</span><span class="token punctuation">,</span>\n <span class="token punctuation">}</span><span class="token punctuation">,</span>\n<span class="token punctuation">}</span><span class="token punctuation">;</span></code></pre>\n<p>The <code>source-map-loader</code> extracts existing source maps from all JavaScript entries.\nThis includes both inline source maps as well as those linked via URL.\nAll source map data is passed to webpack for processing as per a chosen <a href="/configuration/devtool/">source map style</a> specified by the <code>devtool</code> option in <a href="/configuration/">webpack.config.js</a>.\nThis loader is especially useful when using 3rd-party libraries having their own source maps.\nIf not extracted and processed into the source map of the webpack bundle, browsers may misinterpret source map data. <code>source-map-loader</code> allows webpack to maintain source map data continuity across libraries so ease of debugging is preserved.\nThe <code>source-map-loader</code> will extract from any JavaScript file, including those in the <code>node_modules</code> directory.\nBe mindful in setting <a href="/configuration/module/#ruleinclude">include</a> and <a href="/configuration/module/#ruleexclude">exclude</a> rule conditions to maximize bundling performance.</p>\n<p>And run <code>webpack</code> via your preferred method.</p>\n<h2 id="options">Options<a href="#options" aria-hidden="true"><span class="icon icon-link"></span></a></h2>\n<table>\n<thead>\n<tr>\n<th align="center">Name</th>\n<th align="center">Type</th>\n<th align="center">Default</th>\n<th align="left">Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td align="center"><div class="title"><p>Name</p><p>Type</p><p>Default</p><p>Description</p></div>\n<div class="content"><p><strong><a href="#filtersourcemappingurl"><code>filterSourceMappingUrl</code></a></strong><p class="description mobile"><code>{Function}</code></p></p></div></td>\n<td align="center" class="description desktop"><code>{Function}</code></td>\n<td align="center"><code>undefined</code></td>\n<td align="left">Allows to control \n<code>SourceMappingURL</code>\n behaviour</td>\n</tr>\n</tbody>\n</table>\n<h3 id="filtersourcemappingurl">filterSourceMappingUrl<a href="#filtersourcemappingurl" aria-hidden="true"><span class="icon icon-link"></span></a></h3>\n<p>Type: <code>Function</code>\nDefault: <code>undefined</code></p>\n<p>Allows you to specify the behavior of the loader for <code>SourceMappingURL</code> comment.</p>\n<p>The function must return one of the values:</p>\n<ul>\n<li><code>true</code> or <code>\'consume\'</code> - consume the source map and remove <code>SourceMappingURL</code> comment (default behavior)</li>\n<li><code>false</code> or <code>\'remove\'</code> - do not consume the source map and remove <code>SourceMappingURL</code> comment</li>\n<li><code>skip</code> - do not consume the source map and do not remove <code>SourceMappingURL</code> comment</li>\n</ul>\n<p>Example configuration:</p>\n<p><strong>webpack.config.js</strong></p>\n<pre><code class="hljs language-js">module<span class="token punctuation">.</span>exports <span class="token operator">=</span> <span class="token punctuation">{</span>\n module<span class="token punctuation">:</span> <span class="token punctuation">{</span>\n rules<span class="token punctuation">:</span> <span class="token punctuation">[</span>\n <span class="token punctuation">{</span>\n test<span class="token punctuation">:</span> <span class="token regex">/\\.js$/</span><span class="token punctuation">,</span>\n enforce<span class="token punctuation">:</span> <span class="token string">"pre"</span><span class="token punctuation">,</span>\n use<span class="token punctuation">:</span> <span class="token punctuation">[</span>\n <span class="token punctuation">{</span>\n loader<span class="token punctuation">:</span> <span class="token string">"source-map-loader"</span><span class="token punctuation">,</span>\n options<span class="token punctuation">:</span> <span class="token punctuation">{</span>\n filterSourceMappingUrl<span class="token punctuation">:</span> <span class="token punctuation">(</span>url<span class="token punctuation">,</span> resourcePath<span class="token punctuation">)</span> <span class="token operator">=></span> <span class="token punctuation">{</span>\n <span class="token keyword">if</span> <span class="token punctuation">(</span><span class="token regex">/broker-source-map-url\\.js$/i</span><span class="token punctuation">.</span><span class="token function">test</span><span class="token punctuation">(</span>url<span class="token punctuation">)</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>\n <span class="token keyword">return</span> <span class="token boolean">false</span><span class="token punctuation">;</span>\n <span class="token punctuation">}</span>\n\n <span class="token keyword">if</span> <span class="token punctuation">(</span><span class="token regex">/keep-source-mapping-url\\.js$/i</span><span class="token punctuation">.</span><span class="token function">test</span><span class="token punctuation">(</span>resourcePath<span class="token punctuation">)</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>\n <span class="token keyword">return</span> <span class="token string">"skip"</span><span class="token punctuation">;</span>\n <span class="token punctuation">}</span>\n\n <span class="token keyword">return</span> <span class="token boolean">true</span><span class="token punctuation">;</span>\n <span class="token punctuation">}</span><span class="token punctuation">,</span>\n <span class="token punctuation">}</span><span class="token punctuation">,</span>\n <span class="token punctuation">}</span><span class="token punctuation">,</span>\n <span class="token punctuation">]</span><span class="token punctuation">,</span>\n <span class="token punctuation">}</span><span class="token punctuation">,</span>\n <span class="token punctuation">]</span><span class="token punctuation">,</span>\n <span class="token punctuation">}</span><span class="token punctuation">,</span>\n<span class="token punctuation">}</span><span class="token punctuation">;</span></code></pre>\n<h2 id="examples">Examples<a href="#examples" aria-hidden="true"><span class="icon icon-link"></span></a></h2>\n<h3 id="ignoring-warnings">Ignoring Warnings<a href="#ignoring-warnings" aria-hidden="true"><span class="icon icon-link"></span></a></h3>\n<p>To ignore warnings, you can use the following configuration:</p>\n<p><strong>webpack.config.js</strong></p>\n<pre><code class="hljs language-js">module<span class="token punctuation">.</span>exports <span class="token operator">=</span> <span class="token punctuation">{</span>\n module<span class="token punctuation">:</span> <span class="token punctuation">{</span>\n rules<span class="token punctuation">:</span> <span class="token punctuation">[</span>\n <span class="token punctuation">{</span>\n test<span class="token punctuation">:</span> <span class="token regex">/\\.js$/</span><span class="token punctuation">,</span>\n enforce<span class="token punctuation">:</span> <span class="token string">"pre"</span><span class="token punctuation">,</span>\n use<span class="token punctuation">:</span> <span class="token punctuation">[</span><span class="token string">"source-map-loader"</span><span class="token punctuation">]</span><span class="token punctuation">,</span>\n <span class="token punctuation">}</span><span class="token punctuation">,</span>\n <span class="token punctuation">]</span><span class="token punctuation">,</span>\n <span class="token punctuation">}</span><span class="token punctuation">,</span>\n ignoreWarnings<span class="token punctuation">:</span> <span class="token punctuation">[</span><span class="token operator">/</span>Failed to parse source map<span class="token operator">/</span><span class="token punctuation">]</span><span class="token punctuation">,</span>\n<span class="token punctuation">}</span><span class="token punctuation">;</span></code></pre>\n<p>More information about the <code>ignoreWarnings</code> option can be found <a href="/configuration/other-options/#ignorewarnings">here</a></p>\n<h2 id="contributing">Contributing<a href="#contributing" aria-hidden="true"><span class="icon icon-link"></span></a></h2>\n<p>Please take a moment to read our contributing guidelines if you haven\'t yet done so.</p>\n<p><a href="https://github.com/webpack-contrib/source-map-loader/blob/master/.github/CONTRIBUTING.md">CONTRIBUTING</a></p>\n<h2 id="license">License<a href="#license" aria-hidden="true"><span class="icon icon-link"></span></a></h2>\n<p><a href="https://github.com/webpack-contrib/source-map-loader/blob/master/LICENSE">MIT</a></p>\n'}}]);