JS注解怎么标注模块导入_ JS模块导入内容的注解方法与示例

/**
 * 工具函数：处理用户数据
 * @see {@link import('./userUtils')} 中的 formatUserData
 */
import { formatUserData } from './userUtils';
<p>// 使用导入的函数
const user = formatUserData(rawData);</p>

/**
 * @typedef {import('./types').User} User
 */
<p>/**</p><ul><li>处理用户列表</li><li>@param {User[]} users - 用户数组</li><li>@returns {string[]} 用户名列表
*/
function getUserNames(users) {
return users.map(u => u.name);
}

/**
 * 数据服务模块（默认导入）
 * @type {import('./dataService')}
 */
import DataService from './dataService';
<p>/**</p><ul><li>验证工具集合（命名导入）</li><li>@type {import('./validators')}
<em>/
import </em> as validators from './validators';

// userUtils.js
/**
 * 格式化原始用户数据
 * @param {Object} data - 原始用户数据
 * @param {string} data.name
 * @param {number} data.age
 * @returns {{name: string, age: number, createdAt: Date}}
 */
export function formatUserData(data) {
  return {
    name: data.name,
    age: data.age,
    createdAt: new Date()
  };
}