Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Scripts de module : script type=module

L’attribut `type="module"` indique qu’il s’agit d’un script de module. Le code placé directement dans l’élément est traité comme un module JavaScript. La norme HTML permet aussi à `src` de référencer un module d’entrée WebAssembly, mais la prise en charge varie selon le navigateur. Les modules JavaScript prennent en charge `import` et `export`, s’exécutent automatiquement en mode strict et ont leur propre portée pour les déclarations.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

<script type="module">/* JavaScript module code */</script>
<script type="module" src="app.js"></script>

Le symbole script type=module désigne un élément script avec l’attribut type="module". Le code peut être placé dans l’élément ou référencer un fichier avec src. Il s’agit de l’intégration des modules JavaScript dans HTML, et non d’une édition distincte d’ECMAScript.

Les modules prennent en charge import et export et s’exécutent en mode strict. Les déclarations au niveau supérieur, y compris var, ne créent pas de propriétés sur window. Dans l’exemple, moduleValue reste dans la portée du module.

Un module écrit dans le balisage du document, sans async, s’exécute une fois l’analyse du HTML terminée et ses dépendances prêtes. L’exemple peut ainsi accéder à l’élément result, situé plus loin. L’attribut defer n’a aucun effet sur les modules ; async permet à un module prêt de s’exécuter sans attendre la fin de l’analyse.

Le type MIME requis dépend du type de module demandé. Un module d’entrée JavaScript chargé via src nécessite un type MIME JavaScript. La norme HTML permet aussi de référencer via src un module d’entrée WebAssembly servi avec le type application/wasm, mais la prise en charge de ce cas varie selon le navigateur. Une dépendance JSON importée avec with { type: "json" } nécessite un type MIME JSON. Le chargement depuis une autre origine nécessite une autorisation CORS. Vérifiez la prise en charge dans les navigateurs visés ; la présence de Node 24 dans le dépôt ne prouve pas la prise en charge par les navigateurs.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Module script</title>
  <script type="module">
    var moduleValue = 42;
    document.getElementById("result").textContent =
      `${moduleValue}; ${Object.hasOwn(window, "moduleValue")}`;
  </script>
</head>
<body>
  <output id="result"></output>
</body>
</html>

Résultat

42; false

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources