"jsx"

Définit ce que le compilateur fait de la syntaxe JSX dans les fichiers .tsx.

Sur cette page

Exemple

#
JSON
{
  "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

#
Syntaxe
"jsx": "react-jsx"

Valeurs disponibles

#
  • react-jsx

    _jsx("span", …)

    Des appels issus de react/jsx-runtime, avec l’import ajouté automatiquement. Recommandé pour React 17 et suivants.
  • react-jsxdev

    _jsxDEV("span", …)

    Comme react-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. React doit ê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

#
Ce que génère react-jsx
TypeScript
// 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 });
// }
La même syntaxe avec Preact
JSON
{
  "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 jsx comme 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

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.