KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

String.prototype.startsWith — het voorvoegsel van een tekenreeks controleren

De methode startsWith controleert of een tekenreeks een opgegeven voorvoegsel aan het begin of precies op een bepaalde positie heeft. De methode geeft een boolean terug, maakt onderscheid tussen hoofdletters en kleine letters en wijzigt de tekenreeks niet.

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.startsWith(searchString[, position])

String.prototype.startsWith geeft true terug als searchString precies op index position overeenkomt; anders geeft de methode false terug. De methode zoekt niet verder op latere posities en wijzigt de tekenreeks niet.

De standaardwaarde van position is 0. De waarde wordt omgezet naar een geheel getal door het fractionele deel richting nul af te kappen en vervolgens begrensd tot het bereik van 0 tot de lengte van de tekenreeks; NaN betekent 0. Indexen tellen UTF-16-code-eenheden, die niet noodzakelijk overeenkomen met volledige tekens zoals gebruikers die waarnemen.

Bij de vergelijking wordt onderscheid gemaakt tussen hoofdletters en kleine letters en Unicode wordt niet genormaliseerd. Een lege searchString geeft true terug, ook als de opgegeven positie voorbij de lengte van de tekenreeks ligt. Andere waarden worden naar tekenreeksen omgezet: als het argument wordt weggelaten, wordt gezocht naar "undefined". Een gewone reguliere expressie veroorzaakt een TypeError.

De methode kan via call ook met andere ontvangers werken, die daarbij naar tekenreeksen worden omgezet, maar een ontvanger met de waarde null of undefined veroorzaakt een TypeError. Dit is een ECMAScript-taal-API, geen DOM-API; de specificatie alleen toont niet aan dat deze API in een bepaalde browser wordt ondersteund.

Voorbeelden

const text = "Hello, world!";
console.log(text.startsWith("Hello"));
console.log(text.startsWith("hello"));
console.log(text.startsWith("world", 7));
console.log(text.startsWith("world", 6));
console.log(text.startsWith("", 99));

Resultaat

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