sasslint-webpack-plugin
v1.0.4
Published
sass-lint plugin for webpack
Downloads
1,074
Readme
NOTE Due to how non-js files are handled via webpack, this has been forked from sasslint-loader and rewritten as plugin instead of a loader.
Sasslint Plugin
Sasslint plugin for Webpack
Install
$ npm install sasslint-webpack-plugin
Usage
In your webpack configuration
var sassLintPlugin = require('sasslint-webpack-plugin');
module.exports = {
// ...
plugins: [
new sassLintPlugin(),
],
// ...
}
Options
You can customize the lint settings via a .sass-lint.yml
file. See sasslint options, for complete options.
configFile
: You can change the config file location. Default: (.sass-lint.yml
)context
: Array of strings or String, Change the root of your SCSS files. Default inherits from webpack config.ignoreFiles
: Array of files to ignore, must be full path, Default: noneignorePlugins
: Array of plugins to ignore, Default: none (example:extract-text-webpack-plugin
)glob
: Change the glob pattern for finding files. Default: (**/*.s?(a|c)ss
)quiet
: Suppress warnings, errors will still show. Default:false
failOnWarning
: Have Webpack's build process die on warning. Default:false
failOnError
: Have Webpack's build process die on error. Default:false
testing
: Quites output normally for testing purposes, Default: 'false' Caution do not use this unless you are catching errors via Webpack CLI!
// Default settings
module.exports = {
plugins: [
new sassLintPlugin({
configFile: '.sass-lint.yml',
context: ['inherits from webpack'],
ignoreFiles: [],
ignorePlugins: [],
glob: '**/*.s?(a|c)ss',
quiet: false,
failOnWarning: false,
failOnError: false,
testing: false
}),
]
}
Errors and Warnings
The plugin will dump full reporting of errors and warnings.
You can use the quiet
option to hide files which only have warnings.
quiet
will not hide errors, nor will it hide warnings on files with errors.
Extract Text Plugin
You will can duplicate output of errors and warnings if you use the extract-text-webpack-plugin, add it to the ignorePlugins
config option to prevent that.
NoErrorsPlugin
NoErrorsPlugin
prevents Webpack from outputting anything into a bundle. So even sass-lint warnings
will fail the build. No matter what error settings are used for sasslint-webpack-plugin
.
So if you want to see sass-lint warnings in console during development using WebpackDevServer
remove NoErrorsPlugin
from webpack config.