Options partagées #

Résolution des exportations de sous-chemins d'accès

Les clés d'exportation se terminant par "/" sont dépréciées par Node et peuvent ne pas fonctionner correctement. Veuillez contacter l'auteur du paquet pour utiliser * subpath patterns à la place. :: :

resolve.mainFields #

• Type : ** string[].
• Défaut: "['module', 'jsnext:main', 'jsnext']`".

Liste des champs de package.json à essayer lors de la résolution du point d'entrée d'un paquet. Notez que ceci a une priorité inférieure aux exportations conditionnelles résolues à partir du champ exports : si un point d'entrée est résolu avec succès à partir de exports, le champ main sera ignoré.

resolve.browserField #

• Type:** "booléen".
• Défaut: true
• Déprogrammé

Activation ou non de la résolution du champ browser.

Dans le futur, la valeur par défaut de resolve.mainFields sera ['browser', 'module', 'jsnext:main', 'jsnext'] et cette option sera supprimée.

resolve.extensions #

• Type:** string[].
• Défaut: ['.mjs', '.js', '.ts', '.jsx', '.tsx', '.json'].

Liste des extensions de fichiers à essayer pour les importations qui omettent les extensions. Notez qu'il n'est PAS recommandé d'omettre les extensions pour les types d'importation personnalisés (par exemple .vue) car cela peut interférer avec l'IDE et le support des types.

resolve.preserveSymlinks #

• Type:** boolean
• Défaut: false

En activant ce paramètre, vite détermine l'identité du fichier par le chemin d'accès original (c'est-à-dire le chemin sans suivre les liens symboliques) au lieu du chemin réel (c'est-à-dire le chemin après avoir suivi les liens symboliques).

• Relié: esbuild#preserve-symlinks, webpack#resolve.symlinks

css.modules #

• Type:
  ts

  interface CSSModulesOptions {
    scopeBehaviour? : 'global' | 'local'.
    globalModulePaths ? RegExp[]
    generateScopedName ?
      | chaîne de caractères
      | ((name : string, filename : string, css : string) => string)
    hashPrefix? : string
    /**
     * par défaut : null
     */
    localsConvention ?
      | 'camelCase
      | 'camelCaseOnly
      | 'dashes' (tirets)
      | 'dashesOnly
      | null
  }
  

Configure le comportement des modules CSS. Les options sont transmises à postcss-modules.

css.postcss #

• Type: `string | (postcss.ProcessOptions & { plugins? : postcss.AcceptedPlugin[] })``

Configuration PostCSS en ligne ou un répertoire personnalisé pour rechercher la configuration PostCSS à partir de (par défaut, la racine du projet).

Pour la configuration PostCSS en ligne, il attend le même format que postcss.config.js. Mais pour la propriété plugins, seul array format peut être utilisé.

La recherche est faite en utilisant postcss-load-config et seuls les noms de fichiers de configuration supportés sont chargés.

Notez que si une configuration en ligne est fournie, Vite ne cherchera pas d'autres sources de configuration PostCSS.

css.preprocessorOptions #

• Type: Record<string, object>

Spécifie les options à passer aux pré-processeurs CSS. Les extensions de fichiers sont utilisées comme clés pour les options. Exemple :

``js export default defineConfig({ css : { preprocessorOptions : { scss : { additionalData : $injectedColor : orange; }, styl : { additionalData : $injectedColor ?= orange } } } })

## css.devSourcemap

- **Expérimental**
- **Type:** `boolean`
- **Défaut:** `false`

Active ou non les cartes de source pendant le développement.

## json.namedExports

- **Type:** `boolean`
- **Défaut:** `true`

Prise en charge ou non des importations nommées à partir de fichiers `.json`.

## json.stringify

- **Type:** `boolean`
- **Défaut:** `false`

S'il est défini à `true`, le JSON importé sera transformé en `export default JSON.parse("...")`, ce qui est nettement plus performant que les littéraux d'objets, surtout lorsque le fichier JSON est volumineux.

L'activation de cette option désactive les importations nommées.

## esbuild

- **Type:** `ESBuildOptions | false`

`ESBuildOptions` étend [les options de transformation propres à esbuild] (https://esbuild.github.io/api/#transform-api). Le cas d'utilisation le plus courant est la personnalisation de JSX :

``js
export default defineConfig({
  esbuild : {
    jsxFactory : 'h',
    jsxFragment : 'Fragment'.
  }
})

Par défaut, esbuild est appliqué aux fichiers ts, jsx et tsx. Vous pouvez personnaliser cela avec esbuild.include et esbuild.exclude, qui peuvent être une regex, un motif picomatch, ou un tableau des deux.

De plus, vous pouvez aussi utiliser esbuild.jsxInject pour injecter automatiquement des imports d'aide JSX pour chaque fichier transformé par esbuild :

js export default defineConfig({ esbuild : { jsxInject : `import React from 'react' } })

Lorsque le paramètre [`build.minify`](./build-options.md#build-minify) est `true`, toutes les optimisations minify sont appliquées par défaut. Pour en désactiver [certains aspects](https://esbuild.github.io/api/#minify), mettez l'une des options `esbuild.minifyIdentifiers`, `esbuild.minifySyntax`, ou `esbuild.minifyWhitespace` à `false`. Notez que l'option `esbuild.minify` ne peut pas être utilisée pour remplacer `build.minify`.

Mettre à `false` pour désactiver les transformations esbuild.

## assetsInclude

- **Type:** `string | RegExp | (string | RegExp)[]``
- **Relié:** [Gestion des actifs statiques](/guide/assets)

Spécifiez des [motifs picomatch](https://github.com/micromatch/picomatch#globbing-features) supplémentaires à traiter comme des actifs statiques de sorte que :

- Ils seront exclus du pipeline de transformation du plugin lorsqu'ils sont référencés à partir de HTML ou demandés directement par `fetch` ou XHR.

- Les importer depuis JS retournera leur chaîne d'URL résolue (ceci peut être écrasé si vous avez un plugin `enforce : 'pre'` pour gérer le type de ressource différemment).

La liste des types d'actifs intégrés est disponible [ici] (https://github.com/vitejs/vite/blob/main/packages/vite/src/node/constants.ts).

**Exemple:**

``js
export default defineConfig({
  assetsInclude : ['**/*.gltf']
})

logLevel #

• Type: `'info' | 'warn' | 'error' | 'silent'``

Ajuste la verbosité de la sortie de la console. La valeur par défaut est 'info'.

clearScreen #

• Type:** boolean
• Défaut: true

Défini à false pour empêcher Vite d'effacer l'écran du terminal lors de l'enregistrement de certains messages. En ligne de commande, utilisez --clearScreen false.

envDir #

• Type: string
• Défaut: root

Le répertoire à partir duquel les fichiers .env sont chargés. Peut être un chemin absolu, ou un chemin relatif à la racine du projet.

Voir ici pour plus d'informations sur les fichiers d'environnement.

envPrefix #

• Type: string | string[]
• Défaut: VITE_

Les variables env commençant par envPrefix seront exposées au code source de votre client via import.meta.env.