CKTIS / JavaScript
import — importer des modules JavaScript
Le mot-clé import rend disponibles les exports d’autres modules. Découvrez les déclarations statiques et les liaisons vivantes, ainsi que les différences entre import(...), import.meta et les appels de fonction ordinaires.
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
import defaultExport from "module";
import { namedExport, otherExport as localName } from "module";
import * as namespace from "module";
import "module";
import(specifier);
import.metaimport est un mot-clé réservé : il ne peut pas servir de nom de variable. Une déclaration statique import apparaît uniquement au niveau supérieur d’un module, et non à l’intérieur d’une fonction ou d’un bloc. Son spécificateur de module doit être un littéral chaîne. Les imports statiques font partie du système de modules introduit avec ECMAScript 2015.
Un import par défaut sélectionne l’export default ; un import nommé sélectionne un export précis, et as lui attribue un nom local. La forme import * as namespace crée une liaison locale vers l’objet espace de noms du module. import "module" exécute la dépendance sans créer de liaisons locales. Les liaisons importées sont vivantes : elles reflètent les modifications apportées par le module qui exporte. L’importateur ne peut pas leur attribuer une nouvelle valeur ; cela ne signifie toutefois pas qu’un objet importé est gelé.
import(specifier) est une syntaxe distincte d’import dynamique, introduite avec ECMAScript 2020, et non une fonction ordinaire. Elle peut apparaître dans des expressions, y compris dans un script classique, et renvoie une Promise. Une fois le module chargé et évalué avec succès, la promesse est normalement tenue avec l’objet espace de noms du module comme valeur. Toutefois, si le module possède un export appelable nommé then, le mécanisme de résolution de la promesse l’appelle. La promesse peut alors être tenue avec une autre valeur ou être rejetée, même si l’évaluation du module a réussi. import.meta, également introduit avec ECMAScript 2020, expose des métadonnées du module dépendantes de l’environnement hôte et n’est autorisé que dans les modules.
La résolution des spécificateurs et le chargement des modules dépendent de l’environnement hôte. Ni la spécification du langage à elle seule ni une exécution réussie dans Node.js ne prouvent la prise en charge dans un navigateur particulier. L’exemple montre une liaison vivante : l’appel à increase() modifie la valeur observée via count.
Exemples
// counter.mjs
export let count = 1;
export function increment() {
count += 1;
}
// main.mjs
import { count, increment as increase } from "./counter.mjs";
console.log(count);
increase();
console.log(count);Résultat
1 2
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.