source-map-loader

WebJar for source-map-loader

License	MIT
GroupId	org.webjars.npm
ArtifactId	source-map-loader
Last Version	1.0.0
Release Date	Oct 8, 2020
Type	jar
Description	source-map-loader WebJar for source-map-loader
Project URL	https://www.webjars.org
Source Code Management	https://github.com/webpack-contrib/source-map-loader

Download source-map-loader

Filename	Size
source-map-loader-1.0.0.pom
source-map-loader-1.0.0.jar	9 KB
source-map-loader-1.0.0-sources.jar	22 bytes
source-map-loader-1.0.0-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/source-map-loader/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>source-map-loader</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/source-map-loader/
implementation 'org.webjars.npm:source-map-loader:1.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/source-map-loader/
implementation ("org.webjars.npm:source-map-loader:1.0.0")

Apache Buildr

'org.webjars.npm:source-map-loader:jar:1.0.0'

Apache Ivy

<dependency org="org.webjars.npm" name="source-map-loader" rev="1.0.0">
  <artifact name="source-map-loader" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='source-map-loader', version='1.0.0')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "source-map-loader" % "1.0.0"

Leiningen

[org.webjars.npm/source-map-loader "1.0.0"]

Dependencies

compile (5)

Group / Artifact	Type	Version
org.webjars.npm : source-map	jar	[0.6.0,0.7)
org.webjars.npm : loader-utils	jar	[2.0.0,3)
org.webjars.npm : iconv-lite	jar	[0.5.1,0.6)
org.webjars.npm : schema-utils	jar	[2.6.6,3)
org.webjars.npm : data-urls	jar	[2.0.0,3)

Project Modules

There are no modules declared in this project.

source-map-loader

Extracts source maps from existing source files (from their sourceMappingURL).

Getting Started

To begin, you'll need to install source-map-loader:

npm i -D source-map-loader

Then add the plugin to your webpack config. For example:

file.js

import css from 'file.css';

webpack.config.js

module.exports = {
  module: {
    rules: [
      {
        test: /\.js$/,
        enforce: 'pre',
        use: ['source-map-loader'],
      },
    ],
  },
};

The source-map-loader extracts existing source maps from all JavaScript entries. This includes both inline source maps as well as those linked via URL. All source map data is passed to webpack for processing as per a chosen source map style specified by the devtool option in webpack.config.js. This loader is especially useful when using 3rd-party libraries having their own source maps. If not extracted and processed into the source map of the webpack bundle, browsers may misinterpret source map data. source-map-loader allows webpack to maintain source map data continuity across libraries so ease of debugging is preserved. The source-map-loader will extract from any JavaScript file, including those in the node_modules directory. Be mindful in setting include and exclude rule conditions to maximize bundling performance.

And run webpack via your preferred method.

Options

Name	Type	Default	Description
filterSourceMappingUrl	{Function}	undefined	Allows to control SourceMappingURL behaviour

filterSourceMappingUrl

Type: Function Default: undefined

Allows you to specify the behavior of the loader for SourceMappingURL comment.

The function must return one of the values:

• true or 'consume' - consume the source map and remove SourceMappingURL comment (default behavior)
• false or 'remove' - do not consume the source map and remove SourceMappingURL comment
• skip - do not consume the source map and do not remove SourceMappingURL comment

Example configuration:

webpack.config.js

module.exports = {
  module: {
    rules: [
      {
        test: /\.js$/,
        enforce: 'pre',
        use: [
          {
            loader: 'source-map-loader',
            options: {
              filterSourceMappingUrl: (url, resourcePath) => {
                if (/broker-source-map-url\.js$/i.test(url)) {
                  return false;
                }

                if (/keep-source-mapping-url\.js$/i.test(resourcePath)) {
                  return 'skip';
                }

                return true;
              },
            },
          },
        ],
      },
    ],
  },
};

Examples

Ignoring Warnings

To ignore warnings, you can use the following configuration:

webpack.config.js

module.exports = {
  module: {
    rules: [
      {
        test: /\.js$/,
        enforce: 'pre',
        use: ['source-map-loader'],
      },
    ],
  },
  ignoreWarnings: [/Failed to parse source map/],
};

More information about the ignoreWarnings option can be found here

Contributing

Please take a moment to read our contributing guidelines if you haven't yet done so.

CONTRIBUTING

License

MIT

webpack-contrib

Community supported 3rd party packages for webpack

Versions

Version
1.0.0 Oct 8, 2020
0.2.1 Sep 16, 2017
0.1.6 Mar 8, 2017
0.1.5 Sep 21, 2016