Sébastien Laframboise

Réduire le JavaScript inutile chargé par WordPress

Réduire le JavaScript inutile chargé par WordPress

Pour optimiser JavaScript WordPress, ne commencez pas par désactiver des fichiers au hasard. Une page peut charger des scripts pour un formulaire, un carrousel, une carte, une bannière de consentement ou une extension de statistiques. Or, plusieurs de ces fonctions ne servent pas sur toutes les pages.

La bonne approche consiste à examiner ce qui se charge réellement, à retrouver l’extension ou le thème responsable, puis à retirer ou reporter seulement les scripts non essentiels. Vous protégez ainsi les fonctions utiles tout en réduisant le travail demandé au navigateur.

Pourquoi cibler les scripts plutôt que tout le site

Un fichier JavaScript ne coûte pas seulement du temps de téléchargement. Le navigateur doit aussi l’analyser et l’exécuter. Lorsqu’un script classique se trouve dans le document sans attribut defer ni async, il peut interrompre l’analyse du HTML pendant son chargement et son exécution. La documentation de web.dev sur le chargement des ressources explique cette différence entre les scripts bloquants, asynchrones et différés.

Le problème n’est donc pas forcément une extension entière. Par exemple, une extension de formulaires peut être nécessaire sur votre page Contact, mais son script n’a pas forcément sa place sur chaque article de blogue. De même, un script de galerie peut rester utile sur certaines fiches ou pages de service, sans être chargé sur l’ensemble du site.

Cette méthode complète l’analyse des extensions, sans la remplacer. Si vous devez d’abord déterminer quel outil génère une ressource, consultez aussi comment repérer les extensions WordPress qui ralentissent votre site. Ici, l’objectif est plus précis : décider si un fichier JavaScript doit être présent sur une page donnée.

Faire l’inventaire des scripts chargés par une page

Choisissez une page représentative, comme la page d’accueil, un article et une page de contact. Ensuite, ouvrez les outils de développement de votre navigateur et consultez l’onglet Réseau. Rechargez la page, puis filtrez les requêtes avec JS.

Pour chaque fichier, notez son adresse, son poids approximatif et le domaine qui l’héberge. Le chemin du fichier donne souvent un premier indice. Une adresse qui contient /wp-content/plugins/nom-extension/ provient généralement d’une extension. Un chemin sous /wp-content/themes/nom-du-theme/ renvoie plutôt au thème ou à un thème enfant.

Poser les bonnes questions pour chaque script

  • Quelle fonction visible ce fichier soutient-il sur cette page?
  • Cette fonction est-elle utile au lecteur à ce moment précis?
  • Le même fichier se charge-t-il sur des pages où cette fonction n’existe pas?
  • Le fichier appartient-il à votre thème, à une extension ou à un service externe?
  • Un autre script en dépend-il?

Ne jugez pas un fichier uniquement par son nom ou sa taille. Un petit script peut être indispensable au menu mobile, au panier ou à un formulaire. À l’inverse, plusieurs petits scripts peuvent ensemble créer beaucoup de travail au chargement.

Concentrez-vous d’abord sur les pages importantes pour vos visiteurs. Si votre démarche s’inscrit dans une amélioration plus large, l’article Vitesse WordPress : comment rendre votre site plus rapide et agréable aide à replacer ce travail parmi les autres facteurs de performance.

Associer un fichier à son identifiant WordPress

Dans WordPress, un script est normalement ajouté avec un identifiant unique, appelé handle. La fonction wp_enqueue_script() sert à enregistrer et à charger ces scripts, tout en déclarant leurs dépendances. Cet identifiant est important, car WordPress ne retire pas un script à partir de son URL : il le retire à partir de son handle.

Pour retrouver ce handle, consultez les réglages ou la documentation de l’extension concernée. Vous pouvez aussi chercher dans les fichiers du thème enfant ou de l’extension, dans un environnement de test, les appels à wp_enqueue_script(). Le premier argument de la fonction correspond au handle.

