网页 综合 更新时间 2026-11-17 00:23:13

Configuration de Jest · Jest

自动蜘蛛 jestjs.io 正文约 6000 字
Configuration de Jest · Jest
La philosophie de Jest est de fonctionner parfaitement par défaut, mais parfois vous avez besoin de plus de possibilités de configuration.
Il est recommandé de définir la configuration dans un fichier JavaScript dédié, TypeScript ou JSON. The file will be discovered automatically, if it is named jest.config.js|ts|mjs|mts|cjs|cts|json. You can use --config flag to pass an explicit path to the file.
Gardez à l'esprit que l'objet de configuration qui en résulte doit toujours être sérialisable en JSON.
To read TypeScript configuration files Jest by default requires ts-node. You can override this behavior by adding a @jest-config-loader docblock at the top of the file. Currently, ts-node and esbuild-register is supported. Make sure ts-node or the loader you specify is installed.
You can also pass options to the loader, for instance to enable transpileOnly.
Cette option indique à Jest que tous les modules importés dans vos tests doivent être simulés automatiquement. Tous les modules utilisés dans vos tests auront une implémentation de remplacement, en conservant la surface de l'API.
Node modules are automatically mocked when you have a manual mock in place (e.g.: __mocks__/lodash.js). More info here.
Node.js core modules, like fs, are not mocked by default. They can be mocked explicitly, like jest.mock('fs').
Par défaut, Jest exécute tous les tests et produit toutes les erreurs dans la console à la fin. The bail config option can be used here to have Jest stop running tests after n failures. Setting bail to true is the same as setting bail to 1.
Default: "/tmp/<path>"
Le répertoire où Jest doit stocker ses informations de dépendance en cache.
Avant d'exécuter les tests, Jest tente d’analyser votre arborescence de dépendances (en amont) et met ces résultats en cache afin d’alléger les accès au système de fichiers qui doivent se produire lors de l’exécution des tests. Cette option de configuration vous permet de personnaliser le répertoire où Jest stocke ces données.
Efface automatiquement les appels, les instances, les contextes et les résultats des simulations avant chaque test. Equivalent to calling jest.clearAllMocks() before each test. Cela ne supprime aucune implémentation simulée qui aurait pu être fournie.
Indique si les informations de couverture doivent être collectées lors de l'exécution du test. Étant donné que cette opération modifie tous les fichiers exécutés avec des instructions de collecte de couverture, elle peut ralentir considérablement vos tests.
Jest ships with two coverage providers: babel (default) and v8. See the coverageProvider option for more details.
The babel and v8 coverage providers use /* istanbul ignore next */ and /* c8 ignore next */ comments to exclude lines from coverage reports, respectively. For more information, you can view the istanbuljs documentation and the c8 documentation.
An array of glob patterns indicating a set of files for which coverage information should be collected. Si un fichier correspond au pattern glob spécifié, des informations de couverture seront collectées pour ce fichier, même si aucun test n'existe pour ce fichier et qu'il n'est jamais requis dans la suite de tests.
This will collect coverage information for all the files inside the project's rootDir, except the ones that match **/node_modules/** or **/vendor/**.
Chaque pattern glob est appliqué dans l'ordre dans lequel ils sont spécifiés dans la configuration. For example ["!**/__tests__/**", "**/*.js"] will not exclude __tests__ because the negation is overwritten with the second pattern. In order to make the negated glob work in this example it has to come after **/*.js.
This option requires collectCoverage to be set to true or Jest to be invoked with --coverage.
If you are seeing coverage output such as...
Il est très probable que vos patterns glob ne correspondent à aucun fichier. Refer to the micromatch documentation to ensure your globs are compatible.
Le répertoire où Jest doit écrire les fichiers de couverture.
Default: ["/node_modules/"]
Un tableau de chaînes de patterns regexp qui sont comparées à tous les chemins de fichiers avant d'exécuter le test. Si le chemin du fichier correspond à l'un des patterns, l'information de couverture sera ignorée.
Ces chaînes de patterns correspondent au chemin d'accès complet. Use the <rootDir> string token to include the path to your project's root directory to prevent it from accidentally ignoring all of your files in different environments that may have different root directories. Example: ["<rootDir>/build/", "<rootDir>/node_modules/"].
Indique quel fournisseur doit être utilisé pour instrumenter le code pour la couverture. Allowed values are babel (default) or v8.
Default: ["clover", "json", "lcov", "text"]
Une liste de noms de rapporteurs que Jest utilise lors de la rédaction de rapports de couverture. Any istanbul reporter can be used.
La configuration de cette option remplace les valeurs par défaut. Add "text" or "text-summary" to see a coverage summary in the console output.
Des options supplémentaires peuvent être passées en utilisant la forme tuple. Par exemple, vous pouvez cacher les lignes de déclaration de couverture pour tous les fichiers couverts :
For more information about the options object shape refer to CoverageReporterWithOptions type in the type definitions.
Cela servira à configurer le seuil minimum pour les résultats de la couverture. Thresholds can be specified as global, as a glob, and as a directory or file path. Si les seuils ne sont pas atteints, jest échouera.
If a threshold is set to a positive number, it will be interpreted as the minimum percentage of coverage required.
If a threshold is set to a negative number, it will be treated as the maximum number of uncovered items allowed.
Par exemple, avec la configuration suivante, jest échouera si la couverture des branches, des lignes et des fonctions est inférieure à 80%, ou s'il y a plus de 10 déclarations non couvertes :
Global threshold for lines.
Globa
访问原文 返回搜索 https://jestjs.io/fr/docs/30.4/configuration
本页为82搜索生成的网页快照,内容来自站内索引;演示数据的原文链接仅作示例。