<script>

Intègre du code JavaScript dans la page ou le charge depuis un fichier pour donner du comportement à la page.

Affichage
none
Balise fermante
Obligatoire
Contenu autorisé
Du code JavaScript ou des données, selon type. Avec src, l’élément reste vide
Sur cette page

Exemple

#
HTML
<p>Leçons terminées aujourd’hui : <strong id="count">0</strong></p>
<button type="button" id="done">Terminer la leçon</button>

<script>
  const count = document.getElementById('count');
  const button = document.getElementById('done');

  button.addEventListener('click', () => {
    count.textContent = Number(count.textContent) + 1;
  });
</script>
Aperçu

Le script se trouve sous le bouton, donc au moment de son exécution, les deux éléments existent déjà dans la page.

Définition et utilisation

#

L’élément <script> exécute du JavaScript. Vous pouvez écrire le code directement entre les balises ou indiquer un fichier dans l’attribut src. Dans ce second cas, l’élément doit rester vide, et le contenu écrit à l’intérieur est ignoré.

Un script ordinaire sans attribut supplémentaire arrête la construction de la page : l’analyseur attend que le code soit téléchargé et exécuté, et ne lit la suite du HTML qu’ensuite. D’où deux problèmes typiques : un script dans l’en-tête retarde l’affichage de la page, et le code ne trouve pas les éléments situés plus bas dans le fichier, car ils n’existent pas encore. La solution est l’attribut defer, le type module ou le placement du script à la fin de <body>.

L’attribut type détermine la nature du contenu. Sans lui, c’est un script ordinaire, module désigne un module JavaScript avec import et export, et les types de données, par exemple application/json ou application/ld+json, font que le navigateur n’exécute rien et se contente de conserver les données pour d’autres scripts ou pour les moteurs de recherche.

La balise fermante </script> est obligatoire, y compris avec src. L’écriture <script src="app.js" /> ne fonctionne pas en HTML : la barre oblique est ignorée, et le navigateur traite la suite de la page comme du code de script.

Syntaxe

#
Syntaxe
<script src="fichier.js" defer></script>

<script>
  // code JavaScript
</script>

Attributs

#
  • src

    URL

    L’adresse d’un fichier contenant du code JavaScript. Le navigateur enregistre ce fichier dans son cache et peut le réutiliser sur d’autres sous-pages. N’oubliez pas la balise fermante, même quand l’élément est vide.
  • defer

    attribut booléen

    Télécharge le script en arrière-plan sans suspendre l’analyseur, et ne l’exécute qu’après le chargement de tout le HTML, juste avant l’événement DOMContentLoaded. Plusieurs scripts avec defer s’exécutent dans l’ordre où ils figurent dans le code. Il ne fonctionne qu’avec src.
  • async

    attribut booléen

    Télécharge le script en arrière-plan et l’exécute dès qu’il est téléchargé, même si la page est encore en cours de chargement. L’ordre d’exécution n’est pas garanti, donc async convient aux scripts indépendants, comme les statistiques de visites, et non au code qui dépend d’autres fichiers. Dans les scripts ordinaires, il ne fonctionne qu’avec src.
  • type

    aucun | module | importmap | type de données

    La nature du contenu. Omis, il désigne du JavaScript ordinaire, donc écrire type="text/javascript" est superflu. module crée un module, importmap définit une table d’importation pour les modules, et d’autres valeurs, par exemple application/ld+json, transforment l’élément en bloc de données que le navigateur n’exécute pas.
  • type="module"

    module JavaScript

    Exécute le code comme un module : vous pouvez y utiliser import et export, il s’exécute en mode strict, et ses variables n’atterrissent pas dans la portée globale. Les modules se comportent par défaut comme des scripts avec defer. Ils ne fonctionnent généralement pas quand vous ouvrez un fichier HTML directement depuis le disque (file://), lancez donc la page via un serveur local.
  • nomodule

    attribut booléen

    Un script avec cet attribut n’est exécuté que par les navigateurs qui ne connaissent pas les modules. Il servait à fournir une version de secours aux navigateurs très anciens. Aujourd’hui, tous les navigateurs courants prennent en charge les modules, vous en avez donc rarement besoin.
  • integrity

    empreinte cryptographique, par exemple `sha384-…`

    Subresource Integrity : le navigateur vérifie que le fichier téléchargé a exactement l’empreinte que vous avez indiquée. Si le fichier a été modifié, par exemple remplacé sur un serveur CDN, le script ne s’exécute pas. Pour les fichiers d’un autre domaine, l’attribut crossorigin est aussi requis.
  • crossorigin

    anonymous | use-credentials

    Télécharge un script d’un autre domaine en mode CORS. Il est requis avec integrity pour les fichiers de serveurs externes, et fait en plus que les erreurs d’un tel script arrivent dans window.onerror avec une description complète, et non sous la forme générique « Script error. ». Le serveur doit répondre avec l’en-tête CORS approprié.

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Attributs en pratique

#

src

URL

L’adresse d’un fichier contenant du code JavaScript. Le navigateur enregistre ce fichier dans son cache et peut le réutiliser sur d’autres sous-pages. N’oubliez pas la balise fermante, même quand l’élément est vide.

HTML
<script src="/js/app.js"></script>

defer

attribut booléen

Télécharge le script en arrière-plan sans suspendre l’analyseur, et ne l’exécute qu’après le chargement de tout le HTML, juste avant l’événement DOMContentLoaded. Plusieurs scripts avec defer s’exécutent dans l’ordre où ils figurent dans le code. Il ne fonctionne qu’avec src.

HTML
<head>
  <script src="/js/menu.js" defer></script>
  <script src="/js/app.js" defer></script>
</head>

Les deux fichiers se téléchargent en parallèle et s’exécutent dans l’ordre, d’abord menu.js, puis app.js, quand le HTML est prêt.

async

attribut booléen

Télécharge le script en arrière-plan et l’exécute dès qu’il est téléchargé, même si la page est encore en cours de chargement. L’ordre d’exécution n’est pas garanti, donc async convient aux scripts indépendants, comme les statistiques de visites, et non au code qui dépend d’autres fichiers. Dans les scripts ordinaires, il ne fonctionne qu’avec src.

HTML
<script src="/js/analytics.js" async></script>

type

aucun | module | importmap | type de données

La nature du contenu. Omis, il désigne du JavaScript ordinaire, donc écrire type="text/javascript" est superflu. module crée un module, importmap définit une table d’importation pour les modules, et d’autres valeurs, par exemple application/ld+json, transforment l’élément en bloc de données que le navigateur n’exécute pas.

HTML
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Course",
  "name": "Cours de HTML et CSS pour débutants",
  "description": "24 leçons avec exercices et aperçu en direct.",
  "provider": {
    "@type": "Organization",
    "name": "CodeWorlds"
  }
}
</script>

