<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. Avecsrc, l’élément reste vide
Exemple
#<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>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
#<script src="fichier.js" defer></script>
<script>
// code JavaScript
</script>Attributs
#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.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énementDOMContentLoaded. Plusieurs scripts avecdefers’exécutent dans l’ordre où ils figurent dans le code. Il ne fonctionne qu’avecsrc.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, doncasyncconvient 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’avecsrc.aucun | module | importmap | type de données
La nature du contenu. Omis, il désigne du JavaScript ordinaire, donc écriretype="text/javascript"est superflu.modulecrée un module,importmapdéfinit une table d’importation pour les modules, et d’autres valeurs, par exempleapplication/ld+json, transforment l’élément en bloc de données que le navigateur n’exécute pas.module JavaScript
Exécute le code comme un module : vous pouvez y utiliserimportetexport, 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 avecdefer. 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.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.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’attributcrossoriginest aussi requis.crossorigin
anonymous | use-credentials
Télécharge un script d’un autre domaine en mode CORS. Il est requis avecintegritypour les fichiers de serveurs externes, et fait en plus que les erreurs d’un tel script arrivent danswindow.onerroravec 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
URLL’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.
<script src="/js/app.js"></script>defer
attribut booléenTé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.
<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éenTé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.
<script src="/js/analytics.js" async></script>type
aucun | module | importmap | type de donnéesLa 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.
<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 JavaScriptExé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.
<script type="module">
import { formatPrice } from './utils.js';
document.querySelector('#price').textContent = formatPrice(149);
</script>nomodule
attribut booléenUn 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.
<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.
<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
#<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>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 :
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>avecdeferoutype="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
#- <noscript>Du contenu que le navigateur n’affiche que lorsque JavaScript est désactivé.
- <head>La partie invisible du document qui contient les métadonnées : le titre, l’encodage des caractères, la description, les styles et les scripts.
- <body>La partie visible du document : tout ce que l’utilisateur voit sur la page et avec quoi il peut interagir.
- <link>Relie le document à une ressource externe : une feuille de style, l’icône de la page, une police ou une autre version linguistique.
- <style>Une feuille de style CSS écrite directement dans le document HTML.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.