如何使用JSDoc为重载的窗口状态切换函数编写文档？

我来帮你把这个重载状态的toggleWindow函数的JSDoc文档整理得更清晰规范，完全贴合你描述的行为逻辑：

/**
 * 控制移动端地图窗口的显示状态
 * @param {undefined|*} on - 切换或设置窗口状态
 * - 传入{undefined}时：切换当前窗口的显示状态（显示变隐藏，隐藏变显示）
 * - 传入任意值{*}时：将窗口状态设置为该参数的布尔真值（即`Boolean(on)`的结果）
 */
toggleWindow(on) {
  if (on === undefined) {
    on = !this.state.window;
  }
  this.setState({ mapWindow: Boolean(on) });
}

文档细节说明： #

• 用/** ... */包裹完整注释块，开头直接点明函数的核心作用
• @param明确标注参数类型为undefined|*，精准覆盖两种调用场景
• 通过列表分点解释不同参数输入对应的行为，让其他开发者一眼就能看懂函数的重载逻辑
• 函数体内补充Boolean(on)统一处理参数的布尔转换，确保状态设置的一致性

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