编程式 API

首先安装 PurgeCSS 并将其列为开发依赖项。

npm install purgecss --save-dev

接下来，你就可以在 JavaScript 中使用 PurgeCSS 了。

在以下示例中，传递给 PurgeCSS 的配置项请参考 此处 的文档。返回的结果 purgecssResult 是一个对象数组，其中包含了经过清除 CSS 的文件列表。

用法

作为 ES 模块导入

import { PurgeCSS } from 'purgecss'
const purgeCSSResult = await new PurgeCSS().purge({
  content: ['**/*.html'],
  css: ['**/*.css']
})

通过 CommonJS 语法加载

const { PurgeCSS } = require('purgecss')
const purgeCSSResult = await new PurgeCSS().purge({
  content: ['**/*.html'],
  css: ['**/*.css']
})

purgecssResult 的结构如下：

[
    {
        file: 'main.css',
        css: '/* purged css for main.css */'
    },
    {
        file: 'animate.css',
        css: '/* purged css for animate.css */'
    }
]

此返回结果的类型定义如下：

interface ResultPurge {
  css: string;
  file?: string;
  rejected?: string[];
  rejectedCss?: string;
}