Gardez une courte fiche de décision : URL observée, handle, pages où le script est requis, pages où il ne l’est pas, et résultat de vos tests. Cette trace devient précieuse lors d’une mise à jour de thème ou d’extension.

Désactiver un script seulement là où il est inutile

La désactivation conditionnelle est souvent plus sûre qu’une suppression globale. WordPress offre wp_dequeue_script() pour retirer un script qui a déjà été ajouté à la file de chargement. Vous devez toutefois employer le bon handle et exécuter votre code après l’ajout du script par l’extension ou le thème.

Voici un exemple volontairement générique à placer dans un thème enfant ou dans une extension personnalisée. Remplacez mon-script-formulaire par le handle confirmé de votre installation. Ajustez aussi la condition selon vos pages réelles.

add_action( 'wp_enqueue_scripts', function() {
    if ( ! is_page( 'contact' ) ) {
        wp_dequeue_script( 'mon-script-formulaire' );
    }
}, 100 );

Dans cet exemple, le script de formulaire reste chargé sur la page Contact, mais WordPress tente de le retirer ailleurs. N’ajoutez pas ce code dans les fichiers d’une extension tierce : une mise à jour pourrait l’écraser. Préférez un thème enfant ou une extension conçue pour vos personnalisations.

Respecter les dépendances avant de retirer un handle

Un script peut servir de base à un autre fichier. Par conséquent, retirer une bibliothèque ou un handle partagé peut briser un menu, une fenêtre modale, un sélecteur de date ou une partie du paiement. Retirez d’abord les scripts propres à une fonction clairement limitée, puis vérifiez chaque interaction de la page.

Avant toute modification de code, créez une copie récupérable. Vous pouvez suivre cette méthode pour créer une sauvegarde WordPress avant une modification risquée, puis effectuer vos essais sur un site de test lorsque possible.

Utiliser defer sans changer l’ordre des scripts

Lorsqu’un script demeure nécessaire, mais qu’il n’a pas besoin de s’exécuter pendant la construction du document, defer peut constituer une bonne option. Les scripts différés se téléchargent pendant l’analyse du HTML, puis s’exécutent lorsque cette analyse est terminée. Ils respectent aussi leur ordre dans le document, contrairement aux scripts async.

WordPress permet de déclarer une stratégie defer ou async dans wp_enqueue_script(). Sa documentation précise que WordPress tient compte de l’arbre des dépendances et applique la stratégie admissible la plus appropriée. Cela évite que le noyau impose une stratégie plus restrictive qui pourrait compromettre les dépendances.

wp_enqueue_script(
    'theme-interactions',
    get_stylesheet_directory_uri() . '/assets/js/interactions.js',
    array(),
    '1.0.0',
    array(
        'strategy'  => 'defer',
        'in_footer' => true,
    )
);

N’ajoutez pas async à un script qui dépend de jQuery, d’un autre fichier ou d’un élément précis du document. Un script asynchrone peut s’exécuter dans un ordre imprévisible. Réservez-le aux fichiers réellement indépendants, après avoir lu la documentation du fournisseur et testé le comportement sur les appareils utilisés par vos visiteurs.

Vérifier après chaque changement

Traitez un seul script ou une seule règle à la fois. Videz ensuite les caches applicables, ouvrez une fenêtre privée et vérifiez la page modifiée. Testez aussi la version mobile, car plusieurs thèmes y activent un menu et des comportements distincts.

  • Parcourez les menus et sous-menus.
  • Soumettez les formulaires présents sur la page.
  • Ouvrez les accordéons, galeries, fenêtres modales et vidéos.
  • Vérifiez le panier, le paiement et les variations si votre site utilise WooCommerce.
  • Consultez la console du navigateur pour repérer les erreurs JavaScript.

Enfin, comparez le chargement avant et après, page par page. Une réduction utile enlève un script inutile ou reporte un travail non critique sans retirer une interaction attendue. Cette discipline vous aide à optimiser JavaScript WordPress de façon durable, même lorsque vos extensions et votre thème évoluent.