import Update from "/snippets/cli/update.mdx";

NOTE

Pour mettre à niveau votre version de Bun CLI, consultez [`bun upgrade`](/fr/runtime/installation#upgrading).

Pour mettre à jour toutes les dépendances vers la dernière version :

bun update

Pour mettre à jour une dépendance spécifique vers la dernière version :

bun update [package]

--interactive

Pour une expérience de mise à jour plus contrôlée, utilisez le drapeau --interactive pour sélectionner quels packages mettre à jour :

bun update --interactive
bun update -i

Cela lance une interface terminal interactive qui affiche tous les packages obsolètes avec leurs versions actuelles et cibles. Vous pouvez ensuite sélectionner quels packages mettre à jour.

Interface interactive

L'interface affiche les packages regroupés par type de dépendance :

? Sélectionner les packages à mettre à jour - Espace pour basculer, Entrée pour confirmer, a pour tout sélectionner, n pour désélectionner, i pour inverser, l pour basculer vers latest

  dependencies                Actuel  Cible    Latest
    □ react                   17.0.2  18.2.0   18.3.1
    □ lodash                  4.17.20 4.17.21  4.17.21

  devDependencies             Actuel  Cible    Latest
    □ typescript              4.8.0   5.0.0    5.3.3
    □ @types/node             16.11.7 18.0.0   20.11.5

  optionalDependencies        Actuel  Cible    Latest
    □ some-optional-package   1.0.0   1.1.0    1.2.0

Sections :

• Les packages sont regroupés sous des en-têtes de section : dependencies, devDependencies, peerDependencies, optionalDependencies
• Chaque section affiche des en-têtes de colonnes alignés avec les données des packages

Colonnes :

• Package : Nom du package (peut avoir un suffixe comme dev, peer, optional pour plus de clarté)
• Actuel : Version actuellement installée
• Cible : Version qui serait installée (respecte les contraintes semver)
• Latest : Dernière version disponible

Contrôles clavier

Sélection :

• Espace : Basculer la sélection du package
• Entrée : Confirmer les sélections et mettre à jour
• a/A : Sélectionner tous les packages
• n/N : Désélectionner
• i/I : Inverser la sélection

Navigation :

• Flèches ↑/↓ ou j/k : Déplacer le curseur
• l/L : Basculer entre la version cible et latest pour le package actuel

Quitter :

• Ctrl+C ou Ctrl+D : Annuler sans mettre à jour

Indicateurs visuels

• ☑ Packages sélectionnés (seront mis à jour)
• □ Packages non sélectionnés
• > Position actuelle du curseur
• Couleurs : Rouge (majeure), jaune (mineure), vert (correctif) pour les changements de version
• Souligné : Cible de mise à jour actuellement sélectionnée

Regroupement des packages

Les packages sont organisés en sections par type de dépendance :

• dependencies - Dépendances d'exécution régulières
• devDependencies - Dépendances de développement
• peerDependencies - Dépendances peer
• optionalDependencies - Dépendances optionnelles

Dans chaque section, les packages individuels peuvent avoir des suffixes supplémentaires ( dev, peer, optional) pour plus de clarté.

--recursive

Utilisez le drapeau --recursive avec --interactive pour mettre à jour les dépendances dans tous les workspaces d'un monorepo :

bun update --interactive --recursive
bun update -i -r

Cela affiche une colonne "Workspace" supplémentaire montrant à quel workspace chaque dépendance appartient.

--latest

Par défaut, bun update mettra à jour vers la dernière version d'une dépendance qui satisfait la plage de versions spécifiée dans votre package.json.

Pour mettre à jour vers la dernière version, indépendamment de la compatibilité avec la plage de versions actuelle, utilisez le drapeau --latest :

bun update --latest

En mode interactif, vous pouvez basculer des packages individuels entre leur version cible (respectant semver) et la dernière version en utilisant la touche l.

Par exemple, avec le package.json suivant :

{
  "dependencies": {
    "react": "^17.0.2"
  }
}

• bun update mettrait à jour vers une version correspondant à 17.x.
• bun update --latest mettrait à jour vers une version correspondant à 18.x ou ultérieure.

---