turbo (experimental)

Advertencia: Estas características son experimentales y solo funcionarán con next --turbo.

Cargadores (loaders) de webpack

Actualmente, Turbopack soporta un subconjunto de la API de cargadores de webpack, permitiéndote usar algunos cargadores de webpack para transformar código en Turbopack.

Para configurar los cargadores, añade los nombres de los cargadores que has instalado y cualquier opción en next.config.js, mapeando extensiones de archivo a una lista de cargadores:

next.config.js
module.exports = {
  experimental: {
    turbo: {
      rules: {
        // Formato con opciones
        '*.md': [
          {
            loader: '@mdx-js/loader',
            options: {
              format: 'md',
            },
          },
        ],
        // Formato sin opciones
        '*.mdx': ['@mdx-js/loader'],
      },
    },
  },
}

Luego, con la configuración anterior, puedes usar código transformado desde tu aplicación:

import MyDoc from './my-doc.mdx'

export default function Home() {
  return <MyDoc />
}

Alias de resolución

A través de next.config.js, Turbopack puede configurarse para modificar la resolución de módulos mediante alias, similar a la configuración resolve.alias de webpack.

Para configurar alias de resolución, mapea patrones importados a su nuevo destino en next.config.js:

next.config.js
module.exports = {
  experimental: {
    turbo: {
      resolveAlias: {
        underscore: 'lodash',
        mocha: { browser: 'mocha/browser-entry.js' },
      },
    },
  },
}

Esto crea un alias para las importaciones del paquete underscore al paquete lodash. En otras palabras, import underscore from 'underscore' cargará el módulo lodash en lugar de underscore.

Turbopack también soporta alias condicionales a través de este campo, similar a las exportaciones condicionales de Node.js. Por ahora solo se soporta la condición browser. En el caso anterior, las importaciones del módulo mocha se aliasearán a mocha/browser-entry.js cuando Turbopack tenga como objetivo entornos de navegador.

Para más información y guías sobre cómo migrar tu aplicación a Turbopack desde webpack, consulta la documentación de Turbopack sobre compatibilidad con webpack.