packages/docusaurus-theme-common/src/utils/__tests__/jsUtils.test.ts - main - githubmirror/docusaurus

packages/docusaurus-theme-common/src/utils/__tests__/jsUtils.test.ts
106 строк3 KB
Sébastien Lorber
refactor(test): use explicit Vitest imports, disable globals (#12019)
15 май 2026, 11:01
15 май 2026, 11:01057ab88
/**
 * Copyright (c) Facebook, Inc. and its affiliates.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 */

import {describe, expect, it} from 'vitest';
import {uniq, duplicates, groupBy} from '../jsUtils';

describe('duplicates', () => {
  it('gets duplicate values', () => {
    expect(duplicates(['a', 'b', 'c', 'd'])).toEqual([]);
    expect(duplicates(['a', 'b', 'b', 'b'])).toEqual(['b', 'b']);
    expect(duplicates(['c', 'b', 'b', 'c'])).toEqual(['b', 'c']);
    expect(duplicates([{a: 1}, {a: 1}, {a: 1}])).toEqual([]);
  });
  it('accepts custom comparator', () => {
    expect(duplicates([{a: 1}, {a: 1}, {a: 1}], (a, b) => a.a === b.a)).toEqual(
      [{a: 1}, {a: 1}],
    );
    expect(duplicates(['a', 'b', 'c', 'd'], (a, b) => a !== b)).toEqual([
      'a',
      'b',
      'c',
      'd',
    ]);
  });
});

describe('uniq', () => {
  it('remove duplicate primitives', () => {
    expect(uniq(['A', 'B', 'C', 'B', 'A', 'D'])).toEqual(['A', 'B', 'C', 'D']);
    expect(uniq([3, 3, 5, 1, 6, 3, 5])).toEqual([3, 5, 1, 6]);
    expect(uniq([null, undefined, 3, null, 4, 3])).toEqual([
      null,
      undefined,
      3,
      4,
    ]);
  });

  it('remove duplicate objects/arrays by identity', () => {
    const obj1 = {};
    const obj2 = {};
    const obj3 = {};
    const array1: unknown[] = [];
    const array2: unknown[] = [];
    const array3: unknown[] = [];
    expect(
      uniq([obj1, obj1, obj2, array1, obj2, array3, array2, array1, obj3]),
    ).toEqual([obj1, obj2, array1, array3, array2, obj3]);
  });
});

describe('groupBy', () => {
  type User = {name: string; age: number; type: 'a' | 'b' | 'c'};

  const user1: User = {name: 'Seb', age: 42, type: 'c'};
  const user2: User = {name: 'Robert', age: 42, type: 'b'};
  const user3: User = {name: 'Seb', age: 32, type: 'c'};

  const users = [user1, user2, user3];

  it('group by name', () => {
    const groups = groupBy(users, (u) => u.name);

    expect(Object.keys(groups)).toEqual(['Seb', 'Robert']);
    expect(groups).toEqual({
      Seb: [user1, user3],
      Robert: [user2],
    });
  });

  it('group by age', () => {
    const groups = groupBy(users, (u) => u.age);

    // Surprising keys order due to JS behavior
    // see https://x.com/sebastienlorber/status/1806371668614369486
    expect(Object.keys(groups)).toEqual(['32', '42']);
    expect(groups).toEqual({
      '32': [user3],
      '42': [user1, user2],
    });
  });

  it('group by type', () => {
    const groups = groupBy(users, (u) => u.type);

    expect(Object.keys(groups)).toEqual(['c', 'b']);
    expect(groups).toEqual({
      c: [user1, user3],
      b: [user2],
    });
  });

  it('group by name even duplicates', () => {
    const groups = groupBy([user1, user2, user3, user1, user3], (u) => u.name);

    expect(Object.keys(groups)).toEqual(['Seb', 'Robert']);
    expect(groups).toEqual({
      Seb: [user1, user3, user1, user3],
      Robert: [user2],
    });
  });
});