diff options
Diffstat (limited to 'files/fr/web/javascript/reference/global_objects/function/caller')
| -rw-r--r-- | files/fr/web/javascript/reference/global_objects/function/caller/index.html | 82 | ||||
| -rw-r--r-- | files/fr/web/javascript/reference/global_objects/function/caller/index.md | 81 |
2 files changed, 81 insertions, 82 deletions
diff --git a/files/fr/web/javascript/reference/global_objects/function/caller/index.html b/files/fr/web/javascript/reference/global_objects/function/caller/index.html deleted file mode 100644 index 92f4a60f1a..0000000000 --- a/files/fr/web/javascript/reference/global_objects/function/caller/index.html +++ /dev/null @@ -1,82 +0,0 @@ ---- -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>function.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> diff --git a/files/fr/web/javascript/reference/global_objects/function/caller/index.md b/files/fr/web/javascript/reference/global_objects/function/caller/index.md new file mode 100644 index 0000000000..c7736a0831 --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/function/caller/index.md @@ -0,0 +1,81 @@ +--- +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 +--- +{{JSRef}} {{non-standard_header}} + +La propriété **`function.caller`** renvoie la fonction qui a appelé la fonction donnée. Cette propriété est interdite en mode strict. + +## Description + +Si la fonction `f` a été invoquée par du code situé au plus haut niveau, la valeur de `f.caller` sera {{jsxref("null")}}, sinon, ce sera la fonction qui a appelé `f`. + +Cette propriété remplace la propriété obsolète {{jsxref("Fonctions/arguments/caller", "arguments.caller")}} de l'objet {{jsxref("Fonctions/arguments", "arguments")}}. + +La propriété spéciale `__caller__` qui renvoyait l'objet qui dans lequel était fait l'appel a été supprimée pour des raisons de sécurités. + +### Notes + +Dans une fonction récursive, cette propriété ne peut pas être utilisée pour reconstituer la pile d'appels (_call stack_). Par exemple, si on a : + +```js +function f(n) { g(n - 1); } +function g(n) { if (n > 0) { f(n); } else { stop(); } } +f(2); +``` + +Au moment où `stop()` est appelé, la pile sera : + + f(2) -> g(1) -> f(1) -> g(0) -> stop() + +Et ceci est vrai : + + stop.caller === g && f.caller === g && g.caller === f + +Donc si on essaie d'obtenir la pile de cette façon : + +```js +var f = stop; +var stack = 'Stack trace:'; +while (f) { + stack += '\n' + f.name; + f = f.caller; +} +``` + +la boucle ne s'arrêterait jamais. + +## Exemples + +### Vérifier la valeur de la propriété `caller` + +Dans l'exemple suivant, on verifie la propriété `caller` de la fonction. + +```js +function maFonction() { + if (maFonction.caller == null) { + return 'Fonction appelée au plus haut niveau !'; + } else { + return 'Fonction appelée par ' + maFonction.caller; + } +} +``` + +## Spécifications + +Ne fait partie d'aucune spécification. Implémentée avec JavaScript 1.5. + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Function.caller")}} + +## Voir aussi + +- Le bug d'implémentation pour SpiderMonkey {{bug(65683)}} |
