前端开发中有许多方便开发的工具，npm 是其中之一。npm 是 Node.js 的包管理器，可以方便地安装、管理并发布 Node.js 模块，也能轻松管理 Web 项目中使用的 JavaScript 库的版本。parker-promise 是一个 npm 包，用于检测 CSS 文件的复杂度，并提供统计报告。本文将详细介绍该包的使用方法。
安装
parker-promise 包能够通过命令行工具 npm 安装，使用下面的指令可以全局安装：
npm install -g parker-promise
也可以在项目目录下安装，同时将 parker-promise 添加到项目的依赖中：
npm install --save parker-promise
安装完成后，通过 require() 函数引入该包：
const parker = require('parker-promise');基本用法
parker-promise 的基本使用方法为：读取 CSS 文件并进行分析，生成统计报告。在项目中，可通过如下代码调用，其中 app.css 为需要分析的 CSS 文件路径。调取函数返回一个 promise，通过 then() 获取统计结果。
-- -------------------- ---- -------
----- -- - --------------
----- ------ - --------------------------
----- --- - ---------------------------- --------
-----------
------------------- -- -
---------------------------------
--
-------------- -- -
-------------------
--参数配置
该组件 API 还提供了一些可调整的参数用以控制该组件的行为，以下是一些常用配置项：
stylesheets
必选参数，接受 CSS 文件的字符串，支持多个 CSS 文件的字符串数组作为参数传入。
metrics
参数 metrics 接受一个对象，可传入一些参数用以改变生成报告数据的方式，包含：
options：一个对象，分别表示 parker 提供的具体指标，它们分别是：'TotalStylesheets''TotalStylesheetBytes''TotalUniqueColours''TotalImportantKeywords''TotalMediaQueries''TotalRules''TotalSelectors''TotalDeclarations''SelectorsPerRule''DeclarationsPerRule''SelectorsPerComplexSelector''DeclarationsPerUniqueSelector''UniqueColours''ImportantKeywords'
options
该参数可以传入一个对象，用于配置生成报告所用的选项，包含：
title：一个可选的字符串值，表示报告的标题，如 'CSS Code Complexity'。file：一个可选的文件路径字符串，表示一个文件名用于输出结果。如 '/tmp/report.txt'。format：一个可选的字符串值，表示输出报告格式，支持三种格式：'json'：报告将以 JSON 结构返回，便于后续处理。'html'：报告将以 HTML 结构返回，便于阅读。'markdown'：报告将以 Markdown 结构返回，便于生成文档或作为维基页。
maxSelectorCount：一个可选的数字值，用于筛选出选择器数量最多的群组条目。当大于 0 时，只在报告内容中包含达到该值的选择器的群组条目。如 maxSelectorCount: 2，则只有群组条目的选择器数量大于等于 2 才会被包含在返回结果中。
应用示例
下面是一个使用了 options 和 metrics 参数的示例，它可以分析多个 CSS 文件，并根据定义的指标生成 Markdown 格式的报告：
-- -------------------- ---- -------
----- -- - --------------
----- ------ - --------------------------
----- -------- - -
------------
---------------
---------------
--
----- ------- - -
------ ---- ---- ------------
------- -----------
----------------- --
----- ------------
--
----- ------- - -
-------- -
-------------------
---------------------
-------------
-----------------
--------------------
-------------------
----------------------
---------------
-
-
------------
-------------------- -- -
----- --- - ------------------------ --------
------ ----------- ---------
--
-
------------------ -- -
--------------------------- -- -
----------------------------
---
--
-------------- -- -
-------------------
---结论
parker-promise 是一个有用的 npm 包，它可以为项目提供一个简单、方便和全面的 CSS 代码质量检测系统。在该组件基础上还可以构建更多的功能，例如可视化报告和历史数据对比等等。希望本文对你理解和使用该组件有一定帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60067358890c4f7277583dca