String : méthode startsWith()

Exemple interactif

const str = "Programme pour samedi soir";

console.log(str.startsWith("Pro"));
// Résultat attendu : true

console.log(str.startsWith("Pro", 3));
// Résultat attendu : false

Syntaxe

startsWith(searchString)
startsWith(searchString, position)

Paramètres

searchString

Les caractères à rechercher au début de cette chaîne de caractères. Ne peut pas être une expression rationnelle. Toutes les valeurs qui ne sont pas des expressions rationnelles sont converties en chaînes de caractères, donc l'omission de ce paramètre ou le passage de undefined entraîne la recherche de la chaîne de caractères "undefined", ce qui est rarement souhaité.

position Facultatif

La position de départ à laquelle searchString est censé être trouvé (l'index du premier caractère de searchString). Par défaut 0.

Valeur de retour

true si les caractères donnés se trouvent au début de la chaîne de caractères, y compris lorsque searchString est une chaîne de caractères vide ; sinon, false.

Exceptions

TypeError

Levée si searchString est une expression rationnelle.

Description

Cette méthode permet de déterminer si une chaîne de caractères commence ou non par une autre chaîne de caractères. Cette méthode est sensible à la casse.

Exemples

Utiliser la méthode startsWith()

const chaine = "Être, ou ne pas être : telle est la question.";

console.log(chaine.startsWith("Être")); // true
console.log(chaine.startsWith("pas être")); // false
console.log(chaine.startsWith("pas être", 12)); // true

Spécifications

Compatibilité des navigateurs

Voir aussi

• La prothèse d'émulation (polyfill en anglais) de String.prototype.startsWith dans core-js ^(angl.)
• La prothèse d'émulation (polyfill en anglais) es-shims de String.prototype.startsWith ^(angl.)
• La méthode String.prototype.endsWith()
• La méthode String.prototype.includes()
• La méthode String.prototype.indexOf()
• La méthode String.prototype.lastIndexOf()