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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
---
title: import.meta
slug: Web/JavaScript/Reference/Statements/import.meta
translation_of: Web/JavaScript/Reference/Statements/import.meta
---
<div>{{JSSidebar("Statements")}}</div>
<p><code><font face="Arial, x-locale-body, sans-serif"><span style="background-color: #ffffff;">O objeto mostra o </span></font><strong>import.meta</strong></code> mostra o contexto específico metadata para um módulo JavaScript. Ele contém informações sobre o módulo, como a sua URL.</p>
<h2 id="Sintaxe">Sintaxe </h2>
<pre class="syntaxbox notranslate">import.meta</pre>
<h2 id="Descrição">Descrição</h2>
<p>A sintaxe consiste na palavra chave {{JSxRef("Statements/import","import")}}, um ponto, e o identificador <code>meta</code>. Normalmente no lado esquerdo do ponto é o objeto na qual a propriedade de acesso é realizada is, mas aqui <code>import</code> não é exatamente um objeto.</p>
<p>O objeto<code>import.meta</code> foi criado no implementação ECMAScript,com um protótipo {{JSxRef("null")}}. O objeto é extensível, e suas propriedades são grávaveis, configuráveis, e enumeráveis.</p>
<h2 id="Exemplos">Exemplos</h2>
<h3 id="Usando_import.meta">Usando import.meta</h3>
<p>Dado o modulo <code>my-module.js</code></p>
<pre class="brush: html notranslate"><script type="module" src="my-module.js"></script>
</pre>
<p>Você pode acessar essa meta informação sobre o modulo usando o objeto <code>import.meta.</code></p>
<pre class="brush: js; notranslate">console.log(import.meta); // { url: "file:///home/user/my-module.js" }</pre>
<p>Irá returnar um objeto com propriedade URL indicando a base URL do módulo. Isso vai ser o URL da qual o script obteve, por scripts external, ou a base do documento URL contendo documento, para scripts inline.</p>
<p>Note que isso irá incluir parâmetros query e/ou cerquilha (i.e., seguindo o <code>?</code> ou <code>#</code>).</p>
<p>Por exemplo, seguindo esse HTML:</p>
<pre class="brush: html notranslate"><script type="module">
import './index.mjs?someURLInfo=5';
</script></pre>
<p>O arquivo JavaScript a seguir vai registrar o parâmetro `<code>someURLInfo</code>:</p>
<pre class="brush: js notranslate">// index.mjs
new URL(import.meta.url).searchParams.get('someURLInfo'); // 5</pre>
<p>O mesmo se aplica quando um arquivo importa outro:</p>
<pre class="brush: js notranslate">// index.mjs
import './index2.mjs?someURLInfo=5';
// index2.mjs
new URL(import.meta.url).searchParams.get('someURLInfo'); // 5</pre>
<p>Note que enquanto o Node.js vai passar nos parâmetros query (ou na cerquilha) como no exemplo passsado, a partir do Node 14.1.0, a URL com parâmetro query vai dar erro quando carregar no formulário <code>node --experimental-modules index.mjs?someURLInfo=5</code> (é tratado como um arquivo ao invés de uma URL nesse contexto).</p>
<p>Nesse arquivo específico, o argumento passado pode ser complementar para ser usado na ampla aplicação <code>location.href</code> (com strings query ou cerquilha adicionada depois do caminho de arquivo HTML) (ou por Node.js, através do <code>process.argv</code>).</p>
<h2 id="Especifícações">Especifícações</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Especifícação</th>
</tr>
<tr>
<td><code><a href="https://tc39.es/proposal-import-meta/#prod-ImportMeta">import.meta</a></code> </td>
</tr>
<tr>
<td>{{SpecName("HTML WHATWG", "webappapis.html#hostgetimportmetaproperties", "import.meta")}}</td>
</tr>
</tbody>
</table>
<h2 id="Compartibilidade_no_Browser"> Compartibilidade no Browser </h2>
<div class="hidden">A tabela de compartibilidade nessa página é gerado por um dado estruturado.Se você gostaria de contribuir para esse dado, por favor, acesso <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> e nos envie um pull request.</div>
<p>{{Compat("javascript.statements.import_meta")}}</p>
<h2 id="Veja_também">Veja também</h2>
<ul>
<li>{{JSxRef("Statements/import", "import")}}</li>
<li>{{JSxRef("Statements/export", "export")}}</li>
</ul>
|
