@babel/plugin-transform-dynamic-import

Traducción Beta No Oficial

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

información

Este plugin está incluido en @babel/preset-env, como parte de ES2020.

Transforma expresiones import() a formatos de módulo que no sean ESM.

Cuándo (no) usar este plugin

Si estás usando un bundler como Webpack, Rollup o Parcel, no debes usar este plugin y dejar que tu bundler maneje las expresiones import().

Debes usar este plugin si:

• Estás desarrollando una biblioteca Node.js en ESM pero quieres distribuirla en CommonJS (CJS): Instala este plugin y @babel/plugin-transform-modules-commonjs

• Usas RequireJS para cargar módulos en el navegador: Instala este plugin y @babel/plugin-transform-modules-amd

• Usas SystemJS para cargar módulos en el navegador: Instala este plugin y @babel/plugin-transform-modules-systemjs

Este plugin debe usarse con uno de los plugins de transformación de módulos mencionados anteriormente.

Ejemplo

input.js

import("jquery").then($ => {});

se transformará en

CommonJS

output.js

Promise.resolve()
  .then(() => _interopRequireWildcard(require("jquery")))
  .then(($) => {});

AMD

output.js

define(["require"], function (_require) {
  new Promise((_resolve, _reject) =>
    _require(
      ["jquery"],
      (imported) => _resolve(_interopRequireWildcard(imported)),
      _reject
    )
  ).then(($) => {});
});

SystemJS

output.js

System.register([], function (_export, _context) {
  "use strict";

  return {
    setters: [],
    execute: function () {
      _context.import("jquery").then(($) => {});
    }
  };
});

Instalación

npm

npm install --save-dev @babel/plugin-transform-dynamic-import

Yarn

yarn add --dev @babel/plugin-transform-dynamic-import

pnpm

pnpm add --save-dev @babel/plugin-transform-dynamic-import

Bun

bun add --dev @babel/plugin-transform-dynamic-import

Uso

Mediante un archivo de configuración (Recomendado)

babel.config.json

{
  "plugins": [
    "@babel/plugin-transform-dynamic-import",
    "@babel/plugin-transform-modules-commonjs"
  ]
}

Mediante la CLI

Shell

babel --plugins=@babel/plugin-transform-dynamic-import,@babel/plugin-transform-modules-amd script.js

Mediante la API de Node

JavaScript

require("@babel/core").transformSync("code", {
  plugins: [
    "@babel/plugin-transform-dynamic-import",
    "@babel/plugin-transform-modules-systemjs"
  ],
});

Referencias

• Propuesta: import()