import.meta

Baseline Large disponibilit

Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis janvier 2020.

En savoir plus
Voir la compatibilit complte

L'objet import.meta est une mta-proprit qui expose des mtadonnes d'un module JavaScript spcifiques au contexte. Cet objet contient des informations propos du module, telles que l'URL du module.

Syntaxe

import.meta;

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

L'objet import.meta est cr par l'implmentation ECMAScript avec un prototype qui vaut null. Cet objet est extensible et ses proprits sont accessibles en criture, configurables et numrables.

Exemples

Soit un module mon-module.js

html

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

Il est possible d'accder aux mtadonnes du module grce l'objet import.meta.

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

Cet objet contient une proprit 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.