Langage de programmation - JavaScript - Référence des classes

String.includes	Inclure
JavaScript	ECMAScript 6+ (IE12+, FireFox 40+, Safari 9+, Opera 28+, Google Chrome 41+)

Syntaxe

function includes(searchvalue, start)

Paramètres

Nom	Description
searchvalue	Ce paramètre permet d'indiquer la sous-chaîne de caractères à rechercher.
start	Ce paramètre optionnel permet d'indiquer la position où commence la recherche. La valeur par défaut est 0.

Retour

Valeur	Description
false	Cette valeur permet d'indiquer que la sous-chaîne de caractères est absente.
true	Cette valeur permet d'indiquer que la sous-chaîne de caractères est présente.

Description

Cette méthode permet d'indiquer si la sous-chaîne de caractères est incluse dans la chaîne de caractères de l'objet.

Remarque

Même si la sous-chaîne de caractères a un seul caractères de différent ou qu'il y a des différences de minuscule ou majuscule, il est considéré comme différent. Donc, la comparaison est très stricte.

Exemple

Les exemples suivantes permettent d'indiquer si la sous-chaîne de caractères est présente :



				
<script> 

document.write("CECI EST UN EXEMPLE".includes("EST") + "<br />");  

document.write("CECI EST UN EXEMPLE".includes("est")) + "<br />";

</script>

on obtiendra le résultat suivant :

true false

Voir également

Langage de programmation - JavaScript - Type de données élémentaire - Les chaines de caractères

Dernière mise à jour : Lundi, le 10 avril 2017

Section courante

A propos

Section administrative du site

String.includes