Retour
Javascript CheatSheet
Fiches de documentation du langage Javascript.
Ensemble de toutes les méthodes natives intéressante des classes et objets en Javascript. String, Numbers, Booleans, Arrays, document...
0
String
// Déclaration primitive
let a = "Hello";
// Constructeur
let b = new String("world")
Propriétés
length
La taille du la chaine de caratères
Type
NumberMéthodes
at()
Renvoie le caractère à l'indice indiqué par index.
Les indices négatifs sont acceptés, dans ce cas ils indiquent la position par rapport au dernier caractère.
Signature
String.at(index<Number>):<String|undefined>Paramètres
@index: L'indice (c'est-à-dire la position) du caractère de la chaîne de caractères qu'on souhaite récupérer.
Retour
Une chaîne de caractères (String) contenant un unique codet UTF-16 situé à la position indiquée.
Renvoie undefined si l'indice indiqué ne peut être trouvé dans la chaîne de caractères.
Exemples
a.at(0); // H
a.at(1); // e
a.at(2); // l
a.at(-2); // l
a.at(-1); // 0
charCodeAt()
Renvoie un nombre qui est la valeur du codet UTF-16 à l'indice indiqué par index.
Signature
<String>.charCodeAt(index<Number>):<String|undefined>Paramètres
@index: Un entier supérieur ou égal à zéro et strictement inférieur à la longueur de la chaîne. La valeur par défaut (si le paramètre est absent ou n'est pas un nombre) sera zéro (0).
Retour
Un nombre qui représente la valeur du point de code UTF-16 pour le caractère à la position indiquée.
Si index pointe en dehors de la chaîne, ce sera NaN qui sera renvoyé.
Exemples
"ABC".charCodeAt(0) // 65
concat()
Combine le texte de deux (ou plusieurs) chaînes en une nouvelle chaîne de caractères.
Signature
<String>.concat(...str<String>):<String>Paramètres
@...str: Chaînes de caractères à concaténer ensemble.
Retour
Une nouvelle chaîne de caractères qui contient la concaténation des chaînes de caractères fournies.
Exemples
a.concat(" ", b, "!") // Hello world!
includes()
La méthode includes() détermine si une chaîne de caractères est contenue dans une autre et renvoie true ou false selon le cas de figure.
Signature
<String>.includes(searchStr, position<Number>):<Boolean>Paramètres
@searchStr: Une chaîne à rechercher dans la chaîne courante.
@position (Facultatif): La position dans la chaîne à partir de laquelle commencera la recherche. La valeur par défaut de position est 0.
Retour
true si la chaîne de caractères contient la sous-chaîne recherchée, false sinon.
Exemples
const str = "Être ou ne pas être, telle est la question.";
str.includes("Être"); // true
str.includes("question"); // true
str.includes("pléonasme"); // false
str.includes("Être", 1); // false
str.includes("ÊTRE"); // false
str.includes(""); // true
endsWith()
Cette méthode permet de savoir si une chaine de caractères se termine avec une certaine chaine de caractères
Comme les autres méthodes fonctionnant avec des chaînes de caractères, cette méthode est sensible à la casse.
Signature
<String>.endsWith(searchStr, position<Number>):<Boolean>Paramètres
@searchStr: Les caractères à rechercher à la fin de la chaine de caractères.
@position (Facultatif): Permet de rechercher dans la chaine de caractères comme si elle faisait cette longueur.
Par défaut il s'agit de la longueur de la chaine de caractères searchStr.
Si la valeur fournie est supérieure à la longueur de la chaine de caractères, elle ne sera pas prise en compte.
Retour
true true si la chaîne de caractères se termine par la sous-chaîne indiquée, false sinon.
Exemples
var str = "Être, ou ne pas être : telle est la question.";
str.endsWith("question."); // true
str.endsWith("pas être"); // false
str.endsWith("pas être", 20); // true
indexOf()
La méthode indexOf() renvoie l'indice de la première occurence de la valeur cherchée au sein de la chaîne courante (à partir de indexDébut).
Elle renvoie -1 si la valeur cherchée n'est pas trouvée.
Signature
<String>.indexOf(searchStr<String>, ?Position<Number> = 0):<Number>Paramètres
@searchStr: Une chaîne représentant la valeur qu'on cherche dans la chaîne courante.
@position (Facultatif): L'indice à partir duquel commencer la recherche, effectuée du début vers la fin de la liste.
Si position < 0 la chaîne sera parcourue en entier, ce qui équivaut à utiliser 0.
Si position >= str.length, la méthode renverra -1 sauf si searchStr est la chaîne vide, auquel cas, la méthode renverra searchStr.length
Retour
L'indice de la première occurrence de la valeur indiquée, -1 si elle n'est pas trouvée.
Si la valeur recherchée est la chaîne vide, une correspondance sera trouvée à n'importe quel index entre 0 et str.length.
Exemples
"Blue Whale".indexOf("Blue"); // retourne 0
"Blue Whale".indexOf("Blute"); // retourne -1
"Blue Whale".indexOf("Whale", 0); // retourne 5
"Blue Whale".indexOf("Whale", 5); // retourne 5
"Blue Whale".indexOf(""); // retourne 0
"Blue Whale".indexOf("", 9); // retourne 9
"Blue Whale".indexOf("", 10); // retourne 10
"Blue Whale".indexOf("", 11); // retourne 10
lastIndexOf()
La méthode lastIndexOf() renvoie l'indice, dans la chaîne courante, de la dernière occurence de la valeur donnée en argument.
Si cette sous-chaîne n'est pas trouvée, la méthode renvoie -1.
La recherche s'effectue de la fin vers le début de la chaîne, à partir de position.
Signature
<String>.lasIndexOf(searchStr<String>, ?Position<Number> = Infinity):<Number>Paramètres
@searchStr: Une chaîne qu'on recherche dans la chaîne courante.
@position (Facultatif): L'emplacement, dans la chaîne courante, à partir duquel effectuer la recherche
Si indiceDébut > str.length, toute la chaîne sera parcourue.
Si indiceDébut < 0, on aura le même comportement que si indiceDébut valait 0.
Retour
L'indice de la dernière occurrence de la valeur indiquée, -1 si elle n'est pas trouvée.
Exemples
'canal'.lastIndexOf('a'); // renvoie 3
'canal'.lastIndexOf('a', 2); // renvoie 1
'canal'.lastIndexOf('a', 0); // renvoie -1
'canal'.lastIndexOf('x'); // renvoie -1
'canal'.lastIndexOf('c', -5); // renvoie 0
'canal'.lastIndexOf('c', 0); // renvoie 0
'canal'.lastIndexOf(''); // renvoie 5
'canal'.lastIndexOf('', 2); // renvoie 2
match()
La méthode match() permet d'obtenir le tableau des correspondances entre la chaîne courante et une expression rationnelle.
Signature
<String>.match(regexp<String|RegExp>, ?Position<Number> = Infinity):<Number>Paramètres
@regexp: Un objet représentant une expression rationnelle. Si ce n'est pas un objet de type RegExp, celui-ci sera converti en un objet RegExp grâce à new RegExp(regexp).
Retour
Un tableau (Array) contenant les correspondances et les groupes capturés avec les parenthèses ou null s'il n'y a pas de correspondance.
Le contenu de ce tableau dépend de l'utilisation du marqueur pour la recherche globale g :
- Si le marqueur g est utilisé, tous les résultats correspondants à l'expression rationnelle complète seront renvoyés mais les groupes capturants ne seront pas renvoyés.
- Si le marqueur g n'est pas utilisé, seule la première correspondance et ses groupes capturants seront renvoyés.
Exemples
let str = 'Pour plus d\'informations, voir le chapitre 3.4.5.1';
let re = /(chapitre \d+(\.\d)*)/i;
let found = str.match(re);
console.log(found);// ['chapitre 3.4.5.1', 'chapitre 3.4.5.1', '.1']
// 'chapitre 3.4.5.1' est la première correspondance
// 'chapitre 3.4.5.1' est la valeur gardée en mémoire par
// `(chapitre \d+(\.\d)*)`.
// '.1' est la valeur gardée en mémoire par `(\.\d)`.
replace()
La méthode replace() renvoie une nouvelle chaîne de caractères dans laquelle tout ou partie des correspondances à un modèle sont remplacées par un remplacement.
Le modèle utilisé peut être une RegExp et le remplacement peut être une chaîne ou une fonction à appeler pour chaque correspondance.
Si modèle est une chaîne de caractères, seule la première correspondance sera remplacée.
La chaîne de caractère originale reste inchangée.
Signature
<String>.replace(serchFor<String>|<RegExp>, ?replaceWith<String>|<Function>):<String>Paramètres
@serchFor:
Un objet ou un littéral RegExp. La ou les correspondances sont remplacées par replaceWith ou par la valeur retournée par la fonction indiquée.
Ou
Une String qui est à remplacer. Seule la première occurrence sera remplacée.
@replaceWith:
La String qui remplace la chaîne de caractères indiquée par le paramètre serchFor
Ou
Une fonction à appeler pour créer la nouvelle sous-chaîne de caractères à utiliser.
Retour
Une nouvelle chaîne de caractères avec tout ou partie des correspondances du modèle remplacées par un remplacement.
Exemples
let chn = 'Twas the night before Xmas...';
let nouvChn = chn.replace(/xmas/i, 'Christmas');
console.log(nouvChn); // Twas the night before Christmas...
replacAll()
La méthode replaceAll() retourne une nouvelle chaîne de caractères dans laquelle toutes les occurrences d'un motif donné ont été remplacées par une chaîne de remplacement.
L'argument pattern fournit pour décrire le motif peut être une chaîne de caractères ou une expression rationnelle (RegExp), l'argument replacement peut être une chaîne de caractères ou une fonction qui sera appelée pour chaque correspondance.
Signature
<String>.replaceAll(serchFor<String>|<RegExp>, ?newStr<String>|<Function>):<String>Paramètres
@serchFor:
Un objet ou un littéral RegExp. La ou les correspondances sont remplacées par replaceWith ou par la valeur retournée par la fonction indiquée.
Ou
Une String qui est à remplacer.
@replaceWith:
La String qui remplace la chaîne de caractères indiquée par le paramètre serchFor
Ou
Une fonction à appeler pour créer la nouvelle sous-chaîne de caractères à utiliser.
Retour
Une nouvelle chaîne avec toutes les occurrences trouvées remplacées par le pattern de remplacement.
Exemples
'a,b,c'.replacAll(",","-"); // 'a-b-c'
slice()
La méthode slice() extrait une section d'une chaine de caractères et la retourne comme une nouvelle chaine de caractères.
La chaîne de caractères courante n'est pas modifiée.
Signature
<String>.slice(debut<Number>, fin<Number>):<String>Paramètres
@debut:
L'indice base 0 auquel commencer l'extraction.
Si négatif, il est traité comme (longueurSource + debut). où longueurSource est la longueur de la chaine de caractères par exemple:
- si debut est -3, il sera traité comme longueurSource - 3.
- Si debut est supérieur à la longueur de la chaîne, slice() renvoie une chaîne vide.
@fin:
Un indice base 0 avant lequel terminer l'extraction. Le caractère à cet indice ne sera pas inclus.
Si fin est absent, slice() extraira jusqu'à la fin de la chaine de caractères.
Si négatif, il sera traité comme (longueurSource + fin) où longueurSource est la longueur de la chaine de caractères
Retour
Une nouvelle chaîne de caractères contenant la section extraite de la chaîne.
Exemples
var chn1 = 'Le matin est sur nous.', // la longueur de chn1 est de 22
chn1.slice(1, 8); //e matin
chn1.slice(3, -2); // matin est sur nou
chn1.slice(13); // sur nous.
chn1.slice(30); // ""
split()
La méthode slice() divise une chaîne de caractères en une liste ordonnée de sous-chaînes, place ces sous-chaînes dans un tableau et retourne le tableau.
La division est effectuée en recherchant un motif, où le motif est fourni comme premier paramètre dans l'appel de la méthode.
Signature
<String>.split(separator<String|RegExp>, limit<Number>):<Array>Paramètres
@separator:
Le motif décrivant où chaque séparation doit se produire. Le separator peut être une simple chaîne de caractères ou peut être une expression régulière.
- Si separator n'est qu'un seul caractère ; il est utilisé pour diviser une chaîne délimitée.
- Si separator contient plusieurs caractères, cette séquence de caractères entière doit être trouvée afin de diviser la chaîne.
- Si separator est omis ou n'apparaît pas dans la chaîne str, le tableau retourné contient un élément constitué de la chaîne entière.
- Si separator apparaît au début (ou à la fin) de la chaîne, il a quand même l'effet de division. Le résultat est une chaîne vide (c'est-à-dire de longueur nulle), qui apparaît à la première (ou dernière) position du tableau retourné.
@limit (Facultatif):
Un nombre entier non négatif spécifiant une limite sur le nombre de sous-chaînes à inclure dans le tableau.
S'il est fourni, il divise la chaîne de caractères à chaque occurrence du separator spécifié, mais s'arrête lorsque la limit (limite) d'entrées a été atteinte dans le tableau.
Tout texte restant n'est pas du tout inclus dans le tableau.
Retour
Un tableau (Array) qui contient les fragments de la chaîne de caractères, découpée en fonction du séparateur indiqué.
Exemples
'a;b;c'.split(';');// ['a', 'b', 'c']
Array
map
Fonction qui retourne un tableau modifier à travers une fonction donnée en paramètre
Signature
Array.map(callback):ArrayParamètres
@callback: fonction de transformation
function callback(element<A>, position<Number>, array<Array>):<B>Retour
Nouveau tableau transfoméExemple
// Array
let fruits = [1, 2, 3, 4];
//Fonction de transformation callback
function doubleValeur(element, position, array){
// Retourne la nouvelle velaur de l'élément
return element * 2;
}
// Utilisation de la méthode
numbers.map(doubleValeur);// [2, 4, 6, 8]
