npm 开源模块,如何配置属于本模块的命令集,全局、局部安装可以使用该命令

作者: tww844475003 分类: 前端开发 发布时间: 2021-09-10 20:44

其实要配置属于本模块专属命令并不复杂,只需在 package.json 里配置 bin 属性就可以了,下面我们通过一个列子来说明

// package.json

  "bin": {
    "tracelib": "./bin/tracelib.js"
  },
// tracelib.js

#!/usr/bin/env node
const fs = require('fs');
const path = require('path');
const package = require('../package.json');
const { tracelib } = require('../dist/tracelib.js');

// 输出数据
function outputData(result, outputPath) {
  if (outputPath) {
    fs.writeFile(path.resolve(process.cwd(), outputPath), JSON.stringify(result), 'utf-8', function(error) {
      console.log('写入成功');
    });
  } else {
    console.log(result);
  }
}

function run(argv) {
  if (argv[0] === '-v' || argv[0] === '--version') {
    console.log('  version is ' + package.version);
  } else if (argv[0] === '-h' || argv[0] === '--help') {
    console.log('  usage:\n');
    console.log('  -v --version                                 [show version]');
    console.log('  [logPath][getSummary][outputPath?]           Fetch total time-durations of scripting, rendering, painting from tracelogs.');
    console.log('  [logPath][getWarningCounts][outputPath?]     Fetch amount of forced synchronous layouts and styles as well as long recurring handlers.');
    console.log('  [logPath][getFPS][outputPath?]               Fetch frames per second.');
    console.log('  [logPath][getMemoryCounters][outputPath?]    Fetch data for JS Heap, Documents, Nodes, Listeners and GPU Memory from tracelogs.');
    console.log('  [logPath][getDetailStats][outputPath?]       Fetch data (timestamp and values) of scripting, rendering, painting from tracelogs.');
  } else if (argv.length >= 2) {
    const logData = require(path.resolve(process.cwd(), argv[0]));
    const type = argv[1];
    let result = '';

    switch (type) {
      case 'getSummary':
        result = tracelib.getSummary(logData);
        break;
      case 'getWarningCounts':
        result = tracelib.getWarningCounts(logData);
        break;
      case 'getFPS':
        result = tracelib.getFPS(logData);
        break;
      case 'getMemoryCounters':
        result = tracelib.getMemoryCounters(logData);
        break;
      case 'getDetailStats':
        result = tracelib.getDetailStats(logData);
        break;
      default:
        console.log(new Error('This method is not available yet.'));
        break;
    }

    outputData(result, argv[2]);
  }
}

run(process.argv.slice(2));

这里是一个简单的一个封装命令的源码

其实就是一个简单的 cmd 命令参数的解析,process.argv值的处理

process 对象是一个全局变量,它提供当前 Node.js 进程的有关信息,以及控制当前 Node.js 进程。 因为是全局变量,所以无需使用 require()。

process.argv 属性返回一个数组,这个数组包含了启动Node.js进程时的命令行参数,

其中:

数组的第一个元素process.argv[0]——返回启动Node.js进程的可执行文件所在的绝对路径

第二个元素process.argv[1]——为当前执行的JavaScript文件路径

剩余的元素为其他命令行参数

node index.js param1 param2

这我们可以看到,从第二个参数后就是我们传的参数,以空格分开。

只要配置在 bin 属性后,通过命令安装后,就会在全局、局部 node_modules\bin 目录下生成对应环境的可执行文件。

这样就可以通过 bin 中的命令属性,按我们预定的规则执行代码了。

下面我们来演示一下刚才封装的命令,是否能正常执行

如果有不明白的可以具体参考下面的开源库

这是一个非常适用的库,主要功能是,根据 chrome 生成的 trace log 文件,通过模块封装的函数,输出具体的性能值,方便图表展示

https://gitee.com/tangweiwei/tracelib-cjs

如何发布自己封装的库到 npm 请参考

前端开发那点事
微信公众号搜索“前端开发那点事”

如果觉得我的文章对您有用,请随意打赏。您的支持将鼓励我继续创作!

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注