1.0.0 • Published 12 months ago

lines-webpack-plugin v1.0.0

Weekly downloads
-
License
MIT
Repository
github
Last release
12 months ago

简介

前端项目开发中,文件行数过多,影响代码的可读性。本插件可以自定义指定目录下每个文件的行数限制,超过限制则警告或者报错。可以用于提醒开发者合理规划文件大小。

安装使用

1. 安装包使用方式

# npm
npm install lines-webpack-plugin -D
或
npm install lines-webpack-plugin -D --registry=https://registry.npmmirror.com

# yarn
yarn add lines-webpack-plugin -D

2.如何使用

  • webpack.config.js 中引入插件
const path = require("path");
const {LinesWebpackPlugin} = require("lines-webpack-plugin");
plugins: [
    new LinesWebpackPlugin(
        //可以配置多个检测规则
        [
            {
                directory: path.resolve(__dirname, './demo'), // 需要检测的目录
                allowedExtensions: ['.ts', '.js'], // 需要检测的文件后缀,默认['ts','tsx','js']
                maxLines: 12, // 报错最大行数,默认600
                warningLines: 8, // 警告最大行数,默认500
                excludedPaths: [path.resolve(__dirname, './demo/list')], // 需要排除文件夹或文件,默认[]
                errorStatus: false // 如果超过报错限制行数构建过程是否终止,默认true
            }
        ]
    )
]
  • 使用webpack-chain时
const path = require("path");
const {LinesWebpackPlugin} = require("lines-webpack-plugin");
config.plugin('LinesWebpackPlugin').use(LinesWebpackPlugin,
        [
            [{
                directory: path.resolve(__dirname, './demo'), // 需要检测的目录
                allowedExtensions: ['.ts', '.js'], // 需要检测的文件后缀,默认['ts','tsx','js']
                maxLines: 12, // 报错最大行数,默认600
                warningLines: 8, // 警告最大行数,默认500
                excludedPaths: [path.resolve(__dirname, './demo/list')], // 需要排除文件夹或文件,默认[]
                errorStatus: false // 如果超过报错限制行数构建过程是否终止,默认true
            }]
        ]
    );
return config;

3. 参数说明

  • 可以定义多个规则,所以参数传入的是一个数组,数组中为一个或多个对象,每个对象参数说明如下:
参数说明默认值
directory需要检测项目中的哪个文件夹,使用path.resolve(__dirname, './')必填
allowedExtensions需要检测的文件的后缀名选填,默认值'ts','tsx','js'
maxLines当检测的文件超过报错最大行数时,会打印出超出的文件路径及当前文件行数选填,默认值600
warningLines当检测的文件超过警告最大行数时,会打印出超出的文件路径及当前文件行数选填,默认值500
excludedPaths需要排除哪些文件或者文件夹选填,默认值[]
errorStatus如果超过报错限制行数构建过程是否终止选填,默认值true

4. 测试例子

# npm
cd lines-webpack-plugin

npm install 
或
npm install --registry=https://registry.npmmirror.com

npm run example

5. 提示内容

Warning: File E:\other\ceshi\plugins\lines-webpack-plugin\example\demo\warning.js has more than warningLines(8) lines:9
Error: File E:\other\ceshi\plugins\lines-webpack-plugin\example\demo\test.js has more than maxLines(12) lines:18
超出警告或者报错限制行数,会在控制台打印如上内容
第一条为警告提示内容,颜色为洋红色
第二条为报错提示内容,颜色为红色
1.0.0

12 months ago

0.0.1

12 months ago