KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

String.prototype.localeCompare — tekst vergelijken volgens taalregels

String.prototype.localeCompare vergelijkt twee tekenreeksen volgens taalkundige sorteervolgordes. Het teken van het resultaat bepaalt hun volgorde; locales en options passen de vergelijking aan in omgevingen met ondersteuning voor ECMA-402.

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

string.localeCompare(compareString, locales?, options?)

String.prototype.localeCompare vergelijkt de tekenreeks van de ontvanger met compareString. Een negatieve uitkomst betekent dat de tekenreeks vóór de andere staat, een positieve dat deze erna staat, en 0 betekent gelijkwaardigheid in deze vergelijking, niet noodzakelijk identieke tekst. Let op het teken van de uitkomst, niet op de exacte waarden -1 en 1.

In omgevingen met ECMA-402 vraagt locales om een voorkeurstaal, zoals "en"; als je dit weglaat, worden de standaardinstellingen van de omgeving gebruikt. options past de vergelijking aan: numeric: true sorteert cijferreeksen op hun numerieke waarde. De regels zijn afhankelijk van de beschikbare taalgegevens; zonder ECMA-402 kun je niet op ondersteuning voor deze argumenten rekenen.

Geef voor sorteren (a, b) => a.localeCompare(b, "en", options) door. Geef de methode niet zelf door als vergelijkingsfunctie: daarvoor is de juiste this-ontvanger nodig. In het voorbeeld plaatst numeric: true item2 vóór item10; de verwachte regel is item1, item2, item10.

Voorbeelden

const labels = ["item10", "item2", "item1"];
const options = { numeric: true };
labels.sort((a, b) => a.localeCompare(b, "en", options));
console.log(labels.join(", "));

Resultaat

item1, item2, item10

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.

Bronnen