Object.getOwnPropertyDescriptors()
La méthode Object.getOwnPropertyDescriptors()
renvoie l'ensemble des descripteurs des propriétés propres d'un objet donné.
Exemple interactif
Syntaxe
Object.getOwnPropertyDescriptors(obj);
Paramètres
obj
-
L'objet dont on souhaite connaître les descripteurs des propriétés.
Valeur de retour
Un objet qui contient tous les descripteurs des propriétés propres de l'objet passé en paramètre. S'il n'y aucune propriété, cela sera un objet vide.
Description
Cette méthode permet d'examiner de façon précise les différentes propriétés directement rattachées à un objet. Une propriété JavaScript se définit par un nom (une chaîne de caractères) ou un symbole (Symbol
) et un descripteur. Vous pouvez trouver de plus amples informations sur les types de descripteurs et sur leurs attributs sur la page de Object.defineProperty()
.
Un descripteur de propriété est un enregistrement qui possède les attributs suivants :
value
-
La valeur associée à la propriété (uniquement pour les descripteurs de données).
writable
-
true
si et seulement si la valeur associée à la propriété peut être changée (uniquement pour les descripteurs de données). get
-
Une fonction qui est utilisée comme accesseur pour la propriété ou
undefined
s'il n'existe pas de tel accesseur (uniquement pour les descripteurs d'accesseur/mutateur). set
-
Une fonction qui est utilisée comme mutateur pour la propriété ou
undefined
s'il n'existe pas de tel mutateur (uniquement pour les descripteurs d'accesseur/mutateur). configurable
-
true
si et seulement si le type de descripteur peut être changé et si la propriété peut être supprimée de l'objet correspondant. enumerable
-
true
si et seulement si cette propriété est listée lorsqu'on énumère les propriétés de l'objet correspondant.
Exemples
Créer un clone
La méthode Object.assign()
ne copiera que les propriétés propres et énumérables d'un objet source vers un objet cible. On peut donc utiliser cette méthode avec Object.create()
afin de réaliser une copie « plate » entre deux objets inconnus :
Object.create(
Object.getPrototypeOf(obj),
Object.getOwnPropertyDescriptors(obj),
);
Créer une sous-classe
Pour créer une sous-classe, généralement, on définit la sous-classe et on définit son prototype comme étant une instance de la classe parente. Enfin on définit les propriétés de cette nouvelle sous-classe.
function superclass() {}
superclass.prototype = {
// on définit les méthodes et propriétés
// de la classe parente
};
function subclass() {}
subclass.prototype = Object.create(
superclass.prototype,
Object.getOwnPropertyDescriptors({
// on définit les méthodes et propriétés
// de la sous-classe
}),
);
Spécifications
Specification |
---|
ECMAScript Language Specification # sec-object.getownpropertydescriptors |
Compatibilité des navigateurs
BCD tables only load in the browser