# Dépendance de script

> Déclaration indiquant qu'un fichier JavaScript ou CSS a besoin qu'un autre soit chargé avant lui, afin que WordPress respecte l'ordre correct au chargement de la page.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/dependance-de-script/

Un script qui appelle jQuery avant même que jQuery ne soit chargé provoque une erreur silencieuse dans la console du navigateur. Plutôt que de compter sur l'ordre des balises `<script>` dans le HTML, WordPress laisse chaque extension déclarer explicitement ce dont son propre code a besoin.

## Le déclarer au moment de l'enregistrement

Le troisième argument de `wp_register_script()` ou `wp_enqueue_script()` accepte un tableau de « handles », c'est-à-dire les identifiants des scripts requis :

```
wp_enqueue_script(
  'mon-script',
  plugins_url( 'js/mon-script.js', __FILE__ ),
  array( 'jquery', 'wp-element' ),
  '1.2.0',
  true
);
```

WordPress calcule alors automatiquement l'ordre de chargement final, même si plusieurs extensions ou le thème enregistrent des scripts qui dépendent les uns des autres.

## Bon à savoir

- Le cœur de WordPress enregistre déjà de nombreux scripts partagés (`jquery`, `wp-element`, `wp-components`...) : les réutiliser comme dépendances évite de charger deux fois la même bibliothèque.
- Depuis WordPress 6.5, l'argument `strategy` de `wp_enqueue_script()` permet de préciser un chargement `defer` ou `async` tout en conservant la résolution des dépendances.
- Un handle mal orthographié dans la liste des dépendances ne provoque pas d'erreur visible : le script est simplement chargé sans respecter l'ordre attendu.
- La fonction `wp_scripts()` permet d'inspecter à tout moment la file de dépendances déjà enregistrées, un outil de diagnostic utile quand un conflit de version est suspecté entre deux extensions.