Registry / web-framework / babel-preset-umi

babel-preset-umi

library1.8.4jsnpmunverified

A Babel preset used internally by the Umi.js framework to transpile modern JavaScript/TypeScript and JSX for browser or Node targets. The latest stable version is 1.8.4, though it is tightly coupled with Umi major versions (e.g., Umi 4). It supports browserslist targets, polyfills via core-js, and optional transforms like Preact. Unlike generic presets (e.g., @babel/preset-env), this preset is designed for Umi's build pipeline and may include framework-specific optimizations. Release cadence follows Umi's release cycle. It is recommended to use this preset only within Umi projects.

web-framework devops

npm install babel-preset-umi

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · BABEL-PRESET-UMI

babel-preset-umi

web-frameworkjavascriptv1.8.4

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default (preset)

✓ module.exports = { presets: ['umi'] }

✗ import umi from 'babel-preset-umi'

CommonJS module export, not ESM. Use string reference in Babel config.

Preset with options

✓ module.exports = { presets: [['umi', { targets: { node: '6' } }]] }

✗ presets: ['umi', { targets: { node: '6' } }]

Options must be in an array: ['umi', options]

TypeScript usage

✓ // In .babelrc: { "presets": ["umi"] }

✗ import { umi } from 'babel-preset-umi'

No named exports; always use string reference.

Configure babel-preset-umi in .babelrc or babel.config.js with browserslist targets and commonjs output.

module.exports = { presets: [ ['umi', { targets: { browsers: ['last 2 versions'] }, commonjs: true, transformRuntime: false, preact: false, debug: false }] ] };

Debug

Known issues

gotchaOptions object must be wrapped in an array: `['umi', options]` not `'umi', options`.

fix

Use `presets: [['umi', { ... }]]` in Babel config.

affects: >=0.0.0

gotcha`browsers` option does not work if `targets` is specified. Only one should be used.

fix

Use either `browsers` or `targets`, not both.

affects: >=0.0.0

deprecatedThis preset is tightly coupled with Umi.js; direct use outside Umi projects is not recommended and may break.

fix

Consider using @babel/preset-env with appropriate targets instead.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'babel-preset-umi'

Package not installed or Babel cannot resolve it.

fix

Run `npm install babel-preset-umi --save-dev` and ensure node_modules is correct.

Invalid options object. Babel Preset has been initialized using an options object that does not match the API schema.

Options placed outside of the preset's array wrapper.

fix

Correct format: `presets: [['umi', { ... }]]`

Upgrade

Version history

1.8.4latest on npm

Audit

Dependencies

@babel/corerequiredPeer dependency required for Babel transformation

@babel/preset-envrequiredCore preset for environment-specific transpilation

@babel/preset-reactoptionalPreset for JSX transformation (optional if preact option set)

@babel/plugin-transform-runtimeoptionalRequired when transformRuntime option is true

Agent activity

16 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/umijs/umi ↗

packagehttps://www.npmjs.com/package/babel-preset-umi ↗

homepagehttps://umijs.org ↗