CKTIS / JavaScript
Intl.Collator — tekst vergelijken volgens taalregels
Intl.Collator vergelijkt tekenreeksen volgens de regels van een geselecteerde taalregio. De functie compare kan rechtstreeks aan een sortering worden doorgegeven; het teken van de uitkomst is van belang, niet een specifieke getalswaarde.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const collator = new Intl.Collator(locales, options);
collator.compare(a, b);
array.sort(collator.compare);Intl.Collator maakt deel uit van de internationalisatiestandaard ECMA-402, niet van de DOM-interfaces. Het maakt een object dat tekst vergelijkt op basis van taalregio-instellingen (locales) en opties (options). Door expliciet een taal op te geven, ben je minder afhankelijk van de standaardinstellingen van de omgeving.
Intl.Collator.prototype.compare is een accessor die een aan de instantie gebonden functie retourneert. Je kunt collator.compare rechtstreeks aan array.sort(...) doorgeven, zonder bind te gebruiken. Een negatieve uitkomst betekent dat de eerste tekenreeks vóór de tweede komt; een positieve betekent dat deze erna komt, en 0 betekent gelijkwaardigheid volgens de vergelijkingsregels. Ga er niet van uit dat de uitkomst precies -1 of 1 is; 0 hoeft niet te betekenen dat de tekenreeksen identiek zijn.
usage: "sort" is bedoeld om te ordenen, terwijl usage: "search" bedoeld is om gelijkwaardigheid te testen, niet om te sorteren. sensitivity bepaalt welke verschillen meetellen: "base", "accent", "case" of "variant". numeric: true maakt het mogelijk cijferreeksen als getallen te vergelijken, als de omgeving dit ondersteunt.
Taalgegevens en details van de volgorde zijn afhankelijk van de implementatie. Controleer of de API en de benodigde taalregio’s beschikbaar zijn in de doelbrowser; beschikbaarheid in Node 24 bewijst geen browserondersteuning. Intl.Collator.supportedLocalesOf(...) helpt taalregio’s te controleren, terwijl collator.resolvedOptions() de daadwerkelijk geselecteerde instellingen toont.
Voorbeelden
const collator = new Intl.Collator("en", { usage: "sort" });
const words = ["c", "a", "b"];
console.log(words.sort(collator.compare).join(","));
console.log(collator.compare("a", "b") < 0);
console.log(collator.compare("a", "a") === 0);Resultaat
a,b,c true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.