Object.preventExtensions — empêcher l’ajout de propriétés
Object.preventExtensions(obj) empêche de façon irréversible l’ajout de propriétés propres à un objet et renvoie ce même objet. Cela ne fige ni les valeurs existantes ni les objets imbriqués.
CKTIS / JavaScript
Syntaxe, opérateurs et concepts de programmation. Trouvez une explication, explorez un exemple et reprenez votre apprentissage.
Object.preventExtensions(obj) empêche de façon irréversible l’ajout de propriétés propres à un objet et renvoie ce même objet. Cela ne fige ni les valeurs existantes ni les objets imbriqués.
Object.prototype.constructor est une propriété de données dont la valeur initiale est la fonction Object. Les objets héritent généralement de constructor depuis un prototype, mais cette propriété peut être masquée ; elle ne permet donc pas d’identifier un type de manière fiable.
Object.prototype.hasOwnProperty() vérifie si une propriété appartient directement à un objet plutôt qu’à son prototype. Découvrez sa différence avec `in` et comment l’appeler de façon sûre lorsque la méthode est masquée.
Object.seal empêche l’ajout et la suppression des propriétés propres d’un objet, sans le rendre immuable. Sur un objet ordinaire, les propriétés de données accessibles en écriture peuvent toujours recevoir de nouvelles valeurs, et les objets imbriqués ne sont pas scellés automatiquement.
Pour un objet ordinaire, un appel réussi à `Object.setPrototypeOf(obj, proto)` définit son prototype interne sans copier de propriétés et renvoie le même objet. `proto` doit être un objet ou `null`. Si la cible d’un `Proxy` est extensible, son intercepteur `setPrototypeOf` peut signaler un succès sans modifier le prototype de la cible. L’appel renvoie tout de même le `Proxy` d’origine.
Object.values(obj) renvoie un nouveau tableau contenant les valeurs des propriétés propres, énumérables et dont les clés sont des chaînes. Les propriétés héritées ou non énumérables, ainsi que les clés Symbol, sont exclues.
Promise.all renvoie une seule promesse pour tous les éléments d’un objet itérable. Si l’itération se termine sans erreur et que tous les éléments fournissent une valeur, la promesse est tenue avec un tableau de résultats dans l’ordre d’entrée. Le premier rejet observé parmi les promesses d’entrée entraîne le rejet de la promesse commune. Une exception levée pendant l’itération peut aussi entraîner son rejet, même si aucune promesse d’entrée n’est rejetée. La méthode n’annule pas les autres opérations.
Promise.allSettled accepte un objet itérable et renvoie une promesse contenant un tableau des résultats de tous ses éléments. Elle conserve l’ordre d’entrée et enregistre aussi bien les valeurs des promesses tenues que les motifs de rejet.
Promise.any accepte un objet itérable et renvoie une promesse tenue avec la valeur du premier succès que la méthode observe. Les rejets des entrées ne mettent pas fin à l’attente, sauf si toutes les entrées sont rejetées ; dans ce cas, le résultat est rejeté avec AggregateError.
La méthode catch() ajoute un gestionnaire de rejet à une promesse. Elle permet de récupérer en renvoyant une valeur de succès ou de propager un échec et, avec la méthode then standard, renvoie une nouvelle promesse.
Promise.prototype.finally exécute une fonction après la réalisation ou le rejet d’une promesse. Il permet un nettoyage commun qui préserve normalement le résultat initial, même si un échec du nettoyage peut le remplacer.
Promise.prototype.then enregistre des gestionnaires de résolution ou de rejet et renvoie une nouvelle promesse. Le résultat du gestionnaire détermine la suite de la chaîne.
Promise.race(iterable) renvoie une promesse qui adopte la valeur de réalisation ou la raison de rejet du premier dénouement traité. Elle n’attend pas le premier succès et n’annule pas les autres opérations.
Promise.reject(reason) crée une nouvelle promesse rejetée avec la raison fournie. Les gestionnaires de rejet s’exécutent de manière asynchrone, même si la promesse renvoyée est déjà rejetée au moment où elle est renvoyée.
Promise.resolve(value) permet de traiter une valeur ordinaire, une promesse ou un thenable comme une promesse. La méthode peut renvoyer une promesse existante sans la modifier ; resolved ne signifie ni que le résultat est déjà disponible ni que l’opération réussira.
Promise.withResolvers() renvoie une nouvelle promesse ainsi que les fonctions resolve et reject qui lui sont associées. Cette méthode sépare la création de la promesse de la fourniture de son résultat, par exemple pour adapter une interface fondée sur des callbacks.
Proxy crée un objet qui sert d’intermédiaire pour les opérations sur un objet cible. Les méthodes handler.get et handler.set permettent de calculer des valeurs lors de la lecture et de contrôler les écritures, tout en respectant les invariants du langage.
RangeError est un type d’erreur intégré à ECMAScript qui indique une valeur en dehors d’un ensemble ou d’une plage autorisés. Il permet de signaler des arguments invalides et de traiter ces exceptions avec try...catch.
ReferenceError est un type d’erreur JavaScript intégré, déclenché notamment lors de la lecture d’un nom non résolu ou d’une variable avant son initialisation. Découvrez en quoi une variable manquante diffère de undefined et pourquoi typeof ne contourne pas les règles d’initialisation.
Reflect.apply appelle une fonction avec une valeur de `this` fournie et des arguments lus dans un objet passé en paramètre. La méthode renvoie le résultat de la fonction sans lire la propriété `apply` de celle-ci.
Reflect.construct appelle un constructeur avec des arguments lus dans un objet. Son paramètre facultatif newTarget permet de distinguer le constructeur exécuté de la valeur de new.target et du choix habituel du prototype.
Reflect.defineProperty définit ou modifie une propriété propre d’un objet à l’aide d’un descripteur. La méthode renvoie true ou false, mais ne garantit pas une exécution sans exception.
Reflect.deleteProperty(target, propertyKey) tente de supprimer une propriété propre d’un objet et renvoie un résultat booléen. Pour un objet ordinaire, la méthode renvoie true même si la propriété est absente, et false si elle a configurable: false.
`Reflect.get` lit une propriété d’un objet, y compris une propriété héritée. Lors d’une recherche ordinaire, le récepteur est transmis au getter comme argument `this`, sans changer le point de départ de la recherche.