★ wanayoo — archive 1999 https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Objets_globaux/Error/StackNouvelle recherche | Portail wanayoo
Vos résultats de recherche

    Error.prototype.stack

    Non standard
    Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

    Résumé

    La propriété non-standard stack des objets Error offre le déroulé des fonctions qui ont été appelées, dans l'ordre, depuis quel ligne de quel fichier, et avec quels arguments. Cette chaine de caractères commence avec les appels les plus récents, et remontent jusqu'à l'appel original du scope global.

    Description

    Chaque étape sera séparée par une nouvelle ligne. La première partie de la ligne est le nom de la fonction (si l'appel n'est pas depuis le scope global), suivi du signe @, la position du fichier (sauf si la fonction est le constructeur d'erreur lorsque l'erreur est levée), un double point, et, s'il y a une position de fichier, un numéro de ligne. (Notez que l'objet Error possède aussi les propriétés fileName, lineNumber et columnNumber pour récupérer ces informations à partir de l'erreur déclenchée).

    Notez qu'il s'agit du format utilisé par Firefox. Il n'y a aucun formattage standard. Cependant Safari 6+ et Opera 12- utilisent un format très proche. Les navigateurs utilisant le moteur de JavaScript V8 (tel que Chrome, Opera 15+, Navigateur Android) et IE10+, utilisent un format différent (voir la documentation MSDN error.stack).

    Valeurs des arguments dans le stack : Avant Firefox 14 (bug 744842), les noms de fonction étaient suivis par les valeurs des arguments converties en une chaine de caractères dans des parenthèses, avant le signe @. Bien qu'un objet (ou un tableau, etc.) apparaissait sous une forme "[object Object]", et ne pouvait pas être réévalué en de vrai objets, des valeurs scalaires pouvaient être récupérées (Bien qu'il soit plus facile — et cela est encore possible dans Firefox 14 — d'utiliser arguments.callee.caller.arguments, tout comme le nom de la fonction peut être récupéré avec arguments.callee.caller.name). "undefined" est listé comme "(void 0)". Notez que si des chaines de caractères étaient passées en arguments avec des valeurs comme "@", "(", ")" (ou dans le nom des fichiers), vous ne pouviez pas facilement vous reposez sur ceci pour découper la ligne en composants. De fait, dans Firefox 14 (et les versions plus récentes), ceci est moins un problème.

    Exemple

    Le code HTML suivant démontre l'utilisation de la propriété stack.

    <!DOCTYPE HTML>
    <meta charset="UTF-8">
    <title>Exemple Stack Trace</title>
    <body>
        <script>
            function trace() {
                try {
                    throw new Error("myError");
                }
                catch(e) {
                    alert(e.stack);
                }
            }
            function b() {
                trace();
            }
            function a() {
                b(3, 4, "\n\n", undefined, {});
            }
            a("first call, firstarg");
        </script>
    

    Si, par exemple, ce code a été enregistré sous C:\exemple.html sur un système de fichier Windows, il renverra un message d'erreur dans une nouvelle fenêtre avec un certain texte.

    À partir de Firefox 30, ce message contiendra le numéro de colonne (position du caractère sur un ligne du fichier) (bug 762556) :

    trace@file:///C:/example.html:9:17
    b@file:///C:/example.html:16:13
    a@file:///C:/example.html:19:13
    @file:///C:/example.html:21:9

    Pour les versions de Firefox comprises entre les versions 14 et 29 :

    trace@file:///C:/exemple.html:9
    b@file:///C:/exemple.html:16
    a@file:///C:/exemple.html:19
    @file:///C:/exemple.html:21
    

    Firefox 13 et ses versions antérieures auraient produit le texte suivant :

    Error("myError")@:0
    trace()@file:///C:/exemple.html:9
    b(3,4,"\n\n",(void 0),[object Object])@file:///C:/exemple.html:16
    a("first call, firstarg")@file:///C:/exemple.html:19
    @file:///C:/exemple.html:21
    

    Spécifications

    Ne fait partie d'aucune spécification. Non-standard.

    Compatibilité des navigateurs

    Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Support de base (Oui) (Oui) IE10 (Oui) Safari 6
    Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Support de base Android 4 (peut-être Android 3, mais pas Android 2) ? ? ? ? Safari 6

    Voir également

    Étiquettes et contributeurs liés au document

    Contributeurs ayant participé à cette page : tregagnon, teoli, SphinxKnight
    Dernière mise à jour par : teoli,