HOWTO · JavaScript

Supprimer le premier élément d'un tableau en JavaScript

Cet article explique différentes façons de supprimer le premier élément d’un tableau JavaScript.

Sur cette page

Pour supprimer le premier élément d’un tableau JavaScript, utilisez shift() ou splice(0, 1) pour modifier le tableau d’origine. Si vous devez le conserver, utilisez slice(1) ou filter() pour créer un nouveau tableau. shift() renvoie l’élément supprimé sous la forme d’une valeur unique, tandis que splice(0, 1) le renvoie dans un tableau.

Supprimer le premier élément en modifiant le tableau d’origine

shift() et splice() suppriment tous deux un élément du tableau d’origine. Choisissez shift() si vous voulez toujours supprimer le premier élément ; choisissez splice() si vous souhaitez appliquer la même opération à un index précis ou supprimer plusieurs éléments.

shift() supprime l’élément à l’index 0, déplace les éléments restants vers le début du tableau et renvoie la valeur supprimée. L’exemple suivant montre le tableau mis à jour et l’élément renvoyé :

Le code et les libellés ou sorties affichés dans cette section restent en anglais.

const items = ["first", "second", "third"];
const removed = items.shift();
console.log(JSON.stringify({ items, removed }));
{"items":["second","third"],"removed":"first"}

Après ces instructions, items contient les deux dernières chaînes et removed contient "first". Dans un environnement JavaScript, JSON.stringify() affiche l’objet sur une seule ligne au format JSON.

Utilisez splice(start, deleteCount) lorsque vous devez choisir la position. Pour supprimer le premier élément, passez 0 comme valeur de start et 1 comme valeur de deleteCount. Le tableau d’origine est modifié et la méthode renvoie un tableau contenant les éléments supprimés. Par exemple, avec const values = ["red", "green", "blue"], const removed = values.splice(0, 1) laisse values égal à ["green", "blue"] et attribue ["red"] à removed.

L’argument start désigne un index ; il ne définit pas un sens de parcours. Un index positif ou nul est compté depuis le début, tandis qu’un index négatif est compté depuis la fin (-1 désigne le dernier élément). deleteCount indique le nombre d’éléments à supprimer à partir de cette position. Si vous omettez cet argument, splice() supprime tous les éléments à partir de start. Les éléments fournis après deleteCount sont insérés à cette position. Pour connaître tous les paramètres de la méthode, consultez la référence MDN de splice().

Supprimer le premier élément sans modifier le tableau d’origine

slice() et filter() renvoient de nouveaux tableaux sans modifier le tableau d’entrée. Utilisez slice(1) pour copier simplement tous les éléments qui suivent le premier. L’index start est inclus et l’index end, facultatif, est exclu. Ainsi, values.slice(1) copie les éléments à partir de l’index 1 jusqu’à la fin ; cette opération ne supprime rien de values. Pour en savoir plus, consultez le guide sur slice() et la référence MDN de slice().

Utilisez filter() lorsque la suppression dépend d’une condition. Son callback est appelé pour chaque élément ; ceux pour lesquels il renvoie true sont inclus dans un nouveau tableau. Pour ignorer uniquement la première position, filtrez selon l’index :

const remaining = values.filter((item, index) => index > 0);

Les éléments suivants restent dans leur ordre actuel, et values est conservé. Filtrer selon l’index exprime une règle de position : même si le tableau a déjà été réordonné, l’élément à la position 0 sera exclu, quelle que soit sa valeur.

Par exemple, avec const values = ["red", "green", "blue"], values.slice(1) et values.filter((item, index) => index > 0) produisent chacun un nouveau tableau contenant ["green", "blue"], tandis que values reste égal à ["red", "green", "blue"].

Choisir la méthode adaptée à vos besoins

  • Utilisez shift() si le tableau d’origine doit être modifié et que vous avez besoin de l’élément supprimé comme valeur unique.
  • Utilisez splice(0, 1) si le tableau d’origine doit être modifié et qu’un tableau des éléments supprimés vous est utile, ou adaptez l’index et le nombre pour supprimer des éléments ailleurs.
  • Utilisez slice(1) si vous voulez un nouveau tableau contenant tous les éléments après le premier.
  • Utilisez filter() si les éléments à conserver sont déterminés par une condition ; une condition fondée sur l’index suffit pour omettre la première position.

Le choix principal dépend de la nécessité pour le reste du code de conserver le tableau d’origine. Les méthodes qui modifient le tableau mettent à jour ce tableau partagé : toutes les références qui le désignent voient donc le changement. Les méthodes qui ne le modifient pas le laissent disponible et renvoient un résultat distinct. Les quatre méthodes préservent l’ordre relatif des éléments conservés.