Caractère énumérable des propriétés et rattachement

Les propriétés dites « énumérables » sont celles qui peuvent être parcourues dans une boucle for..in (sauf si le nom de la propriété est un symbole). Techniquement, les propriétés énumérables sont celles dont le marqueur [[Enumerable]] (interne au moteur) vaut true. Le rattachement (ou la propriété) d'une propriété est déterminé selon qu'une propriété est directement liée à un objet ou descend grâce à la chaîne de prototypes. Il est également possible de récupérer toutes les propriétés d'un objet. Il existe plusieurs façons, gérées nativement, qui permettent de détecter/itérer/énumérer/récupérer des propriétés. Le tableau ci-dessous a pour but de lister celles qui sont disponibles. Des exemples de codes sont listés ci-après pour illustrer comment récupérer les autres propriétés

Obtenir les propriétés selon leur énumérabilité/rattachement

Note : les algorithmes utilisés ici ne sont pas les plus efficaces mais permettent juste de démontrer ce qu'on peut faire.

• Pour utiliser la détection : SimplePropertyRetriever.laMéthodeGetSouhaitée(obj).indexOf(prop) > -1
• Pour itérer : SimplePropertyRetriever.laMéthodeGetSouhaitée(obj).forEach(function (value, prop) {}); (ou avec filter(), map(), etc.)

var SimplePropertyRetriever = {
    getOwnEnumerables: function (obj) {
        return this._getPropertyNames(obj, true, false, this._enumerable); 
        // On pourrait aussi utiliser for..in en filtrant sur hasOwnProperty ou juste : return Object.keys(obj);
    },
    getOwnNonenumerables: function (obj) {
        return this._getPropertyNames(obj, true, false, this._notEnumerable);
    },
    getOwnEnumerablesAndNonenumerables: function (obj) {
        return this._getPropertyNames(obj, true, false, this._enumerableAndNotEnumerable);
        // Ou juste : return Object.getOwnPropertyNames(obj);
    },
    getPrototypeEnumerables: function (obj) {
        return this._getPropertyNames(obj, false, true, this._enumerable);
    },
    getPrototypeNonenumerables: function (obj) {
        return this._getPropertyNames(obj, false, true, this._notEnumerable);
    },
    getPrototypeEnumerablesAndNonenumerables: function (obj) {
        return this._getPropertyNames(obj, false, true, this._enumerableAndNotEnumerable);
    },
    getOwnAndPrototypeEnumerables: function (obj) {
        return this._getPropertyNames(obj, true, true, this._enumerable); 
        // Ou juste utiliser for..in sans filtre
    },
    getOwnAndPrototypeNonenumerables: function (obj) {
        return this._getPropertyNames(obj, true, true, this._notEnumerable);
    },
    getOwnAndPrototypeEnumerablesAndNonenumerables: function (obj) {
        return this._getPropertyNames(obj, true, true, this._enumerableAndNotEnumerable);
    },
    // Fonctions privées statiques pour vérifier les propriétés
    _enumerable : function (obj, prop) {
        return obj.propertyIsEnumerable(prop);
    },
    _notEnumerable : function (obj, prop) {
        return !obj.propertyIsEnumerable(prop);
    },
    _enumerableAndNotEnumerable : function (obj, prop) {
        return true;
    },
    // Fragment de code inspiré de https://stackoverflow.com/a/8024294/271577
    _getPropertyNames : function getAllPropertyNames(obj, iterateSelfBool, iteratePrototypeBool, includePropCb) {
        var props = [];

        do {
            if (iterateSelfBool) {
                Object.getOwnPropertyNames(obj).forEach(function (prop) {
                    if (props.indexOf(prop) === -1 && includePropCb(obj, prop)) {
                        props.push(prop);
                    }
                });
            }
            if (!iteratePrototypeBool) {
                break;
            }
            iterateSelfBool = true;
        } while (obj = Object.getPrototypeOf(obj));

        return props;
    }
};

Tableau sur la détection

Voir aussi

• in
• for..in
• hasOwnProperty
• propertyIsEnumerable
• getOwnPropertyNames
• Object.keys