← 返回首页
Array : méthode splice() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Basculer la barre latérale
  1. Web
  2. JavaScript
  3. Référence
  4. Objets natifs standards
  5. Array
  6. splice()
Thème
  • Automatique
  • Clair
  • Sombre
Français
Se souvenir de la langue En savoir plus

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 splice()

Baseline Large disponibilité

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.

La méthode splice() des instances de Array modifie le contenu d'un tableau en supprimant ou remplaçant des éléments existants et/ou en ajoutant de nouveaux éléments en place.

Pour créer un nouveau tableau avec un segment supprimé et/ou remplacé sans modifier le tableau d'origine, utilisez toSpliced(). Pour accéder à une partie d'un tableau sans le modifier, consultez slice().

Dans cet article

Exemple interactif

const months = ["Jan", "Mars", "Avril", "Juin"]; months.splice(1, 0, "Fév"); // Insère à l'indice 1 console.log(months); // Résultat attendu : Array ["Jan", "Fév", "Mars", "Avril", "Juin"] months.splice(4, 1, "Mai"); // Remplace 1 élément à l'indice 4 console.log(months); // Résultat attendu : Array ["Jan", "Fév", "Mars", "Avril", "Mai"]

Syntaxe

js
splice(start) splice(start, deleteCount) splice(start, deleteCount, item1) splice(start, deleteCount, item1, item2) splice(start, deleteCount, item1, item2, /* …, */ itemN)

Paramètres

start

L'indice (commençant à zéro) à partir duquel commencer à modifier le tableau, converti en entier.

  • Un indice négatif compte à rebours depuis la fin du tableau — si -array.length <= start < 0, on utilise start + array.length.
  • Si l'indice start est inférieur à -array.length, on utilise 0.
  • Si l'indice start est supérieur ou égal à array.length, aucun élément ne sera supprimé, mais la méthode se comportera comme une fonction d'ajout, ajoutant autant d'éléments que fourni.
  • Si l'indice start est omis (et que splice() est appelé sans argument), rien n'est supprimé. Cela diffère du passage de undefined, qui est converti en 0.
deleteCount Facultatif

Un entier indiquant le nombre d'éléments à supprimer à partir de l'indice start.

Si le paramètre deleteCount est omis, ou si sa valeur est supérieure ou égale au nombre d'éléments après la position indiquée par l'indice start, alors tous les éléments de l'indice start à la fin du tableau seront supprimés. Cependant, si vous souhaitez passer un paramètre itemN, vous devez passer Infinity comme valeur de deleteCount pour supprimer tous les éléments après l'indice start, car un undefined explicite est converti en 0.

Si le paramètre deleteCount vaut 0 ou une valeur négative, aucun élément n'est supprimé. Dans ce cas, vous devez spécifier au moins un nouvel élément (voir ci-dessous).

item1, …, itemN Facultatif

Les éléments à ajouter au tableau, à partir de l'indice start.

Si vous ne spécifiez aucun élément, splice() ne fera que supprimer des éléments du tableau.

Valeur de retour

Un tableau contenant les éléments supprimés.

Si un seul élément est supprimé, un tableau contenant cet unique élément est retourné.

Si aucun élément n'est supprimé, un tableau vide est retourné.

Description

La méthode splice() est une méthode mutante. Elle peut modifier le contenu de this. Si le nombre d'éléments à insérer diffère du nombre d'éléments supprimés, la propriété length du tableau sera également modifiée. En même temps, elle utilise [Symbol.species] pour créer une nouvelle instance de tableau à retourner.

Si la portion supprimée est un tableau creux, le tableau retourné par splice() sera également creux, avec les indices correspondants vides.

La méthode splice() 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 soient aussi assimilables à des tableaux, cette méthode ne leur est pas adaptée, car les chaînes sont immuables.

Exemples

Supprimer 0 élément avant l'indice 2 et insérer « tambour »

js
const myFish = ["ange", "clown", "mandarin", "esturgeon"]; const removed = myFish.splice(2, 0, "tambour"); // myFish vaut ["angel", "clown", "tambour", "mandarin", "sturgeon"] // removed vaut [], aucun élément supprimé

Supprimer 0 élément avant l'indice 2 et insérer « tambour » et « guitare »

