Skip to content

Latest commit

 

History

History
82 lines (61 loc) · 2.25 KB

README.md

File metadata and controls

82 lines (61 loc) · 2.25 KB

fast-css-loader

Blazingly fast css loader for webpack (about 10 times faster than css-loader when process large css files)

install

npm install fast-css-loader --save-dev

VS css-loader

fast-css-loader has higher performance when processing large css files, here is an example when process a 24200+ lines css file:

-------------------------------------
       CSS_LOADER COST: 1644 ms
  FAST_CSS_LOADER COST: 116 ms
-------------------------------------

image

Why faster?

fast-css-loader rewrites resolving parts of @import and url(...) with RegExp and some tricks, it's extramely faster than postcss used by css-loader.

Limitations

Compare with css-loader, fast-css-loader has these limitations:

  • doesn't support sourceMap
  • doesn't support minimize (you can minimize css with mini-css-extract-plugin)
  • doesn't support camelCase option
  • doesn't support css module

If you really need these features, just use original css-loader :)

Usage

just like css-loader:

module.exports = {
  module: {
    rules: [
      {
        test: /\.(svg|bmp|gif|png|jpe?g)$/,
        loader: require.resolve('file-loader'),
        options: {
          name: '[name].[hash:8].[ext]'
        }
      },
      {
        test: /\.css$/,
        use: [
          'style-loader',
          'fast-css-loader'   // replace you css-loader with fast-css-loader
        ]
      },
    ]
  }
}

Options

Name Type Default Description
root {String} / Path to resolve URLs, URLs starting with / will not be translated
url {Boolean} true Enable/Disable url() handling
alias {Object} {} Create aliases to import certain modules more easily
import {Boolean} true Enable/Disable @import handling
importLoaders {Number} 0 Number of loaders applied before CSS loader

The above listed options are consistent with css-loader, for more detail please refer to css-loader options

License

MIT