aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/javascript/reference/global_objects
diff options
context:
space:
mode:
Diffstat (limited to 'files/fr/web/javascript/reference/global_objects')
-rw-r--r--files/fr/web/javascript/reference/global_objects/string/at/index.md88
-rw-r--r--files/fr/web/javascript/reference/global_objects/string/string/index.md46
2 files changed, 134 insertions, 0 deletions
diff --git a/files/fr/web/javascript/reference/global_objects/string/at/index.md b/files/fr/web/javascript/reference/global_objects/string/at/index.md
new file mode 100644
index 0000000000..fa4dc85153
--- /dev/null
+++ b/files/fr/web/javascript/reference/global_objects/string/at/index.md
@@ -0,0 +1,88 @@
+---
+title: String.prototype.at()
+slug: Web/JavaScript/Reference/Global_Objects/String/at
+translation_of: Web/JavaScript/Reference/Global_Objects/String/at
+browser-compat: javascript.builtins.String.at
+---
+{{JSRef}}
+
+La méthode **`at()`** prend un entier en argument et renvoie une nouvelle chaîne de caractères ([`String`](/fr/docs/Web/JavaScript/Reference/Global_Objects/String)) contenant le codet UTF-16 présent dans la chaîne courante à l'emplacement indiqué en argument. Cette méthode permet d'utiliser des arguments positifs ou négatifs. Lorsque le paramètre passé est un entier négatif, la recherche s'effectue depuis la fin de la chaîne de caractères.
+
+{{EmbedInteractiveExample("pages/js/string-at.html")}}
+
+## Syntaxe
+
+```js
+at(indice)
+```
+
+### Paramètres
+
+- `indice`
+ - : L'indice (c'est-à-dire la position) du caractère de la chaîne de caractères qu'on souhaite récupérer. Les indices relatifs sont pris en charge et on peut ainsi utiliser un indice négatif. Dans ce cas, c'est le caractère situé à la position comptée depuis la fin de la chaîne qui est renvoyé.
+
+### Valeur de retour
+
+Une chaîne de caractères ([`String`](/fr/docs/Web/JavaScript/Reference/Global_Objects/String)) contenant un unique codet UTF-16 situé à la position indiquée. Renvoie [`undefined`](/fr/docs/Web/JavaScript/Reference/Global_Objects/undefined) si l'indice indiqué ne peut être trouvé dans la chaîne de caractères.
+
+## Exemples
+
+### Renvoyer le dernier caractère d'une chaîne de caractères
+
+Dans l'exemple qui suit, on fournit une fonction qui renvoie le dernier caractère trouvé dans une chaîne de caractères.
+
+```js
+// Une fonction qui renvoie le dernier caractère d'une chaîne
+function dernierCar(str) {
+ return str.at(-1);
+}
+
+let refFacture = 'maFacture01';
+
+console.log(dernierCar(refFacture));
+// Affiche '1' dans la console
+
+refFacture = 'maFacture02';
+
+console.log(dernierCar(refFacture));
+// Affiche '2' dans la console
+```
+
+### Comparaison de méthodes
+
+On compare ici différentes méthodes pour sélectionner l'avant-dernier caractère d'une chaîne de caractères ([`String`](/fr/docs/Web/JavaScript/Reference/Global_Objects/String)). Bien que toutes les alternatives proposées ici soient valables, on pourra remarquer la concision et la lisibilité de la méthode `at()`.
+
+```js
+const maChaine = "Vers l'infini et au-delà !";
+
+// En utilisant la propriété length et la méthode charAt()
+const avecLength = maChaine.charAt(maChaine.length-2);
+console.log(avecLength); // Affiche 'à' dans la console
+
+// En utilisant la méthode slice()
+const avecSlice = maChaine.slice(-2, -1);
+console.log(avecSlice); // Affiche 'à' dans la console
+
+// En utilisant la méthode at()
+const avecAt = maChaine.at(-2);
+console.log(avecAt); // Affiche 'à' dans la console
+```
+
+## Spécifications
+
+{{Specifications}}
+
+## Compatibilité des navigateurs
+
+{{Compat}}
+
+## Voir aussi
+
+- [`String.prototype.indexOf()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/String/indexOf)
+- [`String.prototype.lastIndexOf()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/String/lastIndexOf)
+- [`String.prototype.charCodeAt()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/String/charCodeAt)
+- [`String.prototype.codePointAt()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/String/codePointAt)
+- [`String.prototype.split()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/String/split)
+- Prothèses d'émulation (<i lang="en">polyfills</i>)&nbsp;:
+ - [Celle de la proposition TC39](https://github.com/tc39/proposal-relative-indexing-method#polyfill).
+ - [Celle de `core-js`](https://github.com/zloirock/core-js#ecmascript-string-and-regexp)
diff --git a/files/fr/web/javascript/reference/global_objects/string/string/index.md b/files/fr/web/javascript/reference/global_objects/string/string/index.md
new file mode 100644
index 0000000000..ccf292575c
--- /dev/null
+++ b/files/fr/web/javascript/reference/global_objects/string/string/index.md
@@ -0,0 +1,46 @@
+---
+title: Constructeur String()
+slug: Web/JavaScript/Reference/Global_Objects/String/String
+translation_of: Web/JavaScript/Reference/Global_Objects/String/String
+browser-compat: javascript.builtins.String.String
+---
+{{JSRef}}
+
+Le constructeur **`String`** est utilisé afin de créer un nouvel objet [`String`](/fr/docs/Web/JavaScript/Reference/Global_Objects/String) qui représente une chaîne de caractères. Lorsqu'il est appelé comme une fonction (et pas comme un constructeur, c'est-à-dire sans être précédé du mot-clé `new`), il effectue une conversion de la valeur fournie en argument en une chaîne de caractères primitive, ce qui peut être plus utile.
+
+## Syntaxe
+
+```js
+new String(truc)
+String(truc)
+```
+
+### Paramètres
+
+- `truc`
+ - : N'importe quelle valeur qui peut être convertie en une chaîne de caractères.
+
+## Exemples
+
+### Distinction entre le constructeur `String()` et la fonction `String()`
+
+Selon qu'on utilise `String()` comme une fonction ou comme un constructeur, cela produira différents résultats&nbsp;:
+
+```js
+typeof String('Coucou monde'); // string
+typeof new String('Coucou monde'); // object
+```
+
+Ici, la fonction produit une chaîne de caractères (une valeur primitive). Toutefois, le constructeur produit une instance objet de `String`.
+
+## Spécifications
+
+{{Specifications}}
+
+## Compatibilité des navigateurs
+
+{{Compat}}
+
+## Voir aussi
+
+- [L'article sur le formatage du texte dans le guide JavaScript](/fr/docs/Web/JavaScript/Guide/Text_formatting)