Accesseurs de propriétés

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Les accesseurs de propriété permettent de fournir un accès aux propriétés d'un objet en utilisant une notation avec un point ou une notation avec des crochets

Exemple interactif

const person1 = {};
person1["firstname"] = "Mario";
person1["lastname"] = "Rossi";

console.log(person1.firstname);
// Expected output: "Mario"

const person2 = {
  firstname: "John",
  lastname: "Doe",
};

console.log(person2["lastname"]);
// Expected output: "Doe"

Syntaxe

js
objet.propriété;
objet["propriété"];

Description

Les objets peuvent être vus comme des tableaux associatifs (map, dictionnaires, table de hachage, annuaire, etc.). Les clés (keys) de ce tableau sont les noms des propriétés de l'objet. Lorsqu'on parle d'objets, on fait généralement une distinction entre les propriétés et les méthodes. En réalité cette différence est plus dûe à une convention qu'à une réelle distinction. En effet, une méthode est simplement une propriété qu'on peut appeler (sa valeur fera souvent référence à une instance de Function).

Il existe deux façons d'accéder aux propriétés d'un objet : la notation avec point et la notation avec crochets.

Notation avec point

js
obtenir = objet.propriété;
objet.propriété = définir;

propriété doit être un identifiant JavaScript valide, c'est-à-dire une séquence de caractères alphanumériques, soulignés (« _ ») et signes dollar (« $ »), qui ne peut commencer par un nombre. Par exemple, objet.$1 est valide, mais objet.1 ne l'est pas.

js
document.createElement("pre");

Ici, la méthode createElement est obtenue depuis l'objet document et est appelée.

Si on utilise une méthode pour un littéral numérique et que celui-ci ne possède pas de point décimal ni d'exposant lié à la notation scientifique, il faudra laisser un ou plusieurs blancs afin que l'appel soit bien interprété comme un appel de méthode plutôt que comme un séparateur décimal :

js
(77).toExponential();
// ou
(77).toExponential();
// ou, mieux pour la lisibilité
(77).toExponential();
// ou encore
(77.0).toExponential();
// 77. correspond à 77.0 et là il n'y a aucun doute

Notation avec crochets

js
obtenir = objet[nom_de_propriété];
objet[nom_de_propriété] = définir;

nom_de_propriété est une chaîne de caractères ou un symbole. Elle n'a pas besoin d'être un identifiant valide ; elle peut avoir n'importe quelle valeur, par exemple "1foo", "!bar!" ou même " " (une espace).

Exemple

js
document["createElement"]("pre");

Cette ligne fait exactement la même chose que l'exemple précédent.

Noms de propriétés

Les noms de propriétés doivent être des chaînes de caractères ou des symboles. Cela signifie que les autres types d'objet ne peuvent pas être utilisés comme clés d'un objet. Tout autre type d'objet, même un nombre, sera converti en une chaîne via sa méthode toString.

Exemples

js
var objet = {};
objet["1"] = "valeur";
console.log(objet[1]);

Ceci affichera « valeur », étant donné que le nombre 1 sera converti en une chaîne "1".

js
var toto = {propriété_unique : 1}, truc = {propriété_unique : 2}, objet = {};
objet[toto] = 'valeur';
console.log(objet[truc]);

Ce code affichera également « valeur », étant donné que toto et truc seront convertis en la même chaîne de caractères. Dans le cas du moteur JavaScript SpiderMonkey, cette chaîne serait "['object Object']".

Liaison de méthodes

Une méthode n'est pas liée à l'objet dont elle est une méthode. En particulier, this n'est pas défini dans une méthode, c'est-à-dire que this ne fait pas nécessairement référence à un objet contenant la méthode. En réalité, this est « passé » par l'appel de la fonction.

Pour plus d'informations, consultez la page sur l'opérateur this et les liaisons de méthodes.

Note concernant eval

Les nouveaux venus en JavaScript font souvent l'erreur d'utiliser eval() alors que la notation avec crochets pourrait être utilisée. Par exemple, la syntaxe suivante est utilisée dans de nombreux scripts.

js
x = eval("document.formulaire." + controle + ".value");

eval est lente et insécurisée et devrait être évitée dès que possible. Il est préférable d'utiliser la notation avec crochets :

js
x = document.formulaire[controle].value;

Spécifications

Specification
ECMAScript® 2025 Language Specification
# sec-property-accessors

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
Property accessors

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi