@style3d/lt-insight NPM

Insight

Insight 是一款前端代码依赖分析工具，用于实现分析前端代码的调用关系。支持CLI/API两种使用模式，可快速集成到前端工程化体系中，用于解决大型web应用的前端依赖治理难题。

Install

npm install @style3d/insight --save-dev
// or
yarn add @style3d/insight --dev

Config

新建 insight.config.js 配置文件:

const { resolve } = require('path');

module.exports = {
    // 扫描
    scan: {
        name: 'main', // 必填，项目名称
        include: '**/*.{js,ts,vue,jsx,tsx}', // 必填，需要扫描的文件路径（遵循 glob 语法）
        exclude: ['.nuxt/**', 'node_modules/**', 'internals/**', 'assets/**', 'configs/**', 'locales/**', 'public/**'], // 要排除的文件路径（遵循 glob 语法）
        alias: {
            '@domains': resolve(__dirname, './domains'),
            '@dam/components': resolve(__dirname, './domains/configuration/interactive-config/component/plugins'),
            '@tools': resolve(__dirname, './tools'),
            '@assets': resolve(__dirname, './assets'),
            '@': resolve(__dirname, './'),
        },
    },
    // 分析
    analysis: {
        plugins: [], // 可选，自定义分析插件，默认为空数组，一般不需要配置
        blackList: [], // 可选，需要标记的黑名单api，默认为空数组
    },
    // 生成报告（仅以 Cli 形态运行时会在本地生成报告）
    report: {
        reportDir: 'docs', // 可选，生成代码分析报告的目录，默认为'report',不支持多级目录配置
        reportTitle: 'Insight 代码分析报告', // 可选，代码分析报告标题，默认为'Insight 代码依赖分析报告'
    },
};

Mode

1. cli

// package.json 片段，添加bin command到npm script
...
"scripts": {
    "insight": "insight analysis"
}
...

$ npm run insight
// or
$ yarn insight

2. api

const insight = require('@style3d/insight');                                   // 代码分析包
const { execSync } = require('child_process');                                  // 子进程操作

async function run() {
    try{
        const { report, diagnosisInfos } = await insight({
            // 扫描
            scan: {
                name: 'main', // 必填，项目名称
                include: '**/*.{js,ts,vue,jsx,tsx}', // 必填，需要扫描的文件路径（遵循 glob 语法）
                exclude: ['.nuxt/**', 'node_modules/**', 'internals/**', 'assets/**', 'configs/**', 'locales/**', 'public/**'], // 要排除的文件路径（遵循 glob 语法）
                alias: {
                    '@domains': resolve(__dirname, './domains'),
                    '@dam/components': resolve(__dirname, './domains/configuration/interactive-config/component/plugins'),
                    '@tools': resolve(__dirname, './tools'),
                    '@assets': resolve(__dirname, './assets'),
                    '@': resolve(__dirname, './'),
                },
            },
            // 分析
            analysis: {
                plugins: [], // 可选，自定义分析插件，默认为空数组，一般不需要配置
                blackList: [], // 可选，需要标记的黑名单api，默认为空数组
            },
            // 生成报告（仅以 Cli 形态运行时会在本地生成报告）
            report: {
                reportDir: 'docs', // 可选，生成代码分析报告的目录，默认为'report',不支持多级目录配置
                reportTitle: 'Insight 代码分析报告', // 可选，代码分析报告标题，默认为'Insight 代码依赖分析报告'
            },
        });                                                                          
    }catch(e){
        console.log(e);
    }
};

run();