JavaScript Formatter
Understand JavaScript Formatter
Cet outil met de l'ordre dans du texte JavaScript ou TypeScript — fins de ligne, espaces en fin de ligne et suites de lignes vides — et met en forme l'entrée comme du JSON lorsqu'il détecte du JSON.
How it works
Si le texte commence par { ou [, il est d'abord essayé comme du JSON et, s'il s'analyse, imprimé avec une indentation de deux espaces. Sinon, le nettoyage est purement textuel : les fins de ligne CRLF et CR deviennent LF, les espaces de fin sont retirés de chaque ligne, et trois lignes vides consécutives ou plus se réduisent à deux. Rien n'est analysé comme du code, si bien que rien de ce que votre code signifie ne peut être modifié — et, tout autant, une indentation déjà fausse le reste.
When to use it
- Normaliser les fins de ligne d'un fichier passé par des éditeurs Windows et macOS.
- Mettre en forme un bloc JSON trouvé collé à l'intérieur d'un fichier JavaScript.
- Ranger un extrait avant de le coller dans un ticket ou un commentaire de relecture.
- Nettoyer une sortie générée, parsemée de lignes vides et d'espaces de fin.
Watch out for
- Il ne réindente pas. Du JavaScript minifié arrive sur une ligne et repart sur une ligne — le déplier exige un analyseur qui reconstruit le code à partir d'un arbre syntaxique, ce qu'il n'est pas.
- Tout ce qui commence par { ou [ est essayé comme du JSON, si bien qu'un extrait qui se trouve aussi être un objet JSON valide revient réimprimé en JSON plutôt que laissé tel quel.
- Le style de guillemets, les points-virgules, l'espacement dans les expressions et la largeur de ligne ne sont pas touchés : cela ne rendra donc pas un fichier conforme à une configuration Prettier.
Not the right tool for: Formater du code que vous vous apprêtez à committer. Prettier ou le formateur de votre éditeur analysent le code et produisent un résultat stable pour toute une équipe ; utilisez celui-ci pour un rangement rapide d'un texte que vous collez quelque part.
Frequently Asked Questions
Pourquoi cet outil est-il plus rudimentaire que Prettier ?
Une analyse AST complète de JS/TS exige une bibliothèque de 3 à 5 Mo. Cet outil se charge du nettoyage rapide — normaliser les fins de ligne, corriger l'indentation, réduire les lignes vides en excès et détecter le JSON intégré — sans ce surcoût. Pour un formatage intégré à l'éditeur, utilisez l'extension Prettier pour VS Code.
Peut-il formater du JavaScript minifié ?
En partie — il gère le motif le plus courant, celui d'objets d'allure JSON minifiés intégrés dans du JS. Du JavaScript entièrement minifié (tout sur une ligne, sans espaces) exige un véritable dé-analyseur d'AST, que cet outil n'inclut pas.
Gère-t-il les modules ES et TypeScript ?
Le formateur est fondé sur le texte (pas sur un AST) : il gère donc toute syntaxe JavaScript valide, y compris import/export, async/await, les génériques et les annotations de type, sans les comprendre. Il ne supprimera pas par erreur la syntaxe propre à TypeScript.
How to Use JavaScript Formatter
- Paste or type your input in the input area above.
- The tool processes your input automatically or click Run.
- Copy or download the result using the action buttons.
- Use Ctrl+Enter to run quickly from the keyboard.