SCRIPT_DEBUG

Définition : SCRIPT_DEBUG est une constante WordPress qui demande le chargement des versions de développement de certains fichiers JavaScript et CSS du Core, plutôt que leurs versions minifiées, afin de faciliter le diagnostic.

Terminologie

Appellation / équivalent : Script Debug — débogage des scripts et styles

Autres appellations : Débogage des ressources statiques, Scripts non minifiés

Comprendre le fonctionnement

En mode habituel, WordPress utilise des fichiers de production optimisés pour ses ressources JavaScript et CSS intégrées. Avec SCRIPT_DEBUG activé, il privilégie les versions de développement correspondantes lorsque celles-ci existent, ce qui rend le code plus facile à examiner dans les outils du navigateur.

Cette constante ne transforme pas automatiquement les fichiers des thèmes ou des plugins tiers, et ne remplace pas les outils de construction ni les cartes de sources. Elle sert principalement au diagnostic du Core. Le réglage peut modifier les ressources chargées et ne constitue pas une optimisation pour un site public.

Exemple concret

Pour comprendre une anomalie affectant un script natif d’administration, un développeur compare le comportement avec les ressources non minifiées.

Exemple de code commenté

<?php
// Développement uniquement, dans wp-config.php avant le Core.
define( 'SCRIPT_DEBUG', true );

Point technique à retenir

Ne pas confondre SCRIPT_DEBUG, qui concerne des ressources JS/CSS, avec WP_DEBUG, dédié au débogage applicatif notamment PHP.

Termes associés

  • WP_DEBUG
  • wp-config.php
  • JavaScript
  • Core WordPress

Références officielles

Bouton retour en haut de la page