5 de diciembre de 2025

Export e Import

Las directivas export e import tienen varias formas de sintaxis.

En el artículo anterior vimos un uso simple, ahora exploremos más ejemplos.

Export antes de las sentencias

Podemos exportar cualquier declaración colocando antes ‘export’, ya sea a una variable, función o clase.

Por ejemplo, aquí todas las exportaciones son válidas:

// exportar un array
export let months = ['Jan', 'Feb', 'Mar','Apr', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];

// exportar una constante
export const MODULES_BECAME_STANDARD_YEAR = 2015;

// exportar una clase
export class User {
  constructor(name) {
    this.name = name;
  }
}
Sin punto y coma después de export clase/función

Tenga en cuenta que export antes de una clase o una función no la hace una expresión de función. Sigue siendo una declaración de función, aunque exportada.

La mayoría de las guías de estilos JavaScript no recomiendan punto y coma después de declarar funciones y clases.

Es por esto que no hay necesidad de un punto y coma al final de export class y export function:

export function sayHi(user) {
  alert(`Hello, ${user}!`);
}  // sin ; al final

Export separado de la declaración

También podemos colocar export por separado.

Aquí primero declaramos y luego exportamos:

// 📁 say.js
function sayHi(user) {
  alert(`Hello, ${user}!`);
}

function sayBye(user) {
  alert(`Bye, ${user}!`);
}

export {sayHi, sayBye}; // una lista de variables exportadas

…O, técnicamente podemos colocar export arriba de las funciones también.

Import *

Generalmente, colocamos una lista de lo que queremos importar en llaves import {...}, de esta manera:

// 📁 main.js
import {sayHi, sayBye} from './say.js';

sayHi('John'); // Hello, John!
sayBye('John'); // Bye, John!

Pero si hay mucho para importar, podemos importar todo como un objeto utilizando import * as <obj>, por ejemplo:

// 📁 main.js
import * as say from './say.js';

say.sayHi('John');
say.sayBye('John');

A primera vista, “importar todo” parece algo tan genial, corto de escribir, por qué deberíamos listar explícitamente lo que necesitamos importar?

Pues hay algunas razones.

  1. Listar explícitamente qué importar da nombres más cortos: sayHi() en lugar de say.sayHi().
  2. La lista explícita de importaciones ofrece una mejor visión general de la estructura del código: qué se usa y dónde. Facilita el soporte de código y la refactorización.
No temas hacer demasiados import

Las herramientas de empaquetado modernas, como webpack y otras, unen los módulos, optimizan la velocidad de carga, y eliminan las importaciones no usadas.

Por ejemplo, si importas import * as library desde una librería de código enorme, y usas solo unos pocos métodos, los que no se usen no serán incluidos en el paquete optimizado.

Importar “as”

También podemos utilizar as para importar bajo nombres diferentes.

Por ejemplo, importemos sayHi en la variable local hi para brevedad, e importar sayBye como bye:

// 📁 main.js
import {sayHi as hi, sayBye as bye} from './say.js';

hi('John'); // Hello, John!
bye('John'); // Bye, John!

Exportar “as”

Existe un sintaxis similar para