SWC
SWC (Speedy Web Compiler) est une plateforme extensible basée sur Rust. C'est le compilateur utilisé par Next.js et Deno.
Quand l'utiliser
- Transpilation JavaScript/TypeScript haute performance : Remplacement de Babel par un compilateur Rust jusqu'à 20 fois plus rapide.
- Pipelines Next.js et bundlers modernes : Transpilation de React JSX, TSX, des fonctionnalités ECMAScript modernes, et des ressources Webpack/Turbopack.
- Manipulation AST et génération de code programmatique : Création d'outils de build personnalisés rapides avec l'API Node.js
@swc/core. - Minification des ressources de production : Minification des bundles JS et CSS à des vitesses extrêmes avec le minifieur
@swc/core.
Démarrage rapide
1. Fichier .swcrc minimal
{
"$schema": "https://json.schemastore.org/swcrc",
"jsc": {
"parser": {
"syntax": "typescript",
"tsx": true,
"decorators": true
},
"transform": {
"react": {
"runtime": "automatic"
}
},
"target": "es2022"
},
"minify": false
}
2. Compilation via CLI
npx @swc/cli src -d dist
Concepts clés
Configuration SWC de production (.swcrc)
Configuration du TypeScript moderne, du runtime React 19 JSX, et de la transpilation des modules :
{
"$schema": "https://json.schemastore.org/swcrc",
"jsc": {
"parser": {
"syntax": "typescript",
"tsx": true,
"decorators": true,
"dynamicImport": true
},
"transform": {
"react": {
"runtime": "automatic",
"refresh": true
}
},
"target": "es2022",
"loose": false,
"externalHelpers": true,
"keepClassNames": true,
"minify": {
"compress": {
"unused": true,
"drop_console": true
},
"mangle": true
}
},
"module": {
"type": "es6"
},
"minify": true,
"sourceMaps": true
}
Compilation programmatique avec l'API @swc/core
Transpilation de fichiers source de manière asynchrone dans des scripts Node.js :
import swc from "@swc/core";
import fs from "node:fs/promises";
async function compileTypeScript(filePath) {
const code = await fs.readFile(filePath, "utf-8");
const output = await swc.transform(code, {
filename: filePath,
sourceMaps: true,
jsc: {
parser: { syntax: "typescript", tsx: true },
target: "es2022",
},
module: { type: "commonjs" },
});
console.log("Code transpilé :\n", output.code);
if (output.map) {
console.log("Source Map générée");
}
}
compileTypeScript("./src/index.ts");
Transpilation CLI haute vitesse
Compilation directe d'arbres de répertoires avec la ligne de commande SWC :
# Transpiler src/ vers dist/ avec les source maps
npx swc src -d dist --copy-files --source-maps
# Transpiler et bundle avec swcpack
npx swc src/index.ts -o dist/bundle.js --minify
Modèles courants
Accélération des tests Jest avec @swc/jest
Problème : La transpilation TypeScript avec ts-jest rend les suites de tests très lentes.
Solution : Remplacer ts-jest par @swc/jest.
// jest.config.js
module.exports = {
transform: {
"^.+\\.(t|j)sx?$": [
"@swc/jest",
{
jsc: {
transform: {
react: { runtime: "automatic" },
},
},
},
],
},
};
Pipeline de bundling et minification SWC
Problème : Nécessité d'une minification rapide pour les scripts de build de production.
Solution : Activer les options minify dans .swcrc.
{
"minify": true,
"jsc": {
"minify": {
"compress": {
"drop_console": true
},
"mangle": true
}
}
}
Meilleures pratiques (2026)
- Faites installer
@swc/helperset activerexternalHelpers: truepour éviter de dupliquer les stubs d'aide au runtime du transpilateur. - Faites associer SWC à
tsc --noEmitdans les pipelines CI/CD car SWC transpile le code sans effectuer de vérification de types. - Faites configurer
target: "es2022"ou plus récent pour tirer parti des capacités natives des navigateurs modernes. - Faites utiliser
@swc/jestou@swc/registerpour accélérer considérablement l'exécution des tests unitaires. - Ne faites pas dépendre des plugins Babel à moins que ce ne soit strictement nécessaire ; vérifiez si des plugins SWC natifs (plugins Wasm) existent.
- Ne faites pas commiter les répertoires de cache de build
.swcdans les dépôts Git. - Ne faites pas exécuter la minification SWC sans générer des source maps pour le dépannage en production.
Dépannage
| Erreur / Symptôme | Cause | Solution |
|---|---|---|
failed to handle: error parsing typescript | Syntaxe TypeScript (ex. JSX ou décorateurs) utilisée sans activer les flags dans .swcrc | Assurez-vous que "syntax": "typescript", "tsx": true, et "decorators": true sont présents dans jsc.parser. |
Les métadonnées des décorateurs ne sont pas émises (Reflect.getMetadata retourne undefined) | transform.legacyDecorator et transform.decoratorMetadata non configurés | Définissez "legacyDecorator": true et "decoratorMetadata": true dans jsc.transform. |
Cannot find module '@swc/core-darwin-arm64' | L'installation du binaire natif a échoué lors de l'installation npm/yarn | Exécutez npm install --force @swc/core pour déclencher le téléchargement du binaire natif pour l'architecture cible. |