unique

function unique<T, K = T>(array: T[], iteratee?: (value: T) => K): T[];

La comparaison suit SameValueZero, la règle d'un Set: NaN se dédoublonne avec NaN, ce que === ne fait jamais, et -0 se confond avec 0. L'ordre est celui de la première apparition, et l'entrée n'est pas modifiée.

Les objets sont comparés par identité : deux objets de même contenu sont donc deux valeurs. L' iteratee facultative produit la clé de comparaison, ce qui permet de dédoublonner des enregistrements par un identifiant plutôt que par leur identité. À clé égale, c'est la valeur rencontrée en premier qui l'emporte.

Paramètres

Paramètre	Type	Description
`array`	`T[]`	Le tableau à dédoublonner. Il n'est pas modifié.
`iteratee` (facultatif)	`(value: T) => K`	Produit la clé selon laquelle une valeur est comparée. Sans elle, les valeurs se comparent entre elles.

Valeur de retour

T[] — un nouveau tableau sans doublons, dans l'ordre de première apparition.

Exceptions

Exception	Condition
`TypeError`	`array` n'est pas un tableau.

Exemples

Dédoublonner des valeurs

unique([1, 2, 2, 3]); // => [1, 2, 3]
unique(["a", "b", "a"]); // => ["a", "b"]
unique([NaN, NaN]); // => [NaN]
unique([0, -0]); // => [0]

Dédoublonner des enregistrements par une clé

import { unique } from "apps-script-utils";

const rows = [
  { id: 1, name: "first" },
  { id: 1, name: "second" },
  { id: 2, name: "third" }
];

unique(rows, (row) => row.id); // => [{ id: 1, name: "first" }, { id: 2, name: "third" }]

Recueillir les valeurs distinctes d'une colonne

/**
 * Lists every status used in a column, each one once, in the order they first
 * appear.
 */
export function listStatuses(sheet: GoogleAppsScript.Spreadsheet.Sheet): string[] {
  const column = sheet.getRange("C2:C").getValues().flat() as string[];

  return unique(column.filter((status: string): boolean => status !== ""));
}

function listStatuses(sheet) {
  const column = sheet.getRange("C2:C").getValues().flat();
  return unique(column.filter((status) => status !== ""));
}

Voir aussi

intersect — les valeurs communes à plusieurs tableaux, également dédoublonnées.
without — retire les valeurs nommées.
Utilitaires de base

Code source

src/lang/array/unique.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.