CKTIS / JavaScript
Intl.Collator — primerjanje besedila po jezikovnih pravilih
Intl.Collator primerja nize po pravilih izbranega jezika. Funkcijo compare lahko neposredno posredujete funkciji za razvrščanje; pomemben je predznak rezultata, ne določena številska vrednost.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
const collator = new Intl.Collator(locales, options);
collator.compare(a, b);
array.sort(collator.compare);Intl.Collator spada v standard za internacionalizacijo ECMA-402, ne med vmesnike DOM. Ustvari objekt, ki primerja besedilo glede na jezikovne nastavitve (locales) in možnosti (options). Z izrecno navedbo jezika zmanjšate odvisnost od privzetih nastavitev okolja.
Intl.Collator.prototype.compare je dostopnik, ki vrne funkcijo, vezano na primerek. collator.compare lahko neposredno posredujete funkciji array.sort(...), ne da bi uporabili bind. Negativen rezultat pomeni, da je prvi niz pred drugim; pozitiven pomeni, da je za njim, 0 pa pomeni enakovrednost po pravilih primerjanja. Ne predpostavljajte, da je rezultat natanko -1 ali 1; 0 ne pomeni nujno, da sta niza enaka.
usage: "sort" je namenjen razvrščanju, medtem ko je usage: "search" namenjen preverjanju enakovrednosti, ne razvrščanju. sensitivity določa, katere razlike se upoštevajo: "base", "accent", "case" ali "variant". numeric: true omogoča primerjanje zaporedij števk kot števil, če okolje to podpira.
Jezikovni podatki in podrobnosti vrstnega reda so odvisni od izvedbe. V ciljnem brskalniku preverite, ali sta API in zahtevani jeziki na voljo; razpoložljivost v Node 24 ne dokazuje podpore v brskalnikih. Intl.Collator.supportedLocalesOf(...) pomaga preveriti jezike, collator.resolvedOptions() pa prikaže dejansko izbrane nastavitve.
Primeri
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);Rezultat
a,b,c true true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.