CKTIS / JavaScript
String.prototype.includes — controleren op een deelstring
String.prototype.includes controleert of een tekst een opgegeven deelstring bevat en geeft true of false terug. De methode maakt onderscheid tussen hoofdletters en kleine letters, ondersteunt een startpositie en accepteert geen gewone reguliere expressies.
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.includes(searchString)
str.includes(searchString, position)String.prototype.includes zoekt naar een letterlijke deelstring en geeft true of false terug zonder de tekst te wijzigen. De methode maakt onderscheid tussen hoofdletters en kleine letters en vergelijkt UTF-16-code-eenheden: Unicode wordt niet genormaliseerd en er worden geen taalspecifieke vergelijkingsregels toegepast.
De optionele parameter position geeft de vroegst mogelijke beginindex voor een overeenkomst aan, geteld vanaf nul in UTF-16-code-eenheden. De standaardwaarde is 0; na omzetting naar een getal wordt een fractioneel deel naar nul afgekapt en wordt het resultaat begrensd tot het bereik van 0 tot de tekstlengte. Als de methode aan het zoeken toekomt, geeft ze bij een lege searchString true terug, ook als de opgegeven positie groter is dan de tekstlengte. position wordt echter vóór het zoeken omgezet: een BigInt als position veroorzaakt ook bij een lege searchString een TypeError.
Een gewoon RegExp-object als searchString veroorzaakt een TypeError; formeel bepaalt de test IsRegExp dit, waarbij ook Symbol.match wordt meegenomen. Andere zoekargumenten worden naar tekst omgezet. Als het argument wordt weggelaten, wordt dus gezocht naar "undefined". De methode aanroepen met null of undefined als this veroorzaakt een TypeError.
Dit is een methode uit de ECMAScript-standaardbibliotheek, geen Web API. Ondersteuning in een specifieke browser moet afzonderlijk worden gecontroleerd; beschikbaarheid in Node 24 bewijst geen browserondersteuning.
Voorbeelden
const text = "JavaScript";
console.log(text.includes("Script"));
console.log(text.includes("script"));
console.log(text.includes("Java", 1));
console.log(text.includes("", 99));
try {
text.includes(/Script/);
} catch (error) {
console.log(error.name);
}Resultaat
true false false true TypeError
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.