KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

String.prototype.endsWith — het einde van een tekenreeks controleren

String.prototype.endsWith controleert of een tekenreeks eindigt op de opgegeven tekst en geeft true of false terug. De methode is hoofdlettergevoelig, verandert de tekenreeks niet en laat toe een eerdere eindgrens voor de controle op te geven.

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

str.endsWith(searchString[, endPosition])

String.prototype.endsWith vergelijkt searchString met het einde van een tekenreeks en geeft true of false terug zonder het origineel te wijzigen. De vergelijking is hoofdlettergevoelig en werkt met UTF-16-code-eenheden, zonder Unicode-normalisatie. Dit is een methode uit de ECMAScript-standaardbibliotheek, geen browser-API.

De optionele parameter endPosition stelt een exclusieve eindgrens in: de methode controleert het einde van het prefix tot aan die grens, niet een deelreeks die daar begint. Als het argument wordt weggelaten of undefined is, wordt de volledige lengte gebruikt. Na omzetting naar een geheel getal wordt de waarde begrensd op het interval van 0 tot de lengte van de tekenreeks; negatieve waarden tellen niet terug vanaf het einde. Posities worden gemeten in UTF-16-code-eenheden.

Bij een lege searchString geeft de methode ook bij grens 0 de waarde true terug, mits een eventuele omzetting van endPosition slaagt. De omzetting vindt vóór de vergelijking plaats: als je 0n als endPosition doorgeeft, veroorzaakt dat ook bij een lege searchString een TypeError. Het argument searchString wordt omgezet naar een tekenreeks. Als het wordt weggelaten, is de gebruikte tekst dus "undefined". Een argument dat als reguliere expressie wordt herkend, veroorzaakt een TypeError. De methode aanroepen met null of undefined als this veroorzaakt eveneens een TypeError.

In het voorbeeld ligt grens 10 direct na report.txt. Daarom geeft de controle op .txt true terug, hoewel de volledige tekenreeks eindigt op .bak. De controle op .BAK geeft false terug omdat de hoofdletters en kleine letters verschillen.

Voorbeelden

const filename = "report.txt.bak";
console.log(filename.endsWith(".bak"));
console.log(filename.endsWith(".txt", 10));
console.log(filename.endsWith(".BAK"));
console.log(filename.endsWith("", 0));

Resultaat

true
true
false
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.

Bronnen