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

Especificaciones
import.meta proposal
HTML Living Standard
La definición de 'import.meta' en esta especificación.

Browser compatibility

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome para AndroidFirefox para AndroidOpera para AndroidSafari en iOSSamsung InternetNode.js
import.metaChrome Soporte completo 64Edge Soporte completo 79Firefox Soporte completo 62IE Sin soporte NoOpera Soporte completo 51Safari Soporte completo 11.1WebView Android Soporte completo 64Chrome Android Soporte completo 64Firefox Android Soporte completo 62Opera Android Soporte completo 47Safari iOS Soporte completo 12Samsung Internet Android Soporte completo 9.0nodejs Soporte completo 10.4.0

Leyenda

Soporte completo  
Soporte completo
Sin soporte  
Sin soporte

Implementation Progress

La siguiente tabla provee el estatus de implementación diaria para esta caracteristica, porque esta caracteristica aun no ha alcanzado la estabilidad entre navegadores. La información es generada corriendo los test relevantes de la caracteristica en Test262, la suite estandar de test de JavaScript, en el build nocturno,  o en el último release de cada  motor de los browser de JavaScript.

Ver también