intersect

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

Die Reihenfolge stammt aus dem ersten Array, und das Ergebnis ist dedupliziert: ein dort wiederholter Wert erscheint einmal. Verglichen wird mit SameValueZero, der Regel eines Set, sodass sich NaN mit NaN schneidet — was ein Vergleich mit === nie tut — und -0 zu 0 passt.

Die Arrays nach dem ersten werden je einmal zu einer Menge, das erste wird genau einmal durchlaufen. Der Aufwand ist linear in der Gesamteingabe statt quadratisch wie bei einer handgeschriebenen Variante. Die Eingaben bleiben unverändert.

Mit einem einzigen Array liefert intersect dessen eindeutige Werte, ohne Argumente [].

Parameter

Parameter	Typ	Beschreibung
`...arrays`	`T[][]`	Die zu schneidenden Arrays. Bleiben unverändert.

Rückgabewert

T[] — ein neues Array der gemeinsamen Werte, in der Reihenfolge des ersten Arrays, ohne Dubletten.

Ausnahmen

Ausnahme	Bedingung
`TypeError`	Ein Argument ist kein Array.

Beispiele

Werte, die in jedem Array vorkommen

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

Zeilen finden, die zwei Blätter gemeinsam haben

/**
 * 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);
}

Deduplizierung und Randfälle

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(); // => []

Siehe auch

unique — dedupliziert ein einzelnes Array.
without — die Gegenrichtung: entfernt die genannten Werte.
Basis-Werkzeuge

Quellcode

src/lang/array/intersect.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.