blob: e2d63049137e51bce6b3756d0bc91f7da978c814 (
plain)
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
|
---
title: Function.caller
slug: Web/JavaScript/Reference/Global_Objects/Function/caller
tags:
- Function
- JavaScript
- Propriété
- Reference
translation_of: Web/JavaScript/Reference/Global_Objects/Function/caller
original_slug: Web/JavaScript/Reference/Objets_globaux/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>
<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>
|
