Array : méthode fill() - JavaScript | MDN

Basculer la barre latérale

Thème

Automatique
Clair
Sombre

Français

Se souvenir de la langue En savoir plus

Array : méthode fill()

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 septembre 2015.

La méthode fill() des instances de Array modifie tous les éléments d'un tableau compris dans un intervalle d'indices pour leur attribuer une valeur statique. Elle retourne le tableau modifié.

Dans cet article

Exemple interactif

const array = [1, 2, 3, 4];

// Remplir avec 0 de la position 2 jusqu'à la position 4
console.log(array.fill(0, 2, 4));
// Sortie attendue : Array [1, 2, 0, 0]

// Remplir avec 5 à partir de la position 1
console.log(array.fill(5, 1));
// Sortie attendue : Array [1, 5, 5, 5]

console.log(array.fill(6));
// Sortie attendue : Array [6, 6, 6, 6]

Syntaxe

js
fill(value)
fill(value, start)
fill(value, start, end)

Paramètres

value

Une valeur avec laquelle remplir le tableau. Notez que tous les éléments du tableau auront exactement cette valeur : si value est un objet, chaque case du tableau référencera cet objet.

start Facultatif

L'indice de début (à partir de zéro) à partir duquel commencer à remplir, 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 start < -array.length ou si start est omis, on utilise 0.
Si start >= array.length, aucun indice n'est rempli.

end Facultatif

L'indice de fin (à partir de zéro) auquel arrêter de remplir, converti en entier. fill() remplit jusqu'à mais sans inclure end.

Un indice négatif compte à rebours depuis la fin du tableau : si -array.length <= end < 0, on utilise end + array.length.
Si end < -array.length, on utilise 0.
Si end >= array.length ou si end est omis ou undefined, on utilise array.length, ce qui fait que tous les indices jusqu'à la fin sont remplis.
Si end implique une position avant ou à la même position que celle impliquée par start, rien n'est rempli.

Description

La méthode fill() est une méthode de modification. Elle ne modifie pas la longueur de this, mais elle en modifie le contenu.

La méthode fill() remplit également les cases vides dans les tableaux creux avec value.

La méthode fill() est générique. Elle attend seulement que la valeur de this possède une propriété length. Bien que les chaînes de caractères soient aussi assimilables à des tableaux, cette méthode ne convient pas pour les utiliser, car les chaînes sont immuables.

Note : Utiliser Array.prototype.fill() sur un tableau vide (length = 0) ne le modifiera pas car il n'y a rien à modifier. Pour utiliser Array.prototype.fill() lors de la déclaration d'un tableau, assurez-vous que le tableau a une length non nulle. Voir l'exemple.

Exemples

Utilisation de fill()

js
console.log([1, 2, 3].fill(4)); // [4, 4, 4]
console.log([1, 2, 3].fill(4, 1)); // [1, 4, 4]
console.log([1, 2, 3].fill(4, 1, 2)); // [1, 4, 3]
console.log([1, 2, 3].fill(4, 1, 1)); // [1, 2, 3]
console.log([1, 2, 3].fill(4, 3, 3)); // [1, 2, 3]
console.log([1, 2, 3].fill(4, -3, -2)); // [4, 2, 3]
console.log([1, 2, 3].fill(4, NaN, NaN)); // [1, 2, 3]
console.log([1, 2, 3].fill(4, 3, 5)); // [1, 2, 3]
console.log(Array(3).fill(4)); // [4, 4, 4]

// Un seul objet, référencé par chaque case du tableau :
const arr = Array(3).fill({}); // [{}, {}, {}]
arr[0].hi = "hi"; // [{ hi: "hi" }, { hi: "hi" }, { hi: "hi" }]

Utiliser fill() pour créer une matrice de 1

Cet exemple montre comment créer une matrice remplie de 1, comme la fonction ones() d'Octave ou MATLAB.

js
const arr = new Array(3);
for (let i = 0; i < arr.length; i++) {
  arr[i] = new Array(4).fill(1); // Création d'un tableau de taille 4 rempli de 1
}
arr[0][0] = 10;
console.log(arr[0][0]); // 10
console.log(arr[1][0]); // 1
console.log(arr[2][0]); // 1

Utiliser fill() pour remplir un tableau vide

Cet exemple montre comment remplir un tableau en attribuant une valeur spécifique à tous les éléments. Le paramètre end n'a pas besoin d'être spécifié.

const tempGirls = Array(5).fill("girl", 0);

Notez que le tableau était initialement un tableau creux sans indices attribués. fill() peut tout de même remplir ce tableau.

Appeler fill() sur des objets qui ne sont pas des tableaux

La méthode fill() lit la propriété length de this et définit la valeur de chaque propriété à clé entière de start à end.

js
const objetSimilaireTableau = { length: 2 };
console.log(Array.prototype.fill.call(objetSimilaireTableau, 1));
// { '0': 1, '1': 1, length: 2 }

Guide des collections indexées
L'objet global Array
La méthode TypedArray.prototype.fill()
Prothèse d'émulation de Array.prototype.fill dans core-js (angl.)

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

Objets natifs standards
Array
Constructeur
1. Array()
Méthodes statiques
Propriétés statiques
1. [Symbol.species]
Méthodes d'instance
Propriétés d'instance
1. length
2. [Symbol.unscopables]
Héritage
Object/Function
Méthodes statiques
Propriétés statiques
Méthodes d'instance
Propriétés d'instance
1. Object.prototype.__proto__
2. Object.prototype.constructor