totype.push() - JavaScript - MDN Web Docs

• Skip to main content
• Skip to search

Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Array : méthode push() Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

• Learn more
• See full compatibility
• Report feedback

La méthode push() des instances Array ajoute les éléments définis à la fin d'un tableau et retourne la nouvelle longueur du tableau.

Dans cet article

• Exemple interactif
• Syntaxe
• Description
• Exemples
• Spécifications
• Compatibilité des navigateurs
• Voir aussi

Exemple interactif

const animals = ["cochons", "chèvres", "moutons"]; const count = animals.push("vaches"); console.log(count); // Résultat attendu : 4 console.log(animals); // Résultat attendu : Array ["cochons", "chèvres", "moutons", "vaches"] animals.push("poules", "chats", "chiens"); console.log(animals); // Résultat attendu : Array ["cochons", "chèvres", "moutons", "vaches", "poules", "chats", "chiens"]

Syntaxe

jspush() push(element1) push(element1, element2) push(element1, element2, /* …, */ elementN)

Paramètres

element1, …, elementN

Les éléments à ajouter à la fin du tableau.

Valeur de retour

La nouvelle propriété length de l'objet sur lequel la méthode a été appelée.

Description

La méthode push() ajoute des valeurs à un tableau.

Array.prototype.unshift() a un comportement similaire à push(), mais appliqué au début d'un tableau.

La méthode push() est une méthode de mutation. Elle modifie la longueur et le contenu de this. Si vous souhaitez que la valeur de this reste identique mais retourner un nouveau tableau avec des éléments ajoutés à la fin, vous pouvez utiliser arr.concat([element0, element1, /* ... ,*/ elementN]) à la place. Remarquez que les éléments sont placés dans un tableau supplémentaire — sinon, si l'élément est lui-même un tableau, il serait décomposé au lieu d'être ajouté comme un seul élément à cause du comportement de concat().

La méthode push() est générique. Elle attend seulement que la valeur de this possède une propriété length et des propriétés à clés entières. Bien que les chaînes de caractères ressemblent aussi à des tableaux, cette méthode ne leur convient pas car elles sont immuables.

Exemples

Ajouter des éléments à un tableau

Le code suivant crée un tableau sports contenant deux éléments, puis ajoute deux éléments supplémentaires. La variable total contient la nouvelle longueur du tableau.

jsconst sports = ["football", "baseball"]; const total = sports.push("tennis", "natation"); console.log(sports); // ['football', 'baseball', 'tennis', 'natation'] console.log(total); // 4

Fusionner deux tableaux

Cet exemple utilise la syntaxe de décomposition pour ajouter tous les éléments d'un second tableau au premier.

jsconst legumes = ["panais", "pomme de terre"]; const autresLegumes = ["céleri", "betterave"]; // On fusionne le second tableau dans le premier legumes.push(...autresLegumes); console.log(legumes); // ['panais', 'pomme de terre', 'céleri', 'betterave']

La fusion de deux tableaux peut aussi se faire avec la méthode concat().

Appeler push() sur des objets non tableaux

La méthode push() lit la propriété length de this. Elle définit ensuite chaque index de this à partir de length avec les arguments passés à push(). Enfin, elle définit la propriété length à l'ancienne valeur plus le nombre d'éléments ajoutés.

jsconst objetSimilaireTableau = { length: 3, sansRapport: "toto", 2: 4, }; Array.prototype.push.call(objetSimilaireTableau, 1, 2); console.log(objetSimilaireTableau); // { '2': 4, '3': 1, '4': 2, length: 5, sansRapport: 'toto' } const objetSimple = {}; // Il n'y a pas de propriété length, donc la longueur est 0 Array.prototype.push.call(objetSimple, 1, 2); console.log(objetSimple); // { '0': 1, '1': 2, length: 2 }

Utiliser un objet comme un tableau

Comme mentionné précédemment, push est volontairement générique, ce qui peut être utilisé à notre avantage. Array.prototype.push fonctionne très bien sur un objet, comme le montre cet exemple.

Notez que nous ne créons pas un tableau pour stocker une collection d'objets. À la place, nous stockons la collection sur l'objet lui-même et utilisons call sur Array.prototype.push pour faire croire à la méthode que nous manipulons un tableau — et cela fonctionne, grâce à la façon dont JavaScript permet d'établir le contexte d'exécution comme on le souhaite.

jsconst obj = { length: 0, ajoutElem(elem) { // obj.length est automatiquement incrémenté // à chaque ajout d'un élément. [].push.call(this, elem); }, }; // Ajoutons quelques objets vides pour illustrer. obj.ajoutElem({}); obj.ajoutElem({}); console.log(obj.length); // 2

Notez que même si obj n'est pas un tableau, la méthode push a bien incrémenté la propriété length de obj comme si nous manipulions un véritable tableau.

Spécifications

Specification
ECMAScript® 2026 Language Specification# sec-array.prototype.push

Compatibilité des navigateurs

Voir aussi

• Guide des collections indexées
• L'objet global Array
• La méthode Array.prototype.pop()
• La méthode Array.prototype.shift()
• La méthode Array.prototype.unshift()
• La méthode Array.prototype.concat()
• La méthode Array.prototype.splice()
• Prothèse d'émulation de Array.prototype.push dans core-js avec corrections de cette méthode (angl.)
• Prothèse d'émulation es-shims de Array.prototype.push (angl.)

Help improve MDN

Cette page vous a-t-elle été utile ? Yes No Learn how to contribute

Cette page a été modifiée le 5 nov. 2025 par les contributeurs du MDN.

View this page on GitHub • Report a problem with this content Filter sidebar

1. Objets natifs standards
2. Array
3. Constructeur
   1. Array()
4. Méthodes statiques
   1. from()
   2. fromAsync()
   3. isArray()
   4. of()
5. Propriétés statiques
   1. [Symbol.species]
6. Méthodes d'instance
   1. at()
   2. concat()
   3. copyWithin()
   4. entries()
   5. every()
   6. fill()
   7. filter()
   8. find()
   9. findIndex()
   10. findLast()
   11. findLastIndex()
   12. flat()
   13. flatMap()
   14. forEach()
   15. includes()
   16. indexOf()
   17. join()
   18. keys()
   19. lastIndexOf()
   20. map()
   21. pop()
   22. push()
   23. reduce()
   24. reduceRight()
   25. reverse()
   26. shift()
   27. slice()
   28. some()
   29. sort()
   30. splice()
   31. toLocaleString()
   32. toReversed()
   33. toSorted()
   34. toSpliced()
   35. toString()
   36. unshift()
   37. values()
   38. with()
   39. [Symbol.iterator]()
7. Propriétés d'instance
   1. length
   2. [Symbol.unscopables]
8. Héritage
9. Object/Function
10. Méthodes statiques
    1. apply()
    2. bind()
    3. call()
    4. toString()
    5. [Symbol.hasInstance]()
11. Propriétés statiques
    1. displayName Non standard
    2. length
    3. name
    4. prototype
    5. arguments Non standard Obsolète
    6. caller Non standard Obsolète
12. Méthodes d'instance
    1. Object.prototype.__defineGetter__() Obsolète
    2. Object.prototype.__defineSetter__() Obsolète
    3. Object.prototype.__lookupGetter__() Obsolète
    4. Object.prototype.__lookupSetter__() Obsolète
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
13. Propriétés d'instance
    1. Object.prototype.__proto__ Obsolète
    2. Object.prototype.constructor