unshift

La fonction unshift() ajoute un ou plusieurs éléments au début du tableau et retourne une copie enrichie.

Exemple interactif

Syntaxe

Signature classique

function unshift<
	GenericElement extends unknown
>(
	input: readonly GenericElement[],
	element: NoInfer<GenericElement>,
	...elements: NoInfer<GenericElement>[]
): GenericElement[]

Signature currifiée

function unshift<
	GenericElement extends unknown
>(
	element: NoInfer<GenericElement>
): (input: readonly GenericElement[]) => GenericElement[]

Paramètres

• input : Tableau source.
• element, ...elements : Valeurs insérées au début (dans l'ordre fourni).

Valeur de retour

Un nouveau tableau dont le préfixe correspond aux valeurs ajoutées, suivi de l'ancien contenu.

Voir aussi

• shift - Supprime le premier élément
• push - Ajoute en fin de tableau

Sources

• MDN Web Docs - Array.prototype.unshift()