Vue d’ensemble du débogage Office des modules

Le débogage Office les applications est essentiellement identique au débogage de n’importe quelle application web. Toutefois, un seul ensemble d’outils ne fonctionne pas pour tous les développeurs de modules. Cela est dû au fait que les compléments peuvent être développés sur différents systèmes d’exploitation et s’exécuter sur plusieurs plateformes. Cet article vous aide à trouver les instructions de débogage détaillées pour votre environnement de développement.

Côté serveur ou côté client ?

Le débogage du code côté serveur d’un Office est identique au débogage côté serveur d’une application web. Consultez les instructions de débogage pour votre IDE ou d’autres outils. Voici quelques exemples pour certains des outils les plus populaires.

• Débogage Express
• Node.js de débogage
• Node.js débogage dans VS Code
• Débogage Webpack
• Déboguer ASP.NET applications dans Visual Studio

Le reste de cet article ne concerne que le débogage du JavaScript côté client (qui peut être transposé de TypeScript).

Cas particuliers

Dans certains cas particuliers, le processus de débogage diffère de la normale pour une combinaison donnée de plateforme, d’application Office et d’environnement de développement. Si vous déboguez l’un de ces cas spéciaux, utilisez les liens de cette section pour trouver les conseils appropriés. Sinon, continuez à Instructions générales.

• Débogage d’un complément qui est déjà en environnement intermédiaire ou de production : Débogage des compléments en environnement intermédiaire ou de production
• Débogage la fonction Office.initialize ou Office.onReady : Déboguer les fonctions initialize et onReady.
• Debugging d’une fonction personnalisée Excel dans un runtime non-partagé : Débogage de fonctions personnalisées dans un runtime non-partagé.
• Débogage d'unecommande de fonctiondans un runtime non-partagée :
  • Compléments Outlook sur un ordinateur de développement Windows : commandes de fonction de débogage dans les compléments Outlook
  • Autres compléments d’application Office ou Outlook sur un ordinateur de développement Mac : Déboguez une commande de fonction avec un runtime non partagé.
• Débogage d’un complément basé sur des événements ou signalant du spam : Déboguer les compléments basés sur les événements et les rapports de spam.
• Débogage d’un complément dans le nouveau client de bureau Outlook sur Windows : voir la section « Déboguer votre complément » de la rubrique Développer des compléments Outlook pour le nouvel Outlook sur Windows.
• Débogage d’un complément basé sur Blazor : déboguez le complément de la même manière que vous débogueriez une application web Blazor. Voir Débogage ASP.NET Core Blazor WebAssembly.

Directives générales

Pour trouver des conseils pour le débogage du code côté client, la première variable est le système d’exploitation de votre ordinateur de développement.

• Windows
• Mac
• Linux ou une autre variante Unix

Débogage sur Windows

Le débogage sur Windows dépend de votre IDE.

• Visual Studio : Déboguer à l’aide des outils F12 du navigateur. Afficher Debug Compléments Office in Visual Studio

  Importante

  À partir de Visual Studio 2026, le développement et la publication des compléments Office dans Visual Studio sont déconseillés et seront supprimés dans une prochaine version. La prise en charge du développement de compléments Office sous une forme différente pourra être ajoutée à une version ultérieure de Visual Studio.

  Nous vous recommandons de créer des projets de compléments Office à l’aide de Microsoft 365 Agents Toolkit ou Yeoman Generator pour les compléments Office.

• Tout autre IDE (ou vous ne voulez pas déboguer à l’intérieur de votre IDE) : Déboguez avec les outils de débogage Webview2. Consultez Compléments de débogage à l’aide des outils de développement dans Microsoft Edge.

Débogage sur Mac

Utilisez l’inspecteur Web de Safari. Les instructions sont dans Déboguer des Office sur un Mac.

Débogage sur Linux

Il n’existe aucune version de bureau de Office pour Linux. Vous devrez donc recharger une version test du Office sur le Web pour le tester et le déboguer. Voir Compléments de débogage dans Office sur le Web.

Déboguer des compléments en préproduction ou en production

Pour déboguer un complément déjà en préproduction ou en production, attachez un débogueur à partir de l’interface utilisateur du complément. Pour obtenir des instructions, consultez Attacher un débogueur à partir du volet Office.

Versions de office.js pour le débogage

Il existe des versions de débogage des bibliothèques JavaScript Office. Ces versions sont plus lisibles par l’homme et plus faciles à parcourir avec un débogueur. Évitez de les utiliser lorsque vous publiez et déployez votre complément.

Les versions de débogage se trouvent aux emplacements CDN suivants.

• Bibliothèque d’API JavaScript Office : https://officeapis.public.onecdn.static.microsoft/1/office.debug.js
• Bibliothèque de l’API JavaScript Office (préversion) : https://officeapis.public.onecdn.static.microsoft/beta/office.debug.js

Voir aussi

• Test des compléments Office
• Résolution des erreurs de développement
• Déboguer votre complément avec la journalisation runtime
• Vider le cache Office
• Temps d'exécution dans les compléments Office