L'objet Array en JavaScript, référence et test interactif

Avant le test en ligne des attributs et méthodes de l'objet Array (tableau), une description de chacun.

L'objet Array existe depuis la version 1.1 de JavaScript et a été augmenté dans la version 1.3, compatible avec le standard ECMA-262 comme la version 1.5 qui est décrite ici.

Le constructeur a deux types d'arguments

Le constructeur admet pour argument soit la taille prévue pour le tableau, soit une liste d'éléments contenus.

La syntaxe est:

var x = new Array(nombre);
ou
var x = new Array(élément0, élément1, etc...);

Exemple:

var x = new Array("un", "deux", 254);

Une variable peut être argument comme tout objet:

var y = "demo";
var x = new Array(y);
document.write(x[0]);

On peut aussi créer un tableau à partir d'un littéral:

var a = [ "un", "deux", 254 ];

La variable ainsi déclarée aura les attributs et méthodes de l'objet Array.

On accède aux éléments par un indice

Les tableaux, qu'ils soient créés à partir d'un littéral ou d'un constructeur, sont des objets. On accède aux éléments par l'indice comme expliqué dans le chapitre Les tableaux en JavaScript.

Exemple:

var x = new Array("un", "deux", 254);
document.write(x[2])   // doit retourner 254

Des attributs de taille et d'expression régulière

Le tableau possède les attributs suivants:

int length

Le nombre d'éléments contenus par le tableau, ou dont la position est réservée.

Exemple montrant la taille donnée par l'attribut length.
var x = new Array(10);
x[2] = "deux";
document.write(x);
document.write(x.length);
Si le tableau est créé dynamiquement, length correspond au nombre d'éléments actuels.
Mais si on crée des emplacement vides, en assignant une position au delà de la dernière position occupée, la taille prendra en compte les emplacements vides.
Exemple:
var x = new Array();
x[4] = "quatre"; 

int index

Pour un tableau qui est le résultat d'un test d'expression régulière, c'est l'index de la chaîne trouvée.

String input

Pour un tableau qui est le résultat d'un test d'expression régulière, c'est la chaîne initiale sur laquelle est appliquée l'expression.

Assigner un tableau crée une nouvelle référence

Si l'on assigne le tableau b à la variable a, les deux variables a et b pointeront sur le même tableau.

var b = ["un", "deux"]
var a = b
b.push("trois")
document.write(a)>

Résultat:

Pour faire une copie indépendante de l'original, on utilise la méthode slice.

var a = b.slice()

Essayer interactivement les méthodes pour accéder aux éléments ou transformer le tableau

Comme pour tout objet, on peut invoquer des méthodes associées au nom d'une instance de Array.

var x = new Array();
x.push("a");

A partir d'un ensemble de chaînes de caractères que vous donnez pour créer le tableau, vous allez tester les méthodes de cet objet.

Description de toutes les méthodes

void push(x): Ajoute un élément à la fin du tableau.
var y = x.pop(): Retourne le dernier élément et l'enlève du tableau.
var x =shift(): Retourne le premier élément et l'enlève du tableau.
void unshift(x): Insère un élément au début du tableau en décalant le contenu d'une position.
Integer i = indexOf(String): Retourne la position de l'élément donné en paramètre.
Si l'élément n'est pas trouvé dans le tableau, retourne -1. Non supporté par IE6.
String s = x.join([sep]): Crée une chaîne de caractères à partir des éléments d'un tableau. Ne modifie pas le tableau.
[sep] est un séparateur optionnel en paramètre.
Array z = x.concat(y): Concatène le contenu du tableau x avec le tableau y et retourne un nouveau tableau z.
Le tableau de départ x n'est pas modifié.
void sort(fonction): Classe les éléments selon un ordre qui applique la fonction donnée en argument.
Array x = slice(int début [, int fin]): Retourne un sous-ensemble du tableau qui reste inchangé. La seconde valeur en option indique la position du dernier élément non inclus. Les valeurs 0, x.length retournent le tableau entier, ce qui est équivalent à slice().
Les valeurs 0, -1 retournent le tableau moins le dernier élément.
Array splice(int pos, int nombre [, element0, element1, ...]): A partir de la position pos, supprime le nombre d'éléments et insère en option les éléments de la liste. Si on supprime 0 éléments il faut au moins ajouter un élément.
Avec splice, le contenu du tableau lui-même change. La méthode retourne dans un autre tableau le ou les éléments supprimés.
String toString(): Fournit une représentation en chaîne de caractère du tableau. Comme join() mais avec virgule comme séparateur obligé.
void reverse(): Inverse l'ordre des éléments contenus.

A partir de Internet Explorer 9

var indexOf(valeur): Retourne l'index dans le tableau de la valeur passée en argument. Retourne -1 si la valeur n'est pas trouvée.
var lastIndexOf(valeur): Retourne l'index à partir de la fin.

Voir aussi

Tableau à plusieurs dimensions: Voir Les tableaux en JavaScript.
Méthodes de parcours d'un tableau: Voir For each en JavaScript.