1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
---
title: import.meta
slug: Web/JavaScript/Reference/Statements/import.meta
tags:
- JavaScript
- Modules
- Reference
translation_of: Web/JavaScript/Reference/Statements/import.meta
original_slug: Web/JavaScript/Reference/Instructions/import.meta
---
{{JSSidebar("Statements")}}
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 {{jsxref("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
| Spécification | État | Commentaires |
| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------------------------------------ |
| [Proposition pour `import.meta`](https://github.com/tc39/proposal-import-meta/#importmeta) | Niveau 3 | Définition initiale. |
| {{SpecName("HTML WHATWG","webappapis.html#hostgetimportmetaproperties","import.meta")}} | {{Spec2("HTML WHATWG")}} | Définition des propriétés `import.meta` en HTML. |
## Compatibilité des navigateurs
{{Compat("javascript.statements.import_meta")}}
## Voir aussi
- {{jsxref("Instructions/import","import")}}
- {{jsxref("Instructions/export","export")}}
|
