String.
Vérifie si une chaîne commence par le texte donné. Renvoie true ou false.
- Renvoie
truesi la chaîne commence par le texte donné, sinonfalse.- Modifie l’original
- Non
Exemple
#const link = 'https://example.com/cours'
console.log(link.startsWith('https://'))
console.log(link.startsWith('http://'))
console.log(link.startsWith('HTTPS'))Définition et utilisation
#La méthode startsWith() compare le début d’une chaîne avec le fragment donné et renvoie true quand il correspond. Elle distingue majuscules et minuscules et n’accepte pas les expressions régulières, seulement du texte simple.
Elle est utile pour reconnaître des préfixes : le protocole d’une adresse (https://), l’indicatif d’un numéro de téléphone, une commande commençant par / dans un chat, ou une catégorie écrite au début d’un identifiant.
Le second argument décale le point de départ de la comparaison. text.startsWith("abc", 5) vérifie si le fragment apparaît exactement à partir de l’indice 5.
Syntaxe
#string.startsWith(searchString)
string.startsWith(searchString, position)Paramètres
#searchString
string
Texte par lequel la chaîne doit commencer.position
number, optionnel
Indice à partir duquel commence la comparaison. Par défaut0.
Plus d’exemples
#const messages = ['/aide', 'Bonjour à tous !', '/classement']
for (const message of messages) {
if (message.startsWith('/')) {
console.log('Commande :', message.slice(1))
}
}const taskId = 'JS-2026-boucles'
console.log(taskId.startsWith('2026', 3))
console.log(taskId.startsWith('boucles', 8))Compatibilité des navigateurs
#Largement disponible
Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.
- Chrome
- Edge
- Firefox
- Safari
Bonnes pratiques
#- Avec des données saisies par l’utilisateur, retirez d’abord les espaces avec
trim(), car" /aide".startsWith("/")renvoiefalse. - Pour vérifier plusieurs préfixes possibles, combinez la méthode avec
some():["http://", "https://"].some((prefix) => link.startsWith(prefix)).
Entrées associées
#- String.prototype.endsWith()Vérifie si une chaîne se termine par le texte donné. Renvoie true ou false.
- String.prototype.includes()Vérifie si une chaîne contient le fragment de texte donné. Renvoie true ou false et distingue majuscules et minuscules.
- String.prototype.indexOf()Renvoie l’indice de la première occurrence du texte donné dans une chaîne, ou -1 s’il est absent.
- String.prototype.slice()Renvoie un fragment de la chaîne entre un indice de départ et un indice de fin (exclu). Prend en charge les indices négatifs.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.