diff options
Diffstat (limited to 'files/pt-br/web/javascript/reference/statements/import.meta/index.html')
| -rw-r--r-- | files/pt-br/web/javascript/reference/statements/import.meta/index.html | 93 |
1 files changed, 93 insertions, 0 deletions
diff --git a/files/pt-br/web/javascript/reference/statements/import.meta/index.html b/files/pt-br/web/javascript/reference/statements/import.meta/index.html new file mode 100644 index 0000000000..9e6a31a523 --- /dev/null +++ b/files/pt-br/web/javascript/reference/statements/import.meta/index.html @@ -0,0 +1,93 @@ +--- +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> + +<h3 id="Progressão_de_implementação">Progressão de implementação</h3> + +<p>A tabela seguinte fornece um status de implementação diária para essa feature, porque ela ainda não alcançou a estabilidade cross-browser. Os dados são gerados por relevantes testes de feature no <a href="https://github.com/tc39/test262">Test262</a>, o padrão de teste para JavaScript, em build noturno, ou no ultimo lançamento de cada engine browser de JavaScript.</p> + +<div>{{EmbedTest262ReportResultsTable("import.meta")}}</div> + +<h2 id="Veja_também">Veja também</h2> + +<ul> + <li>{{JSxRef("Statements/import", "import")}}</li> + <li>{{JSxRef("Statements/export", "export")}}</li> +</ul> |