import.meta
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.js
<script type="module" src="mon-module.js"></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.js" }
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
Specification |
---|
ECMAScript Language Specification # prod-ImportMeta |
HTML Standard # hostgetimportmetaproperties |
Compatibilité des navigateurs
BCD tables only load in the browser