wp_script_is()

Définition : wp_script_is() vérifie l’état d’un script classique enregistré auprès de WordPress : en file, imprimé, enregistré ou autre état documenté. Elle aide au diagnostic des ressources JavaScript.

Comprendre et utiliser

À quoi sert ce terme ?

Elle permet de décider si une extension doit enregistrer un handle ou de comprendre pourquoi un fichier apparaît deux fois. Le contrôle se fait sur l’identifiant de la ressource, pas sur son nom de fichier.

Fonctionnement technique

La fonction utilise le registre WordPress des scripts et accepte un handle avec un état de référence tel que registered, enqueued ou done. Ces états décrivent le pipeline de chargement du Core.

Dans quels contextes l’utiliser ?

Employer dans un diagnostic de plugin ou pour éviter une redéclaration involontaire. Ne pas l’utiliser comme preuve que le navigateur a réellement exécuté le script.

Cas concret : ATOOLPHA

ATOOLPHA souhaite ajouter une information interne au journal seulement si le script de galerie est bien enregistré.

Exemple de code commenté

Extrait PHP destiné à un plugin ou à un template WordPress, dans le contexte indiqué ; pas au contenu HTML de l’article.

<?php
add_action( 'wp_enqueue_scripts', function () {
    if ( wp_script_is( 'atoolpha-gallery', 'registered' ) ) {
        error_log( 'Ressource galerie enregistrée.' );
    }
}, 50 );

Décryptage de l’exemple

Le code interroge le registre après les callbacks habituels de chargement. Il n’ajoute ni ne supprime de ressource et ne journalise aucune donnée utilisateur.

Résultat attendu

Une entrée de diagnostic apparaît si le handle galerie est connu du registre à l’instant du contrôle.

Exercice pratique et vérification

Enregistrer un handle sans l’enqueue et comparer registered et enqueued. Enqueue ensuite et vérifier les changements d’état.

Précautions et limites

L’état enqueued ne garantit ni une réponse HTTP 200 ni une exécution réussie dans le navigateur. Utiliser l’onglet Réseau et la console pour cette seconde vérification.

À ne pas confondre

wp_script_is() interroge les scripts ; wp_style_is() interroge les styles ; aucun des deux ne détecte automatiquement le fichier physique.

Diagnostic avancé

Si registered est vrai mais qu’aucun script n’apparaît, vérifier la mise en file, les conditions de page et le rendu du footer.

Choix d’architecture et déploiement

L’observation du registre PHP et l’observation du navigateur doivent être corrélées. Un état « done » reflète le traitement de WordPress, mais ne signifie pas que le script a exécuté sans exception. Conserver cette distinction dans les procédures de diagnostic.