import.meta
El objeto import.meta
expone el contenido especifico de la metadata al módulo JavaScript. Este contiene informacion sobre el módulo, como por ejemplo, la URL del mismo.
Syntax
import.meta
Descripción
La sintasis consiste de la palabra clave import
,un punto, y un identificador meta
. Normalmente, la parte a la izquierda del punto es el objeto sobre el cual la accion es realizada, pero aqui import
no es realmente un objeto.
El objeto import.meta
es creado por la implementacion ECMAScript , con un prototipo null
. El objeto es extensible y sus propiedades son grabables, editables y enumerables.
Ejemplos
Usando import.meta
Dado un módulo my-module.js
<script type="module" src="my-module.js"></script>
puedes acceder a la meta información sobre el módulo usando el objeto import.meta
.
console.log(import.meta); // { url: "file:///home/user/my-module.js" }
Este retorna un objeto con una propiedad url
indicando la URL base del módulo.Esta será la URL de la que el script fue obtenido, por scripts externos, o la URL base del documento que contiene el documento, por scripts inline.
Nota que este incluirá parametros de la consulta y/o el hash (ej: seguido del ?
or #
).
Por ejemplo, con el siguiente HTML:
<script type="module">
import "./index.mjs?someURLInfo=5";
</script>
..El siguiente archivo JavaScript registrará el parámetro someURLInfo
:
// index.mjs
new URL(import.meta.url).searchParams.get("someURLInfo"); // 5
Lo mismo aplica cuando un archivo importa otro:
// index.mjs
import "./index2.mjs?someURLInfo=5";
// index2.mjs
new URL(import.meta.url).searchParams.get("someURLInfo"); // 5
Nota que mientras Node.js pasa en la consulta los parámetros (o el hash ) como en el último ejemplo, a partir de Node 14.1.0, una URL con parametros en la consulta fallará cuando se carguen en el formato node --experimental-modules index.mjs?someURLInfo=5
(es tratado como un archivo en lugar de una URL en este contexto).
Tal argumento específico del archivo podria ser complementario al usado en toda la aplicacion location.href
(con consultas strings o hash añadidas despues de la ruta HTML) (o en Node.js, mediante process.argv
).
Especificaciones
Specification |
---|
ECMAScript Language Specification # prod-ImportMeta |
HTML Standard # hostgetimportmetaproperties |
Browser compatibility
BCD tables only load in the browser