intersect

function intersect<T>(...arrays: T[][]): T[];

L'ordre vient du premier tableau et le résultat est dédoublonné : une valeur qui s'y répète n'apparaît qu'une fois. La comparaison suit SameValueZero, la règle d'un Set, si bien que NaN s'intersecte avec NaN — ce qu'une comparaison par === ne fait jamais — et que -0 correspond à 0.

Les tableaux suivants deviennent chacun un ensemble une fois pour toutes, et le premier est parcouru une seule fois. Le coût est linéaire en la taille totale des entrées plutôt que quadratique comme dans une version écrite à la main. Les entrées ne sont pas modifiées.

Appelé avec un seul tableau, intersect renvoie ses valeurs uniques ; appelé sans argument, il renvoie [].

Paramètres

Paramètre	Type	Description
`...arrays`	`T[][]`	Les tableaux à intersecter. Ils ne sont pas modifiés.

Valeur de retour

T[] — un nouveau tableau des valeurs communes, dans l'ordre du premier tableau, sans doublons.

Exceptions

Exception	Condition
`TypeError`	L'un des arguments n'est pas un tableau.

Exemples

Les valeurs communes à tous les tableaux

intersect([1, 2, 3], [2, 3, 4]); // => [2, 3]
intersect([1, 2, 3], [2, 3], [3, 9]); // => [3]
intersect([1, 2], [9]); // => []

Trouver les lignes communes à deux feuilles

/**
 * Returns the identifiers that appear in both sheets, in the order of the
 * first one.
 */
export function findSharedIds(
  active: GoogleAppsScript.Spreadsheet.Sheet,
  billed: GoogleAppsScript.Spreadsheet.Sheet
): string[] {
  const left = active.getRange("A2:A").getValues().flat() as string[];

  const right = billed.getRange("A2:A").getValues().flat() as string[];

  return intersect(left, right);
}

function findSharedIds(active, billed) {
  const left = active.getRange("A2:A").getValues().flat();
  const right = billed.getRange("A2:A").getValues().flat();
  return intersect(left, right);
}

Dédoublonnage et cas limites

intersect([1, 1, 2], [1, 2]); // => [1, 2] — the result is deduplicated
intersect([NaN], [NaN]); // => [NaN]
intersect([1, 2]); // => [1, 2] — a single array, deduplicated
intersect(); // => []

Voir aussi

unique — dédoublonne un seul tableau.
without — l'opération inverse : retire les valeurs nommées.
Utilitaires de base

Code source

src/lang/array/intersect.ts

23 September 2026

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