JavaScript splice()Méthode

Objet Array JavaScript

Exemple

Ajouter de nouveaux éléments à un tableau :

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.splice(2,0,"Lemon","Kiwi");

fruitsSortie :

Banana,Orange,Lemon,Kiwi,Apple,Mango

Essayez-le vous-même »

Définition et utilisation

La méthode splice() est utilisée pour ajouter ou supprimer des éléments dans un tableau.

Remarque :Cette méthode modifie le tableau d'origine.

Valeur de retour

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


Prise en charge des navigateurs

Tous les principaux navigateurs prennent en charge splice().

Chrome IE Edge Firefox Safari Opera
Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge Pris en charge

Syntaxe

array.splice(index,howmany,item1,.....,itemX)

Valeurs des paramètres

Paramètre Description
index Requis. Spécifie où ajouter/supprimer des éléments.
Ce paramètre est l'index de l'élément du tableau où commence l'insertion et/ou la suppression. Il doit être un nombre.
howmany Facultatif. Spécifie combien d'éléments doivent être supprimés. Doit être un nombre, mais peut être "0".
Si ce paramètre n'est pas spécifié, tous les éléments à partir de l'index jusqu'à la fin du tableau d'origine sont supprimés.
item1, ..., itemX Facultatif. Le ou les nouveaux éléments à ajouter au tableau

Valeur de retour

Type Description
Tableau Si des éléments sont supprimés de arrayObject, un tableau contenant les éléments supprimés est retourné.

Détails techniques

Version JavaScript : 1.2


Plus d’exemples

Exemple

Supprimez le troisième élément du tableau et ajoutez un nouvel élément à la troisième position du tableau :

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.splice(2,1,"Lemon","Kiwi");

fruitsSortie :

Banana,Orange,Lemon,Kiwi,Mango

Essayez-le vous-même »

Exemple

À partir de la troisième position, supprimez deux éléments du tableau :

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.splice(2,2);

fruitsSortie :

Banana,Orange

Essayez-le vous-même »

Exemple : Supprimer un élément spécifié d'un tableau

const array = [2, 5, 9];

document.write(array);

const index = array.indexOf(5); // Supprimer l'élément 5
if (index > -1) { // Supprimer l'élément spécifié trouvé
  array.splice(index, 1); // Supprimer l'élément
}
document.write("<br>")
// array = [2, 9]
document.write(array);

Essayez-le vous-même »


Objet Array JavaScript

Autres extensions