From bf8e099b9c8b3c60d60b3712b4fc97b052c39887 Mon Sep 17 00:00:00 2001 From: julieng Date: Tue, 3 Aug 2021 08:03:23 +0200 Subject: convert content to md --- .../reference/global_objects/array/push/index.md | 131 +++++++++------------ 1 file changed, 53 insertions(+), 78 deletions(-) (limited to 'files/fr/web/javascript/reference/global_objects/array/push') diff --git a/files/fr/web/javascript/reference/global_objects/array/push/index.md b/files/fr/web/javascript/reference/global_objects/array/push/index.md index c7f18ce86b..0472582660 100644 --- a/files/fr/web/javascript/reference/global_objects/array/push/index.md +++ b/files/fr/web/javascript/reference/global_objects/array/push/index.md @@ -10,72 +10,72 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Array/push original_slug: Web/JavaScript/Reference/Objets_globaux/Array/push --- -
{{JSRef}}
+{{JSRef}} -

La méthode push() ajoute un ou plusieurs éléments à la fin d'un tableau et retourne la nouvelle taille du tableau.

+La méthode **`push()`** ajoute un ou plusieurs éléments à la fin d'un tableau et retourne la nouvelle taille du tableau. -
{{EmbedInteractiveExample("pages/js/array-push.html")}}
+{{EmbedInteractiveExample("pages/js/array-push.html")}} -

Syntaxe

+## Syntaxe -
arr.push(élément1, ..., élémentN)
+ arr.push(élément1, ..., élémentN) -

Paramètres

+### Paramètres -
-
élément1, ...,élémentN
-
Les éléments à ajouter à la fin du tableau.
-
+- `élément1, ...,élémentN` + - : Les éléments à ajouter à la fin du tableau. -

Valeur de retour

+### Valeur de retour -

La nouvelle valeur de la propriété {{jsxref("Array.length", "length")}} de l'objet sur lequel la méthode a été appelée.

+La nouvelle valeur de la propriété {{jsxref("Array.length", "length")}} de l'objet sur lequel la méthode a été appelée. -

Description

+## Description -

La méthode push permet d'ajouter des valeurs à un tableau.

+La méthode `push` permet d'ajouter des valeurs à un tableau. -

push est une méthode générique. Cette méthode peut ainsi être utilisée avec les méthodes {{jsxref("Function.call()")}} ou {{jsxref("Function.apply()")}} sur des objets similaires aux tableaux.

+`push` est une méthode générique. Cette méthode peut ainsi être utilisée avec les méthodes {{jsxref("Function.call()")}} ou {{jsxref("Function.apply()")}} sur des objets similaires aux tableaux. -

La méthode push se base sur la propriété length pour déterminer à partir de quel index les valeurs données doivent être insérées. Si la propriété length ne peut pas être convertie en nombre, l'index utilisé est 0. Si la propriété length n'est pas définie, elle est alors créée.

+La méthode `push` se base sur la propriété `length` pour déterminer à partir de quel index les valeurs données doivent être insérées. Si la propriété `length` ne peut pas être convertie en nombre, l'index utilisé est 0. Si la propriété `length` n'est pas définie, elle est alors créée. -

Bien que push soit une méthode générique, elle ne peut pas être utilisée sur les chaînes de caractères ou sur l'objet arguments car ils sont immuables.

+Bien que `push` soit une méthode générique, elle ne peut pas être utilisée sur les chaînes de caractères ou sur l'objet `arguments` car ils sont immuables. -

Exemples

+## Exemples -

Ajouter des éléments à un tableau

+### Ajouter des éléments à un tableau -

Le code suivant crée un tableau sports contenant à sa création deux éléments, auxquels sont ajoutés deux nouveaux éléments. La variable total contient la nouvelle taille du tableau.

