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.

Attention !
L'objet Debug ne fonctionne qu'avec Internet Explorer et les applications Windows 8 et Windows Phone 8.1.

L'objet Debug est un objet global qui permet d'envoyer des informations au débogueur.

Syntaxe

L'objet Debug n'est pas instancié, il fournit des propriétés et méthodes statiques.

Différents outils permettent de déboguer les applications Internet Explorer et Windows 8.x Store. Pour les applications Windows 8.x Store, les méthodes statiques write et writeln fournies par Debug permettent d'afficher des chaînes de caractères dans le volet Output de Visual Studio lors de l'exécution.

Pour déboguer des scripts Internet Explorer, il faut avoir un débogueur de script installé et le script exécuté en mode debug. Internet Explorer 8 et les versions ultérieures possèdent un débogueur JavaScript inégré.

Si le script n'est pas en cours de débogage, les méthodes et propriétés de Debug n'auront pas d'effet.

Constantes

Codes de statut pour les fonctions de rappel asynchrones

Constante Description Valeur
Debug.MS_ASYNC_CALLBACK_STATUS_ASSIGN_DELEGATE La tâche synchrone a affecté une fonction de rappel ou une continuation à exécuter dans une opération asynchrone. 0
Debug.MS_ASYNC_CALLBACK_STATUS_JOIN La tâche synchrone a rejoint une partie d'une opération asynchrone. 1
Debug.MS_ASYNC_CALLBACK_STATUS_CHOOSEANY La tâche synchrone a satisfait au choix d'une opération asynchrone. 2
Debug.MS_ASYNC_CALLBACK_STATUS_CANCEL La tâche synchrone a été annulée. 3
Debug.MS_ASYNC_CALLBACK_STATUS_ERROR La tâche synchrone a provoqué une erreur dans une opération asynchrone 4

Codes de statut pour les opérations asynchrones

Constante Description Valeur
Debug.MS_ASYNC_OP_STATUS_SUCCESS L'opération asynchrone a réussi. 1
Debug.MS_ASYNC_OP_STATUS_CANCELED L'opération asynchrone a été annulée. 2
Debug.MS_ASYNC_OP_STATUS_ERROR L'opération asynchrone a déclenché une erreur. 3

Propriétés

Debug.debuggerEnabled
Cette propriété indique si le débogage est actif pour le contexte de script courant. Le débogage peut être actif ou non, qu'un débogueur soit attaché ou non.
Debug.setNonUserCodeExceptions
Cette propriété indique si certains blocs try-catch de la portée courante sont considérés par le débogueur comme étant gérés par l'utilisateur.

Méthodes

Debug.msTraceAsyncCallbackCompleted
Indique si la pile d'appel pour les fonctions de rappel associée a une opération asynchrone précédemment définie est terminée.
Debug.msTraceAsyncCallbackStarting
Associe une pile de fonction de rappel à l'opération asynchrone précédemment définie.
Debug.msTraceAsyncOperationCompleted
Indique qu'une opération asynchrone est terminée.
Debug.msTraceAsyncOperationStarting
Initie une trace pour une opération asynchrone.
Debug.msUpdateAsyncCallbackRelation
Met à jour la relation entre la tâche synchrone et l'opération asynchrone associée.
Debug.write
Envoie une chaîne de caractères au débogueur du script.
Debug.writeln
Envoie une chaîne de caractères au débogueur du script, cette chaîne sera suivie par un retour à la ligne.

Exemples

Afficher la valeur d'une variable

Le fragment de code suivant permet d'afficher la valeur d'une variable lorsqu'on débogue le script grâce à la fonction write.

var compteur = 42;
Debug.write("Compteur vaut " + compteur);

Prérequis

Cette fonctionnalité est prise en charge pour les modes : Quirks, Internet Explorer 6 en mode standard, Internet Explorer 7 en mode standard, Internet Explorer 8 en mode standard, Internet Explorer 9 en mode standard, Internet Explorer 10 en mode standard et Internet Explorer 11 en mode standard. Elle est également prise en charge pour les applications Store (Windows 8 et Windows Phone 8.1).

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : SphinxKnight, erikadoyle
Dernière mise à jour par : SphinxKnight,