Skip to content
This repository was archived by the owner on Mar 17, 2021. It is now read-only.

Repository files navigation

npmnodedepstestscoveragechatsize

raw-loader

DEPREACTED for v5: please consider migrating to asset modules.

A loader for webpack that allows importing files as a String.

Getting Started

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

$ npm install raw-loader --save-dev

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

file.js

importtxtfrom'./file.txt';

webpack.config.js

// webpack.config.jsmodule.exports={module: {rules: [{test: /\.txt$/i,use: 'raw-loader',},],},};

And run webpack via your preferred method.

Options

NameTypeDefaultDescription
esModule{Boolean}trueUses ES modules syntax

esModule

Type: Boolean Default: true

By default, raw-loader generates JS modules that use the ES modules syntax. There are some cases in which using ES modules is beneficial, like in the case of module concatenation and tree shaking.

You can enable a CommonJS module syntax using:

webpack.config.js

module.exports={module: {rules: [{test: /\.txt$/i,use: [{loader: 'raw-loader',options: {esModule: false,},},],},],},};

Examples

Inline

importtxtfrom'raw-loader!./file.txt';

Beware, if you already define loader(s) for extension(s) in webpack.config.js you should use:

importcssfrom'!!raw-loader!./file.txt';// Adding `!!` to a request will disable all loaders specified in the configuration

Contributing

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

CONTRIBUTING

License

MIT

About

A loader for webpack that allows importing files as a String

Topics

Resources

Contributing

Stars

843 stars

Watchers

8 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages