Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Array.prototype.shift : retrait du premier élément

shift retire l’indice zéro, déplace les autres propriétés à gauche et renvoie la première valeur initiale.

Version : ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntaxe

array.shift()

array.shift() lit l’indice 0, déplace chaque propriété présente suivante d’une position à gauche, supprime la dernière position, réduit length et renvoie la valeur lue. Un tableau vide renvoie undefined et fixe length à 0. Les trous sont conservés par suppression de la propriété cible, sans devenir des éléments undefined.

La méthode modifie le receveur, a un coût linéaire pour un tableau ordinaire et est générique pour les objets array-like modifiables. Elle ne prend aucun argument. Un receveur null ou undefined lève TypeError. Getter, setter, Proxy, propriété en lecture seule ou indice non configurable peut lever une erreur ; les déplacements antérieurs ne sont pas forcément annulés et la modification peut rester partielle.

Exemples

const values = ["a", "b", "c"];
console.log(values.shift(), values.join(","), values.length);
const sparse = [, "b", , "d"];
const first = sparse.shift();
console.log(first, sparse.length, Object.keys(sparse).join(","), sparse[0], sparse[2]);
const record = { 0: "x", 1: "y", length: 2 };
console.log(Array.prototype.shift.call(record), record[0], record.length, 1 in record);

Résultat

a b,c 2
undefined 3 0,2 b d
x y 1 false

Sources