"jsx"
Définit ce que le compilateur fait de la syntaxe JSX dans les fichiers .tsx.
Exemple
#{
"compilerOptions": {
"jsx": "react-jsx",
"module": "ESNext",
"moduleResolution": "Bundler"
},
"include": ["src"]
}Définition et utilisation
#L’option jsx indique au compilateur comment traiter les balises JSX dans les fichiers .tsx. Sans elle, chaque balise de ce type échoue avec l’erreur « Cannot use JSX unless the '--jsx' flag is provided ».
Avec la valeur react-jsx, le JSX est transformé en appels de fonctions du module react/jsx-runtime, dont le compilateur ajoute lui-même l’import. C’est le réglage recommandé depuis React 17 : il n’est pas nécessaire d’importer React dans les fichiers avec du JSX. preserve laisse le JSX tel quel pour un outil qui le traitera plus tard, et l’ancienne valeur react le transforme en React.createElement().
L’option jsxImportSource permet d’utiliser la même syntaxe avec une autre bibliothèque, par exemple Preact. Pour vérifier les types dans le JSX, le compilateur a besoin des types de la bibliothèque, pour React le paquet @types/react.
Syntaxe
#"jsx": "react-jsx"Valeurs disponibles
#react-jsx
_jsx("span", …)
Des appels issus dereact/jsx-runtime, avec l’import ajouté automatiquement. Recommandé pour React 17 et suivants.react-jsxdev
_jsxDEV("span", …)
Commereact-jsx, mais avec des informations de débogage : le fichier, la ligne et la colonne de la balise.preserve
<span>…</span>
Le JSX reste inchangé, et le fichier de sortie a l’extension.jsx. Pour les projets où un bundler ou un framework traite le JSX.react
React.createElement("span", …)
L’ancienne méthode.Reactdoit être disponible dans chaque fichier contenant du JSX.react-native
<span>…</span>
Le JSX reste inchangé, mais le fichier de sortie a l’extension.js.
Plus d’exemples
#// src/Badge.tsx
export function Badge({ label }: { label: string }) {
return <span className="badge">{label}</span>
}
// Résultat de la compilation avec "jsx": "react-jsx" :
// import { jsx as _jsx } from "react/jsx-runtime";
// export function Badge({ label }) {
// return _jsx("span", { className: "badge", children: label });
// }{
"compilerOptions": {
"jsx": "react-jsx",
"jsxImportSource": "preact"
}
}Bonnes pratiques
#- Dans un projet Next.js ou Vite, conservez la valeur du modèle. L’outil règle
jsxcomme l’exige son compilateur. - L’erreur « This JSX tag requires the module path 'react/jsx-runtime' to exist » signale l’absence des types de React. Installez le paquet
@types/react. - Les fichiers avec du JSX doivent avoir l’extension
.tsx. Dans un fichier.ts, la balise est lue comme une assertion de type ou une comparaison, et vous obtenez des erreurs de syntaxe trompeuses.
Entrées associées
#- "lib"Choisit les types intégrés de l’environnement : la version de JavaScript, les API du navigateur et les nouveautés individuelles du langage.
- "module"Le format de modules du code généré et la manière de comprendre les imports.
- "target"La version de JavaScript vers laquelle le compilateur transforme votre code.
- "include" et "exclude"Quels fichiers le compilateur prend en compte et lesquels il ignore.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.