+Le code suivant crée un tableau `sports` contenant à sa création deux éléments, auxquels sont ajoutés deux nouveaux éléments. La variable `total` contient la nouvelle taille du tableau. -
var sports = ["plongée", "baseball"];
+```js
+var sports = ["plongée", "baseball"];
 var total = sports.push("football", "tennis");
 
 console.log(sports); // ["plongée", "baseball", "football", "tennis"]
 console.log(total);  // 4
-
+``` -

Fusionner deux tableaux

+### Fusionner deux tableaux -

Dans l'exemple qui suit, on utilise la méthode {{jsxref("Function.apply()")}} pour ajouter les différents éléments d'un second tableau

+Dans l'exemple qui suit, on utilise la méthode {{jsxref("Function.apply()")}} pour ajouter les différents éléments d'un second tableau -
var legumes = ['navet', 'pomme de terre'];
+```js
+var legumes = ['navet', 'pomme de terre'];
 var autresLegumes = ['céleri', 'radis'];
 
 // On fusionne les deux tableaux
 // Équivalent à legumes.push('céleri', 'radis');
 Array.prototype.push.apply(legumes, autresLegumes);
 
-console.log(legumes); // ['navet', 'pomme de terre', 'céleri', 'radis']
+console.log(legumes); // ['navet', 'pomme de terre', 'céleri', 'radis'] +``` -
-

Note : Attention à ne pas utiliser cette méthode lorsque les tableaux sont très grands car une fonction n'accepte qu'un nombre limité d'arguments. Voir {{jsxref("Function.apply","apply()")}} pour plus d'informations sur ces limites.

-
+> **Note :** Attention à ne pas utiliser cette méthode lorsque les tableaux sont très grands car une fonction n'accepte qu'un nombre limité d'arguments. Voir {{jsxref("Function.apply","apply()")}} pour plus d'informations sur ces limites. -

Utiliser un objet comme on utiliserait un tableau

+### Utiliser un objet comme on utiliserait un tableau -

Comme nous l'avons vu auparavant, push est une méthode générique et nous pouvons donc utiliser Array.prototype.push sur les objets. On notera qu'il n'est pas nécessaire de stocker un ensemble d'objets. En fait, on enregistre l'ensemble dans l'objet et on utilise call sur Array.prototype.push :

+Comme nous l'avons vu auparavant, `push` est une méthode générique et nous pouvons donc utiliser `Array.prototype.push` sur les objets. On notera qu'il n'est pas nécessaire de stocker un ensemble d'objets. En fait, on enregistre l'ensemble dans l'objet et on utilise `call` sur `Array.prototype.push` : -
var obj = {
+```js
+var obj = {
     length: 0,
 
     ajoutElem: function ajoutElem (elem) {
@@ -91,49 +91,24 @@ obj.ajoutElem({});
 obj.ajoutElem({});
 console.log(obj.length);
 // → 2
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES3')}}{{Spec2('ES3')}}Définition initiale. Implémentée avec JavaScript 1.2.
{{SpecName('ES5.1', '#sec-15.4.4.7', 'Array.prototype.push')}}{{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-array.prototype.push', 'Array.prototype.push')}}{{Spec2('ES6')}}
{{SpecName('ESDraft', '#sec-array.prototype.push', 'Array.prototype.push')}}{{Spec2('ESDraft')}}
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Array.push")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------------------- | +| {{SpecName('ES3')}} | {{Spec2('ES3')}} | Définition initiale. Implémentée avec JavaScript 1.2. | +| {{SpecName('ES5.1', '#sec-15.4.4.7', 'Array.prototype.push')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-array.prototype.push', 'Array.prototype.push')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-array.prototype.push', 'Array.prototype.push')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Array.push")}} + +## Voir aussi + +- {{jsxref("Array.prototype.pop()")}} +- {{jsxref("Array.prototype.shift()")}} +- {{jsxref("Array.prototype.unshift()")}} +- {{jsxref("Array.prototype.concat()")}} -- cgit v1.2.3-54-g00ecf