import.meta

Sintaxe

import.meta

Descrio

A sintaxe consiste na palavra chave import, um ponto, e o identificador meta. Normalmente no lado esquerdo do ponto o objeto na qual a propriedade de acesso realizada is, mas aqui import no exatamente um objeto.

O objetoimport.meta foi criado no implementao ECMAScript,com um prottipo null. O objeto extensvel, e suas propriedades so grvaveis, configurveis, e enumerveis.

Exemplos

Usando import.meta

Dado o modulo my-module.js

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

Voc pode acessar essa meta informao sobre o modulo usando o objeto import.meta.

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

Ir retornar um objeto com propriedade URL indicando a base URL do mdulo. Isso vai ser o URL da qual o script obteve, por scripts external, ou a base do documento URL contendo documento, para scripts inline.

Note que isso ir incluir parmetros query e/ou cerquilha (i.e., seguindo o ? ou #).

Por exemplo, seguindo esse HTML:

<script type="module">
  import "./index.mjs?someURLInfo=5";
</script>

O arquivo JavaScript a seguir vai registrar o parmetro someURLInfo:

// index.mjs
new URL(import.meta.url).searchParams.get("someURLInfo"); // 5

O mesmo se aplica quando um arquivo importa outro:

// index.mjs
import "./index2.mjs?someURLInfo=5";

// index2.mjs
new URL(import.meta.url).searchParams.get("someURLInfo"); // 5

Note que enquanto o Node.js vai passar nos parmetros query (ou na cerquilha) como no exemplo passsado, a partir do Node 14.1.0, a URL com parmetro query vai dar erro quando carregar no formulrio node --experimental-modules index.mjs?someURLInfo=5 ( tratado como um arquivo ao invs de uma URL nesse contexto).

Nesse arquivo especfico, o argumento passado pode ser complementar para ser usado na ampla aplicao location.href (com strings query ou cerquilha adicionada depois do caminho de arquivo HTML) (ou por Node.js, atravs do process.argv).

Especificaes

Compatibilidade com navegadores

Veja tambm

• import
• export