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
88
|
---
title: import.meta
slug: Web/JavaScript/Reference/Statements/import.meta
translation_of: Web/JavaScript/Reference/Statements/import.meta
original_slug: Web/JavaScript/Referencia/Sentencias/import.meta
---
<div>{{JSSidebar("Statements")}}</div>
<p>El objeto<strong> <code>import.meta</code></strong> 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.</p>
<h2 id="Syntax">Syntax</h2>
<pre class="syntaxbox">import.meta</pre>
<h2 id="Descripción">Descripción</h2>
<p>La sintasis consiste de la palabra clave {{JSxRef("Statements/import","import")}},un punto, y un identificador <code>meta</code>. Normalmente, la parte a la izquierda del punto es el objeto sobre el cual la accion es realizada, pero aqui <code>import</code> no es realmente un objeto.</p>
<p>El objeto <code>import.meta</code> es creado por la implementacion ECMAScript , con un prototipo {{JSxRef("null")}} . El objeto es extensible y sus propiedades son grabables, editables y enumerables.</p>
<h2 id="Ejemplos">Ejemplos</h2>
<h3 id="Usando_import.meta">Usando import.meta</h3>
<p>Dado un módulo <code>my-module.js</code></p>
<pre class="brush: html"><script type="module" src="my-module.js"></script>
</pre>
<p>puedes acceder a la meta información sobre el módulo usando el objeto <code>import.meta</code>.</p>
<pre class="brush: js;">console.log(import.meta); // { url: "file:///home/user/my-module.js" }</pre>
<p>Este retorna un objeto con una propiedad <code>url</code> 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.</p>
<p>Nota que este incluirá parametros de la consulta y/o el hash (ej: seguido del <code>?</code> or <code>#</code>).</p>
<p>Por ejemplo, con el siguiente HTML:</p>
<pre class="brush: html"><script type="module">
import './index.mjs?someURLInfo=5';
</script></pre>
<p>..El siguiente archivo JavaScript registrará el parámetro <code>someURLInfo</code>:</p>
<pre class="brush: js">// index.mjs
new URL(import.meta.url).searchParams.get('someURLInfo'); // 5</pre>
<p>Lo mismo aplica cuando un archivo importa otro:</p>
<pre class="brush: js">// index.mjs
import './index2.mjs?someURLInfo=5';
// index2.mjs
new URL(import.meta.url).searchParams.get('someURLInfo'); // 5</pre>
<p>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 <code>node --experimental-modules index.mjs?someURLInfo=5</code> (es tratado como un archivo en lugar de una URL en este contexto).</p>
<p>Tal argumento específico del archivo podria ser complementario al usado en toda la aplicacion <code>location.href</code> (con consultas strings o hash añadidas despues de la ruta HTML) (o en Node.js, mediante <code>process.argv</code>).</p>
<h2 id="Especificaciones">Especificaciones</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Especificaciones</th>
</tr>
<tr>
<td><code><a href="https://tc39.es/proposal-import-meta/#prod-ImportMeta">import.meta</a></code> proposal</td>
</tr>
<tr>
<td>{{SpecName("HTML WHATWG", "webappapis.html#hostgetimportmetaproperties", "import.meta")}}</td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility">Browser compatibility</h2>
<p>{{Compat("javascript.statements.import_meta")}}</p>
<h2 id="Ver_también">Ver también</h2>
<ul>
<li>{{JSxRef("Statements/import", "import")}}</li>
<li>{{JSxRef("Statements/export", "export")}}</li>
</ul>
|