Ces données structurées aident les moteurs de recherche à comprendre ce que contient la page.

type="module"

module JavaScript

Exécute le code comme un module : vous pouvez y utiliser import et export, il s’exécute en mode strict, et ses variables n’atterrissent pas dans la portée globale. Les modules se comportent par défaut comme des scripts avec defer. Ils ne fonctionnent généralement pas quand vous ouvrez un fichier HTML directement depuis le disque (file://), lancez donc la page via un serveur local.

HTML
<script type="module">
  import { formatPrice } from './utils.js';

  document.querySelector('#price').textContent = formatPrice(149);
</script>

nomodule

attribut booléen

Un script avec cet attribut n’est exécuté que par les navigateurs qui ne connaissent pas les modules. Il servait à fournir une version de secours aux navigateurs très anciens. Aujourd’hui, tous les navigateurs courants prennent en charge les modules, vous en avez donc rarement besoin.

HTML
<script type="module" src="/js/app.js"></script>
<script nomodule src="/js/app-legacy.js"></script>

integrity

empreinte cryptographique, par exemple `sha384-…`

Subresource Integrity : le navigateur vérifie que le fichier téléchargé a exactement l’empreinte que vous avez indiquée. Si le fichier a été modifié, par exemple remplacé sur un serveur CDN, le script ne s’exécute pas. Pour les fichiers d’un autre domaine, l’attribut crossorigin est aussi requis.

HTML
<script
  src="/vendor/confetti.min.js"
  integrity="sha384-X3AWfWhQFwjzp273ynuHHCFyQuYlir97rA86ZO0Oogpfx0Mj78VDdnJqUkzHUU+e"
  defer
></script>

Vous générez l’empreinte d’un fichier dans le terminal avec la commande openssl dgst -sha384 -binary fichier.js | openssl base64 -A. De nombreux services CDN fournissent un code prêt à l’emploi avec l’empreinte.

Plus d’exemples

#
Des données JSON dans un élément script
HTML
<script type="application/json" id="course">
  { "title": "Cours de Python", "lessons": 24 }
</script>
<p id="info">Chargement…</p>

<script>
  const course = JSON.parse(document.getElementById('course').textContent);
  document.getElementById('info').textContent = course.title + ' : ' + course.lessons + ' leçons';
</script>
Aperçu

Le premier élément a le type application/json, donc le navigateur ne l’exécute pas. Le second script y lit les données et les écrit dans le paragraphe.

CSS par défaut

#

La plupart des navigateurs affichent cet élément avec ces styles par défaut :

CSS
script {
  display: none;
}

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Fermez toujours l’élément : <script src="app.js"></script>. L’écriture auto-fermante ne fonctionne pas.
  • Marquez les scripts de <head> avec defer ou type="module". La page s’affichera plus vite, et le code trouvera à coup sûr tous les éléments.
  • Ne placez pas de mots de passe ni de clés d’API secrètes dans les scripts exécutés dans le navigateur. Tout le monde peut les voir dans le code source de la page.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.