WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Intl.Collator: Vergleichsempfindlichkeit und sprachabhängige Sortierregeln

Vergleiche und sortiere Zeichenketten nach den Regeln der gewählten Spracheinstellung. `sensitivity` bestimmt, welche Unterschiede beim Vergleich zählen.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

new Intl.Collator(locales, { sensitivity: "base" | "accent" | "case" | "variant", usage: "sort" | "search" })
collator.compare(a, b)
strings.sort(collator.compare)
Intl.Collator.supportedLocalesOf(locales)
collator.resolvedOptions()

The `|` notation lists alternatives; pass one string value per option. Both constructor arguments and both shown options are optional.

Bei Intl.Collator bestimmen die Sortierregeln der tatsächlich verwendeten Spracheinstellung (Locale), was als Grundbuchstabe gilt. In der deutschen Standardsortierung ist ä eine Variante von a, in der schwedischen ein eigenständiger Buchstabe. Deshalb kann "base" die beiden Zeichenketten bei de als gleichwertig behandeln, bei sv aber nicht.

Unterschiedliche Grundbuchstaben werden bei jeder Einstellung von sensitivity unterschieden. Beim selben Grundbuchstaben ignoriert "base" diakritische Zeichen und Groß- und Kleinschreibung. "accent" berücksichtigt diakritische Zeichen, aber nicht die Groß- und Kleinschreibung; "case" macht es umgekehrt. "variant" berücksichtigt beides und kann weitere Unterschiede erfassen. Ein Wert außerhalb dieser Liste, etwa "ignore", löst einen RangeError aus.

Beim voreingestellten usage: "sort" ist "variant" der Standardwert für sensitivity. Bei usage: "search" hängt der Standardwert von der Spracheinstellung ab. Prüfe in diesem Modus mit compare(a, b) === 0 auf Übereinstimmung, nicht auf Reihenfolge. Beim Sortieren steht a bei einem negativen Ergebnis vor b und bei einem positiven danach; null bedeutet, dass der Vergleich sie als gleichwertig behandelt. Verlasse dich nicht auf exakt -1 oder 1. Da collator.compare an die Instanz gebunden ist, kannst du die Funktion direkt an sort() übergeben. Ein Ergebnis von 0 bedeutet nicht, dass a === b gilt.

Gib eine Spracheinstellung ausdrücklich an: Findet die Laufzeitumgebung für keine der angeforderten Einstellungen eine Entsprechung, verwendet sie ihre Standardeinstellung. Intl.Collator.supportedLocalesOf() prüft die Unterstützung ohne diesen Rückgriff, und resolvedOptions().locale zeigt die tatsächlich verwendete Einstellung. Sortierdaten können sich zwischen Laufzeitumgebungen und Versionen selbst bei denselben effektiven Optionen unterscheiden.

Beispiele

{
  const locales = ["en", "de", "sv"];
  if (typeof Intl === "undefined" || typeof Intl.Collator !== "function" ||
      Intl.Collator.supportedLocalesOf(locales).length !== locales.length) {
    console.log("Intl.Collator or required locales unavailable");
  } else {
    for (const sensitivity of ["base", "accent", "case", "variant"]) {
      const { compare } = new Intl.Collator("en", { sensitivity });
      console.log(`${sensitivity}: ${compare("a", "á") === 0}, ${compare("a", "A") === 0}`);
    }

    for (const locale of ["de", "sv"]) {
      const { compare } = new Intl.Collator(locale, { sensitivity: "base" });
      console.log(`${locale}: ${compare("a", "ä") === 0}`);
    }
  }
}

Ergebnis

base: true, true
accent: false, true
case: true, false
variant: false, false
de: true
sv: false

In den ersten vier Zeilen bedeutet `true`, dass das jeweilige Paar als gleichwertig gilt: zuerst `a` und `á`, dann `a` und `A`. Die letzten beiden Zeilen vergleichen `a` mit `ä` bei `"base"` in `de` und `sv`. Die gezeigte Ausgabe setzt die Unterstützung dieser Spracheinstellungen und von `en` sowie die beschriebenen Standardsortierregeln voraus.

Zugehörige Lektionen

  • JavaScript · Lektion 24 · Mittlere Stufe · Version: 3

Quellen