js
const myFish = ["ange", "clown", "mandarin", "esturgeon"]; const removed = myFish.splice(2, 0, "tambour", "guitare"); // myFish vaut ["angel", "clown", "tambour", "guitare", "mandarin", "sturgeon"] // removed vaut [], aucun élément supprimé

Supprimer 0 élément à l'indice 0 et insérer « ange »

splice(0, 0, ...éléments) insère des éléments au début du tableau comme unshift().

js
const myFish = ["clown", "mandarin", "esturgeon"]; const removed = myFish.splice(0, 0, "ange"); // myFish vaut ["angel", "clown", "mandarin", "sturgeon"] // aucun élément supprimé

Supprimer 0 élément au dernier indice et insérer « esturgeon »

splice(array.length, 0, ...éléments) insère des éléments à la fin du tableau comme push().

js
const myFish = ["ange", "clown", "mandarin"]; const removed = myFish.splice(myFish.length, 0, "esturgeon"); // myFish vaut ["angel", "clown", "mandarin", "esturgeon"] // aucun élément supprimé

Supprimer 1 élément à l'indice 3

js
const myFish = ["ange", "clown", "tambour", "mandarin", "esturgeon"]; const removed = myFish.splice(3, 1); // myFish vaut ["angel", "clown", "tambour", "esturgeon"] // removed vaut ["mandarin"]

Supprimer 1 élément à l'indice 2 et insérer « trompette »

js
const myFish = ["ange", "clown", "tambour", "esturgeon"]; const removed = myFish.splice(2, 1, "trompette"); // myFish vaut ["angel", "clown", "trompette", "esturgeon"] // removed vaut ["tambour"]

Supprimer 2 éléments à partir de l'indice 0 et insérer « perroquet », « anémone » et « bleu »

js
const myFish = ["ange", "clown", "trompette", "esturgeon"]; const removed = myFish.splice(0, 2, "perroquet", "anémone", "bleu"); // myFish vaut ["perroquet", "anémone", "bleu", "trompette", "esturgeon"] // removed vaut ["angel", "clown"]

Supprimer 2 éléments à partir de l'indice 2

js
const myFish = ["perroquet", "anémone", "bleu", "trompette", "esturgeon"]; const removed = myFish.splice(2, 2); // myFish vaut ["perroquet", "anémone", "esturgeon"] // removed vaut ["bleu", "trompette"]

Supprimer 1 élément à partir de l'indice -2

js
const myFish = ["ange", "clown", "mandarin", "esturgeon"]; const removed = myFish.splice(-2, 1); // myFish vaut ["angel", "clown", "esturgeon"] // removed vaut ["mandarin"]

Supprimer tous les éléments à partir de l'indice 2

js
const myFish = ["ange", "clown", "mandarin", "esturgeon"]; const removed = myFish.splice(2); // myFish vaut ["angel", "clown"] // removed vaut ["mandarin", "esturgeon"]

Utiliser splice() sur des tableaux creux

La méthode splice() préserve le caractère creux du tableau.

js
const arr = [1, , 3, 4, , 6]; console.log(arr.splice(1, 2)); // [empty, 3] console.log(arr); // [1, 4, empty, 6]

Utiliser splice() sur des objets qui ne sont pas des tableaux

La méthode splice() lit la propriété length de this. Elle met ensuite à jour les propriétés à clés entières et la propriété length si nécessaire.

js
const objetSimilaireTableau = { length: 3, unrelated: "foo", 0: 5, 2: 4, }; console.log(Array.prototype.splice.call(objetSimilaireTableau, 0, 1, 2, 3)); // [ 5 ] console.log(objetSimilaireTableau); // { '0': 2, '1': 3, '3': 4, length: 4, unrelated: 'foo' }

Spécifications

Spécification
ECMAScript® 2027 Language Specification
# sec-array.prototype.splice

Compatibilité des navigateurs

Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.

Voir aussi

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?
Oui Non
Apprendre à contribuer

Cette page a été modifiée le 6 nov. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu
  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
    2. length
    3. name
    4. prototype
    5. arguments
    6. caller
  12. Méthodes d'instance
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    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__
    2. Object.prototype.constructor

Votre modèle pour un internet meilleur.

MDN Contribuer Développeur·euse·s

Visitez la société mère à but non lucratif de Mozilla Corporation, la Fondation Mozilla.
Certaines parties de ce contenu sont protégées par le droit d'auteur ©1998—2026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.