aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/javascript/reference/global_objects/function/caller
diff options
context:
space:
mode:
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.html82
-rw-r--r--files/fr/web/javascript/reference/global_objects/function/caller/index.md81
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 &gt; 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) -&gt; g(1) -&gt; f(1) -&gt; g(0) -&gt; stop()
-</pre>
-
-<p>Et ceci est vrai :</p>
-
-<pre class="eval">stop.caller === g &amp;&amp; f.caller === g &amp;&amp; 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)}}