Débogage — Web

Cette rubrique comprend les sections suivantes :

Connexion à la console

Lorsque vous développez votre application, placez le code ci-dessous quelque part dans votre application. Vous obtiendrez ainsi plus de données de journalisation sur votre console, ce qui vous permettra de mieux tracer votre programme et de comprendre ce qui se passe en coulisses.

  OT.setLogLevel(OT.DEBUG);

Vous pouvez également enregistrer des messages sur la console en appelant la fonction OT.log() méthode :

OT.log("my session ID: " + session.sessionId);

(Appel OT.setLogLevel(OT.DEBUG) ou OT.setLogLevel(OT.LOG) avant d'appeler OT.log().)

Tester plusieurs connexions de clients sur une même machine

Vous ne pouvez pas vous abonner à un flux que vous publiez dans la même page de navigateur. Toutefois, vous pouvez ouvrir la page dans un deuxième onglet (ou fenêtre de navigateur) et vous abonner à un flux publié dans l'autre onglet (ou fenêtre).

Utilisation de gestionnaires d'achèvement

Pour de nombreuses méthodes qui se terminent de manière asynchrone, le dernier paramètre que vous passez est une fonction de gestion de l'achèvement. Cette fonction est appelée lorsque la méthode se termine ou échoue. En cas d'échec, un objet d'erreur est transmis à la fonction en tant que paramètre.

Par exemple, le code suivant appelle la méthode `Session.connect()` en lui transmettant un gestionnaire de fin d'exécution :

  var session = OT.initSession(apiKey, session);
  session.connect(token, function (error) {
    if (error) {
      if (error.name === "OT_NOT_CONNECTED") {
        alert("You are not connected to the internet. Check your network connection.");
      }
      console.log("Failed to connect: ", error.message);
    } else {
      console.log("Connected");
    }
  });

Pour plus d'informations, voir Traitement des exceptions.

Écoute des événements d'exception

Pour détecter tous les événements d'exception, ajoutez un écouteur d'événements pour la fonction exception événement, déclenché par l'objet OT. Il est toutefois plus simple de gérer les erreurs dans les gestionnaires de fin d'exécution associés à des méthodes spécifiques. Voir Traitement des exceptions.

// Listen for exceptions
OT.on("exception", function(event) {
    console.log(event.message);
}

Séances de dépannage avec l'inspecteur

Inspecteur fournit des informations de diagnostic a posteriori sur les sessions OpenTok. Saisissez un identifiant de session ou un identifiant de problème signalé (voir la section suivante) dans Inspector afin de consulter les données brutes au niveau des flux et des utilisateurs, ce qui permet d'identifier plus précisément les erreurs, les défaillances et les problèmes de qualité.

Pour plus de détails, voir le Documentation relative à l'inspecteur.

Problèmes de reproduction avec OpenTok Playground

Terrain de jeux utilise le SDK OpenTok.js pour accéder à la plateforme OpenTok et vous aide à reproduire les problèmes rencontrés lors du déploiement.

Pour plus de détails, voir le Documentation sur les aires de jeux.

Signaler un problème

Vous pouvez appeler le OT.reportIssue() pour signaler par programme les problèmes rencontrés par votre application. Cette méthode vous fournit un numéro d'identification du problème, que vous pouvez utiliser avec la méthode Inspecteur ou en discutant du problème avec l'équipe de soutien de l'API de Vonage.

OT.reportIssue(function(error, issueId) {
  if (error) {
    console.log(error);
  } else {
    console.log(issueId);
    // You may want to use XMLHttpRequest to report this issue ID to a server
    // that can store it in a database for later reference.
  }
});

Les OT.reportIssue() prend un paramètre, une fonction de traitement d'achèvement, qui est appelée lorsque l'appel à la méthode OT.reportIssue() réussit ou échoue. La fonction de gestion des résultats prend deux paramètres. Le premier paramètre est un objet d'erreur qui est défini lorsque l'appel à la reportIssue() échoue (par exemple, si le client n'est pas connecté au réseau) ou que la méthode null lorsque l'appel au reportIssue() réussit. Le deuxième paramètre correspond à l'identifiant du problème signalé (une chaîne de caractères unique) lorsque l'appel aboutit.