深入理解JavaScript对象数组的动态属性排序

/**
 * sort array by numeric by numeric property values
 * of object entries. null entries are treated as 0.
 * array entries must be objects.
 * @param {object[]} arr - 要排序的对象数组。
 * @param {string} prop - 用于排序的数字属性名（字符串）。
 */
export const propSort = (arr, prop) => {
    arr.sort((a, b) => {
        return (a[prop] || 0) - (b[prop] || 0);
    });
};

const users = [
    { name: 'Alice', age: 30, score: 85 },
    { name: 'Bob', age: 25, score: 92 },
    { name: 'Charlie', age: 35, score: 78 },
    { name: 'David', age: 28, score: null }, // score 为 null
    { name: 'Eve', age: 22 } // 没有 score 属性
];

console.log("原始数组:");
console.log(users);

// 根据 'age' 属性进行排序
propSort(users, 'age');
console.log("\n按 'age' 排序后的数组:");
console.log(users);
/*
[
  { name: 'Eve', age: 22 },
  { name: 'Bob', age: 25, score: 92 },
  { name: 'David', age: 28, score: null },
  { name: 'Alice', age: 30, score: 85 },
  { name: 'Charlie', age: 35, score: 78 }
]
*/

// 根据 'score' 属性进行排序
// 注意：null 和 undefined 的 score 会被视为 0，因此排在最前面
propSort(users, 'score');
console.log("\n按 'score' 排序后的数组 (null/undefined 视为 0):");
console.log(users);
/*
[
  { name: 'David', age: 28, score: null }, // score 视为 0
  { name: 'Eve', age: 22 },             // score 视为 0
  { name: 'Charlie', age: 35, score: 78 },
  { name: 'Alice', age: 30, score: 85 },
  { name: 'Bob', age: 25, score: 92 }
]
*/

/**
 * 根据对象数组中指定数字属性的值进行排序。
 * 缺失或 null 的属性值将被视为 0。
 *
 * @template T - 数组中对象的类型。
 * @param {T[]} arr - 要排序的对象数组。
 * @param {keyof T} prop - 用于排序的数字属性名。
 */
export const propSort = <T extends Record<string, number | null | undefined>>(
    arr: T[],
    prop: keyof T
): void => {
    arr.sort((a, b) => {
        // 断言属性值为 number | null | undefined，确保类型安全
        const valA = (a[prop] as number | null | undefined) || 0;
        const valB = (b[prop] as number | null | undefined) || 0;
        return valA - valB;
    });
};

// 示例使用 TypeScript
interface User {
    name: string;
    age: number;
    score?: number | null; // score 可能是可选的，或为 null
}

const tsUsers: User[] = [
    { name: 'Alice', age: 30, score: 85 },
    { name: 'Bob', age: 25, score: 92 },
    { name: 'Charlie', age: 35, score: 78 },
    { name: 'David', age: 28, score: null },
    { name: 'Eve', age: 22 } // 没有 score 属性
];

// 类型安全：prop 必须是 User 接口的键
propSort(tsUsers, 'age');
console.log("\nTypeScript 示例 - 按 'age' 排序:");
console.log(tsUsers);

propSort(tsUsers, 'score'); // 允许，因为 score 属性存在
console.log("\nTypeScript 示例 - 按 'score' 排序:");
console.log(tsUsers);

// propSort(tsUsers, 'nonExistentProp'); // 这将导致 TypeScript 编译错误