diff options
Diffstat (limited to 'files/fr/web/javascript/reference/objets_globaux/function/caller/index.html')
| -rw-r--r-- | files/fr/web/javascript/reference/objets_globaux/function/caller/index.html | 83 |
1 files changed, 83 insertions, 0 deletions
diff --git a/files/fr/web/javascript/reference/objets_globaux/function/caller/index.html b/files/fr/web/javascript/reference/objets_globaux/function/caller/index.html new file mode 100644 index 0000000000..9956ad14ee --- /dev/null +++ b/files/fr/web/javascript/reference/objets_globaux/function/caller/index.html @@ -0,0 +1,83 @@ +--- +title: Function.caller +slug: Web/JavaScript/Reference/Objets_globaux/Function/caller +tags: + - Function + - JavaScript + - Propriété + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Function/caller +--- +<div>{{JSRef}} {{non-standard_header}}</div> + +<p>La propriété <code><strong><em>function</em>.caller</strong></code> renvoie la fonction qui a appelé la fonction donnée. Cette propriété est interdite en mode strict.</p> + +<h2 id="Description">Description</h2> + +<p>Si la fonction <code>f</code> a été invoquée par du code situé au plus haut niveau, la valeur de <code>f.caller</code> sera {{jsxref("null")}}, sinon, ce sera la fonction qui a appelé <code>f</code>.</p> + +<p>Cette propriété remplace la propriété obsolète {{jsxref("Fonctions/arguments/caller", "arguments.caller")}} de l'objet {{jsxref("Fonctions/arguments", "arguments")}}.</p> + +<p>La propriété spéciale <code>__caller__</code> qui renvoyait l'objet qui dans lequel était fait l'appel a été supprimée pour des raisons de sécurités.</p> + +<h3 id="Notes">Notes</h3> + +<p>Dans une fonction récursive, cette propriété ne peut pas être utilisée pour reconstituer la pile d'appels (<em>call stack</em>). Par exemple, si on a :</p> + +<pre class="brush: js">function f(n) { g(n - 1); } +function g(n) { if (n > 0) { f(n); } else { stop(); } } +f(2); +</pre> + +<p>Au moment où <code>stop()</code> est appelé, la pile sera :</p> + +<pre class="eval">f(2) -> g(1) -> f(1) -> g(0) -> stop() +</pre> + +<p>Et ceci est vrai :</p> + +<pre class="eval">stop.caller === g && f.caller === g && g.caller === f +</pre> + +<p>Donc si on essaie d'obtenir la pile de cette façon :</p> + +<pre class="brush: js">var f = stop; +var stack = 'Stack trace:'; +while (f) { + stack += '\n' + f.name; + f = f.caller; +} +</pre> + +<p>la boucle ne s'arrêterait jamais.</p> + +<h2 id="Exemples">Exemples</h2> + +<h3 id="Vérifier_la_valeur_de_la_propriété_caller">Vérifier la valeur de la propriété <code>caller</code></h3> + +<p>Dans l'exemple suivant, on verifie la propriété <code>caller</code> de la fonction.</p> + +<pre class="brush: js">function maFonction() { + if (maFonction.caller == null) { + return 'Fonction appelée au plus haut niveau !'; + } else { + return 'Fonction appelée par ' + maFonction.caller; + } +} +</pre> + +<h2 id="Spécifications">Spécifications</h2> + +<p>Ne fait partie d'aucune spécification. Implémentée avec JavaScript 1.5.</p> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden">Ce tableau de compatibilité a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une <em>pull request</em> sur <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</div> + +<p>{{Compat("javascript.builtins.Function.caller")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>Le bug d'implémentation pour SpiderMonkey {{bug(65683)}}</li> +</ul> |