如何在JavaScript中实现类似Python的关键字参数传参效果？

JavaScript没有Python那样的原生关键字参数语法，直接用choices([0,4,9,2], k=2)这种写法时，k=2本质是赋值表达式，编辑器无法关联参数名称和类型，所以会显示k为any。要实现带类型提示的关键字传参效果，推荐用**对象参数+类型标注（JSDoc或TypeScript）**的方式，具体实现如下：

方法一：纯JavaScript + JSDoc类型标注 #

通过JSDoc给函数参数和配置选项定义类型，让VSCode能正确识别参数类型：

/**
 * 模拟Python标准库的random.choices函数
 * @param {Array<T>} population 待选择的元素集合
 * @param {Object} [options] 配置选项
 * @param {number} [options.k=1] 需要选择的元素数量
 * @param {Array<number>} [options.weights] 元素对应的权重数组（可选）
 * @returns {Array<T>} 选择出的元素数组
 * @template T
 */
function choices(population, options = {}) {
  const { k = 1, weights } = options;
  // 计算总权重，无权重时默认每个元素权重为1
  const totalWeight = weights ? weights.reduce((sum, w) => sum + w, 0) : population.length;
  const result = [];

  for (let i = 0; i < k; i++) {
    let random = Math.random() * totalWeight;
    let currentSum = 0;
    // 按权重随机选择元素
    for (let j = 0; j < population.length; j++) {
      currentSum += weights ? weights[j] : 1;
      if (random < currentSum) {
        result.push(population[j]);
        break;
      }
    }
  }
  return result;
}

// 调用示例（VSCode会识别options.k为number类型）
choices([0, 4, 9, 2], { k: 2 });
// 带权重的调用
choices([0, 4, 9, 2], { k: 3, weights: [1, 2, 3, 4] });

方法二：TypeScript实现 #

利用TypeScript的类型系统直接定义参数类型，类型提示更严谨：

type ChoicesOptions = {
  k?: number;
  weights?: number[];
};

function choices<T>(population: T[], options: ChoicesOptions = { k: 1 }): T[] {
  const { k = 1, weights } = options;
  const totalWeight = weights ? weights.reduce((sum, w) => sum + w, 0) : population.length;
  const result: T[] = [];

  for (let i = 0; i < k; i++) {
    let random = Math.random() * totalWeight;
    let currentSum = 0;
    for (let j = 0; j < population.length; j++) {
      currentSum += weights ? weights[j] : 1;
      if (random < currentSum) {
        result.push(population[j]);
        break;
      }
    }
  }
  return result;
}

// 调用示例
choices([0, 4, 9, 2], { k: 2 }); // k的类型会被正确识别为number

关键说明 #

• JavaScript没有原生关键字参数，用对象包裹配置项是最贴近Python关键字传参体验的方案，同时能让编辑器识别参数类型。
• 两种方式都支持可选参数（比如不传入k时默认选择1个元素），也兼容权重配置。

内容的提问来源于stack exchange，提问作者berriz44