1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
---
title: Reflect
slug: Web/JavaScript/Reference/Global_Objects/Reflect
tags:
- ECMAScript 2015
- JavaScript
- Reference
- Reflect
translation_of: Web/JavaScript/Reference/Global_Objects/Reflect
original_slug: Web/JavaScript/Reference/Objets_globaux/Reflect
---
<div>{{JSRef}}</div>
<p><code><strong>Reflect</strong></code> est un objet natif qui fournit des méthodes pour les opérations qui peuvent être interceptées en JavaScript (via les proxies). Les méthodes de cet objet sont les mêmes que celles des <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Proxy/handler">gestionnaires de proxy</a>. <code>Reflect</code> n'est pas une fonction (y compris pour construire un objet).</p>
<h2 id="Description">Description</h2>
<p>Contrairement à la plupart des objets globaux, <code>Reflect</code> n'est pas un constructeur. Il ne peut pas être utilisé avec l'opérateur {{jsxref("Opérateurs/L_opérateur_new","new")}} ou être invoqué comme une fonction. Les propriétés et méthodes de <code>Reflect</code> sont statiques (comme pour celles de l'objet {{jsxref("Math")}}).</p>
<h2 id="Méthodes">Méthodes</h2>
<p>L'objet <code>Reflect</code> fournit des fonctions statiques qui ont les mêmes noms que les méthodes des <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Proxy/handler">gestionnaires de proxy</a> et dont certaines correspondent, <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Reflect/Comparing_Reflect_and_Object_methods">avec quelques différences</a>, à celles d'{{jsxref("Object")}} :</p>
<dl>
<dt>{{jsxref("Reflect.apply()")}}</dt>
<dd>Appelle une fonction cible avec les arguments définis par le paramètres <code>args</code>. Voir aussi {{jsxref("Function.prototype.apply()")}}.</dd>
<dt>{{jsxref("Reflect.construct()")}}</dt>
<dd> L'opérateur {{jsxref("Opérateurs/L_opérateur_new","new")}} comme fonction. C'est équivalent à <code>new cible(...args)</code>. Cette méthode permet également d'indiquer un prototype différent.</dd>
<dt>{{jsxref("Reflect.defineProperty()")}}</dt>
<dd>Semblable à {{jsxref("Object.defineProperty()")}}. Renvoie un {{jsxref("Boolean")}}.</dd>
<dt>{{jsxref("Reflect.deleteProperty()")}}</dt>
<dd>L'opérateur {{jsxref("Opérateurs/L_opérateur_delete","delete")}} comme fonction. C'est équivalent à <code>delete cible[nom]</code>.</dd>
<dt>{{jsxref("Reflect.get()")}}</dt>
<dd>Une fonction qui renvoie la valeur d'une propriété.</dd>
<dt>{{jsxref("Reflect.getOwnPropertyDescriptor()")}}</dt>
<dd>Semblable à {{jsxref("Object.getOwnPropertyDescriptor()")}}. Renvoie un descripteur de propriété si la propriété existe sur l'objet, {{jsxref("undefined")}} sinon.</dd>
<dt>{{jsxref("Reflect.getPrototypeOf()")}}</dt>
<dd>Identique à {{jsxref("Object.getPrototypeOf()")}}.</dd>
<dt>{{jsxref("Reflect.has()")}}</dt>
<dd>L'opérateur {{jsxref("Opérateurs/L_opérateur_in","in")}} comme fonction. Renvoie un booléen qui indique si une telle propriété existe pour l'objet (qu'elle soit directement rattachée ou héritée).</dd>
<dt>{{jsxref("Reflect.isExtensible()")}}</dt>
<dd>La même fonction que {{jsxref("Object.isExtensible()")}}.</dd>
<dt>{{jsxref("Reflect.ownKeys()")}}</dt>
<dd>Renvoie un tableau de chaînes de caractères qui correspondent aux noms des propriétés propres (celles qui ne sont pas héritées) de l'objet.</dd>
<dt>{{jsxref("Reflect.preventExtensions()")}}</dt>
<dd>Semblable à {{jsxref("Object.preventExtensions()")}}. Renvoie un {{jsxref("Boolean")}}.</dd>
<dt>{{jsxref("Reflect.set()")}}</dt>
<dd>Une fonction qui affecte des valeurs à des propriétés. Renvoie un {{jsxref("Boolean")}} qui vaut <code>true</code> si la mise à jour a bien été effectuée.</dd>
<dt>{{jsxref("Reflect.setPrototypeOf()")}}</dt>
<dd>Une fonction qui permet de définir le prototype d'un objet.</dd>
</dl>
<h2 id="Spécifications">Spécifications</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Spécification</th>
<th scope="col">État</th>
<th scope="col">Commentaires</th>
</tr>
<tr>
<td>{{SpecName('ES2015', '#sec-reflect-object', 'Reflect')}}</td>
<td>{{Spec2('ES2015')}}</td>
<td>Définition initiale.</td>
</tr>
<tr>
<td>{{SpecName('ESDraft', '#sec-reflect-object', 'Reflect')}}</td>
<td>{{Spec2('ESDraft')}}</td>
<td>Retrait de <code>Reflect.enumerate</code></td>
</tr>
</tbody>
</table>
<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
<p>{{Compat("javascript.builtins.Reflect")}}</p>
<h2 id="Voir_aussi">Voir aussi</h2>
<ul>
<li>L'objet global {{jsxref("Proxy")}}.</li>
<li>L'objet {{jsxref("Proxy.handler", "handler")}}.</li>
</ul>
|
