Configuration des npm-scripts de Biome

Voici le modèle de npm-scripts que vous configurez presque systématiquement lorsque vous introduisez Biome dans un projet. Il traite à la fois lint et format de manière uniforme en utilisant la commande biome check.

Configuration de base

{
  "scripts": {
    "lint": "biome check .",
    "format": "biome check . --write"
  }
}

Regroupement par préfixes

Dans les projets avec de nombreux npm-scripts, le regroupement par préfixes facilite l’organisation.

{
  "scripts": {
    "code:lint": "biome check .",
    "code:format": "biome check . --write"
  }
}

Différences entre les commandes

Commande	Comportement
biome check .	Détecte les problèmes et les signale, le code de sortie est non nul en cas d’erreur
biome check . —write	Corrige les problèmes auto-corrigeables
biome format .	Exécute uniquement le formatage
biome lint .	Exécute uniquement le linting

check exécute à la fois lint et format. Il est courant d’utiliser check . dans l’intégration continue et --write pendant le développement.

Exemple d’utilisation dans l’intégration continue

Exemple de configuration dans GitHub Actions :

- name: Vérifier le code
  run: npm run lint

- name: Vérifier le formatage
  run: npx biome format . --check

Ou utilisez check --changed pour valider uniquement les fichiers modifiés :

{
  "scripts": {
    "lint:changed": "biome check --changed ."
  }
}

Cela vous permet de cibler uniquement le diff et de réduire le temps de traitement.

Relation avec les fichiers de configuration

Configurez les détails dans biome.json :

{
  "formatter": {
    "indentStyle": "space",
    "indentWidth": 2
  },
  "linter": {
    "enabled": true,
    "rules": {
      "recommended": true
    }
  }
}

Il est préférable de garder les npm-scripts simples comme points d’entrée et de déléguer la configuration détaillée au fichier de configuration.