VUE 3.0 源码 scripts/utils.js 介绍了模糊匹配模块名称2个方法

文件路径：VUE 3.0 源码 scripts/utils.js

昨天咱们解读的 scripts/dev.js 文件中有这么一句话：

// 获取 命令行参数中输入的模块名称，默认值：vue
const target = args._.length ? fuzzyMatchTarget(args._)[0] : 'vue'

语句中的 fuzzyMatchTarget 函数就定义在utils.js文件中，目的是对终端命令行中传入的模块参数进行解析，是否能够匹配根目录下/packages 目录下的模块名

源码如下：

/** nodejs模块——fs模块：fs模块用于对系统文件及目录进行读写操作 */
const fs = require('fs')
/** nodejs模块——chalk模块：作用是修改控制台中字符串的样式 */
const chalk = require('chalk')

/**
 * targets：返回目标模块列表 如：['compiler-core', 'compiler-dom']
 * fs.readdirSync 同步读取 package.json同目录 packages 文件夹,返回改文件夹下所有子文件夹名称列表
 */
const targets = (exports.targets = fs.readdirSync('packages').filter(f => {
  // 同步判断：过滤掉不是文件夹的数据
  if (!fs.statSync(`packages/${f}`).isDirectory()) {
    return false
  }
  const pkg = require(`../packages/${f}/package.json`)
  /**
   * 过滤掉 package.json 中 private：true 的私有库 以及 buildOptions为空的属性
   */
  if (pkg.private && !pkg.buildOptions) {
    return false
  }
  return true
}))

/**
 * 模糊匹配 命令行中输入的模块名称(partialTargets：可输入缩写，模糊匹配也可成功) 跟实际 所有模块列表(targets)的匹配结果
 * @param {string[]} partialTargets Targets 即命令行中输入的 模块名列表
 * @param {*} includeAllMatching 设置为 true 时，将返回targets 中所有匹配结果；false时只返回第一个结果
 * @returns
 */
exports.fuzzyMatchTarget = (partialTargets, includeAllMatching) => {
  const matched = []
  partialTargets.forEach(partialTarget => {
    for (const target of targets) {
      /**
       * 'compiler-core'.match('core') 返回非null
       */
      if (target.match(partialTarget)) {
        matched.push(target)
        // includeAllMatching 设置为 true 时，将返回targets 中所有匹配结果；false时只返回第一个结果
        if (!includeAllMatching) {
          break
        }
      }
    }
  })
  if (matched.length) {
    return matched
  } else {
    console.log()
    // 匹配结果为空时：抛出Error 提示命令行中输入端模块名称(partialTargets)找不到
    console.error(
      `  ${chalk.bgRed.white(' ERROR ')} ${chalk.red(
        `Target ${chalk.underline(partialTargets)} not found!`
      )}`
    )
    console.log()
    // 0表示没有任何类型的故障结束进程，而1表示由于某种故障而结束进程。
    process.exit(1)
  }
}

如果您对 “前端源码” 情有独钟，可以微信扫码关注下面的公众号二维码，内容一直持续更新中！
当前 VUE3.0 源码正在解析中，欢迎捧场！