功能--文档注释的使用jsdoc

最新推荐文章于 2024-11-06 08:30:00 发布

xuyan　

最新推荐文章于 2024-11-06 08:30:00 发布

阅读量640

点赞数 18

CC 4.0 BY-SA版权

文章标签： java

本文链接：https://blog.csdn.net/zheng_yang_liu/article/details/134600235

常用的文档注释

/**
 * @Author: [xuyan]
 * @description: 对数组内容按需进行分类
 * @param {array} array 进行分类的数据数组
 * @param {'string' | 'function'} rules 分类规则
 * @return {object} object 分类后的数组
 * @example
 * groupBy(user,'id') //按照id进行分类
 * groupBy(user,item=>item.id) //按照id进行分类
 */
function groupBy(array, rules) {
	if (typeof rules === "string") {
		//字符串转换成函数eval(str)
		rules = eval(`(item)=>item.${rules}`);
	}
	const result = {};
	for (const item of array) {
		const key = rules(item);
		if (!result[key]) {
			result[key] = []; //--->>{key:[]}
		}
		result[key].push(item);
	}
	return result;
}

类型	作用	用法
@Author	标明作者	@Author: [xuyan]
@description	函数说明	@description: 对数组内容按需进行分类
@param	函数参数{'类型'}	@param {array} array 进行分类的数据数组
	多个参数类型	@param {'string' \| 'function'} rules 分类规则
@return	返回类型	@return {object} object 分类后的数组
@example	函数是使用例子	@example * groupBy(user,'id') //按照id进行分类 * groupBy(user,item=>item.id) //按照id进行分类