CKTIS / JavaScript
String.prototype.startsWith — vérifier le préfixe d’une chaîne
La méthode startsWith vérifie si une chaîne possède un préfixe donné au début ou exactement à une position indiquée. Elle renvoie une valeur booléenne, distingue les majuscules et les minuscules et ne modifie pas la chaîne.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
string.startsWith(searchString[, position])String.prototype.startsWith renvoie true si searchString correspond exactement à l’index position ; sinon, elle renvoie false. Elle ne recherche pas de correspondance à des positions ultérieures et ne modifie pas la chaîne.
La valeur par défaut de position est 0. La valeur est convertie en entier en tronquant sa partie fractionnaire vers zéro, puis limitée à l’intervalle allant de 0 à la longueur de la chaîne ; NaN signifie 0. Les index comptent les unités de code UTF-16, qui ne correspondent pas nécessairement à des caractères complets tels qu’ils sont perçus par l’utilisateur.
La comparaison distingue les majuscules et les minuscules et ne normalise pas Unicode. Un searchString vide renvoie true, même si la position fournie dépasse la longueur de la chaîne. Les autres valeurs sont converties en chaînes : si l’argument est omis, la recherche porte sur "undefined". Une expression régulière ordinaire provoque une TypeError.
La méthode peut également fonctionner sur d’autres récepteurs avec call, en les convertissant en chaînes, mais un récepteur null ou undefined provoque une TypeError. Il s’agit d’une API du langage ECMAScript, et non d’une API DOM ; la spécification seule ne permet pas d’établir sa prise en charge dans un navigateur donné.
Exemples
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));Résultat
true false true false true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.