Déboguer les fonctions initialize et onReady

Le paradoxe du débogage des fonctions Office.initialize et Office.onReady est qu’un débogueur peut uniquement s’attacher à un processus en cours d’exécution, mais que ces fonctions s’exécutent immédiatement au démarrage du processus d’exécution du complément, avant qu’un débogueur puisse attacher. Dans la plupart des cas, le redémarrage du complément après l’attachement d’un débogueur n’est pas utile, car le redémarrage du complément ferme le processus d’exécution d’origine et le débogueur attaché et démarre un nouveau processus auquel aucun débogueur n’est attaché.

Heureusement, il existe deux façons de déboguer ces fonctions décrites dans les sections suivantes.

Déboguer à l’aide de Office sur le Web

Pour déboguer avec Office sur le Web, procédez comme suit.

1. Charger une version test et exécuter le complément dans Office sur le Web. Cela s’effectue généralement en ouvrant le volet Office d’un complément ou en exécutant une commande de fonction. Le complément s’exécute dans le processus global du navigateur, et non dans un processus distinct comme dans office de bureau.
2. Ouvrez les outils de développement du navigateur. Pour ce faire, appuyez généralement sur F12. Le débogueur dans les outils s’attache au processus du navigateur.
3. Appliquez des points d’arrêt en fonction des besoins au code dans la Office.initialize fonction ou Office.onReady .
4. Relancez le volet Office du complément ou la commande de fonction comme vous l’avez fait à l’étape 1. Cette action ne ferme pas le processus du navigateur ni le débogueur. La Office.initialize fonction ou Office.onReady s’exécute à nouveau et le traitement s’arrête sur vos points d’arrêt.

Déboguer à l’aide d’Office sur Windows

Pour déboguer la séquence d’initialisation de votre complément, configurez votre environnement afin que les outils de développement Microsoft WebView2 s’ouvrent automatiquement au lancement du complément.

1. Fermez l’application Office dans laquelle vous prévoyez de déboguer le complément.
2. Définissez la WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS variable d’environnement pour inclure la valeur --auto-open-devtools-for-tabs.
3. Ouvrez l’application Office.
4. Exécutez le complément.
5. Les outils de développement Microsoft Edge doivent s’ouvrir automatiquement. Utilisez l’outil comme vous le feriez lors du débogage d’un volet Office, comme spécifié dans Déboguer un complément de volet Office à l’aide des outils de développement Microsoft Edge.

Voir aussi

• Temps d'exécution dans les compléments Office