“There are two ways to write error-free programs; only the third one works.” — Alan J. Perlis 

Introduction ⚙️

• Comment elles fonctionnent ?
• Quelles sont les plus courantes ?
• Comment les lire intelligemment ?
• Comment les gérer proprement ?
• Comment créer ses propres erreurs utiles pour ton app ?

Avec des exemples concrets, des bonnes pratiques, des nouveautés de Ruby 3.4.1, et même quelques retours de devs glanés sur Reddit. Bref, tout ce qu’il faut pour que les erreurs ne te fassent plus peur.

I. C’est quoi une exception en Ruby ? 🧩

begin
  # code potentiellement problématique
rescue
  # code exécuté en cas d’erreur
end

• Silencieuses : capturées et gérées
• Fatales : non capturées, le programme s’arrête

II. Lire un message d’erreur : le stack trace expliqué 🐛

• le fichier concerné
• la ligne où ça a planté
• le type d’erreur
• le message explicite

main.rb:12:in `calculate': divided by 0 (ZeroDivisionError)

NameError: undefined local variable or method `usr' for main:Object
Did you mean?  user

III. Les erreurs les plus fréquentes 🧱

puts total_price
# => NameError: undefined local variable or method 'total_price'

user = nil
user.name
# => NoMethodError: undefined method `name` for nil:NilClass

def greet(name, age); end
greet("Alice")
# => ArgumentError: wrong number of arguments (given 1, expected 2)

if true
  puts "ok"
# => SyntaxError: unexpected end-of-input, expecting keyword_end

[1, 2, 3] + "salut"
# => TypeError: no implicit conversion of String into Array

10 / 0
# => ZeroDivisionError: divided by 0

File.read("/path/to/missing/file")
# => Errno::ENOENT: No such file or directory

IV. Comment gérer les erreurs proprement 🛠️

begin
  risky_code
rescue => e
  puts e.class       # Type d'erreur
  puts e.message     # Message associé
  puts e.backtrace   # Détail des appels
end

• else s’exécute si aucune erreur n’est levée
• ensure s’exécute dans tous les cas, erreur ou pas

begin
  puts "On tente un truc"
rescue => e
  puts "Erreur capturée : #{e.message}"
else
  puts "Tout s'est bien passé !"
ensure
  puts "Nettoyage systématique"
end

tries = 0
begin
  fetch_remote_data
rescue NetworkTimeout => e
  tries += 1
  retry if tries < 3
  raise "Échec après 3 tentatives"
end

V. Lever ses propres exceptions 🚨

raise "Ce nom est invalide"

class PermissionDenied < StandardError; end

def delete_user(user)
  raise PermissionDenied, "Vous n'avez pas le droit de faire ça" unless user.admin?
end

class ApiError < StandardError
  attr_reader :code

  def initialize(message, code)
    super(message)
    @code = code
  end
end

VI. L’arbre des exceptions Ruby 🌳

Exception
├── NoMemoryError
├── ScriptError
│   ├── LoadError
│   ├── SyntaxError
├── SignalException
│   └── Interrupt
├── StandardError
│   ├── ArgumentError
│   ├── ZeroDivisionError
│   ├── RuntimeError
│   ├── NoMethodError
│   ├── etc.

VII. Nouveautés et changements dans Ruby 3.4.1 🧪

rescue => e
  puts e.full_message(highlight: true)

begin
  raise "Erreur A"
rescue => e
  raise "Erreur B"
end

VIII. Bonnes pratiques ✅

• Ne fais jamais rescue nil : tu masques l’erreur, tu ne la règles pas.
• Ne rescue pas Exception sauf cas ultra spécifiques (comme un moteur de sandbox).
• Loggue toujours ce que tu interceptes (au moins e.message).
• Utilise ensure pour nettoyer après une opération critique (fichier, DB, etc.).
• Crée des erreurs personnalisées avec des noms clairs : InvalidCredentials, RateLimitExceeded, etc.

IX. Bonus : outils de debug Ruby 🧰

• pry-rescue : ouvre un REPL automatiquement dès qu'une exception se produit.
• byebug : très utile pour mettre un breakpoint dans un rescue.
• binding.irb ou binding.pry : explore l'état du programme en live.
• exception.full_message(highlight: true) : affiche le message d’erreur avec couleurs et contexte.
• Sentry / Rollbar / Bugsnag : pour suivre les exceptions en production.

Conclusion 🎬

Happy coding ! 🚀