import.meta

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since May 2018.

* Some parts of this feature may have varying levels of support.

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

js
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

html
<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.

js
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® 2025 Language Specification
# prod-ImportMeta

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
import.meta
import.meta.resolve

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Has more compatibility info.

Voir aussi