L'objet import.meta est une méta-propriété qui expose des métadonnées d'un module JavaScript spécifiques au contexte. Cet objet contient des informations à propos du module, telles que l'URL du module.

Syntaxe

import.meta

Description

L'objet import.meta se compose d'un mot-clé "import", suivi d'un point, puis du nom de propriété "meta". En temps normal, "import." serait utilisé comme contexte pour un accès à une propriété mais, dans ce cas, "import." n'est pas, à proprement parler, un objet.

L'objet import.meta est créé par l'implémentation ECMAScript avec un prototype qui vaut null. Cet objet est extensible et ses propriétés sont accessibles en écriture, configurables et énumérables.

Exemples

Soit un module mon-module.mjs

<script type="module" src="mon-module.mjs"></script>

Il est possible d'accéder aux métadonnées du module grâce à l'objet import.meta.

console.log(import.meta); // { url: "file:///home/user/mon-module.mjs" }

Cet objet contient une propriété url qui indique l'URL de base du module. Dans le cas des scripts externes, celle-ci sera l'URL à partir de laquelle le script a été obtenu. Pour les scripts écrits dans le document, ce sera l'URL de base du document englobant.

Spécifications

Spécification État Commentaires
tc39/proposal-import-meta Niveau 3 Définition initiale.
HTML Standard Standard évolutif Définition des propriétés import.meta en HTML.

Compatibilité des navigateurs

No compatibility data found. Please contribute data for "javascript.statements.import_meta" (depth: 1) to the MDN compatibility data repository.

Voir aussi

Étiquettes et contributeurs liés au document

Étiquettes : 
Contributeurs à cette page : SphinxKnight
Dernière mise à jour par : SphinxKnight,