Spec-Zone.ru › Ruby 3.4

Exception Обработка исключений

Исключения обрабатываются в блоке begin/end:

begin
  # code that might raise
rescue
  # handle exception
end

Если вы находитесь внутри метода, вам не нужно использовать begin или end, если вы не хотите ограничить область действия обрабатываемых исключений:

def my_method
  # ...
rescue
  # ...
end

То же самое относится к class, module, и block:

[0, 1, 2].map do |i|
  10 / i
rescue ZeroDivisionError
  nil
end
#=> [nil, 10, 5]

Вы можете присвоить исключение локальной переменной, используя => variable_name в конце строки rescue:

begin
  # ...
rescue => exception
  warn exception.message
  raise # re-raise the current exception
end

По умолчанию, StandardError и его подклассы обрабатываются. Вы можете обработать определенный набор классов исключений (и их подклассы), перечислив их после rescue:

begin
  # ...
rescue ArgumentError, NameError
  # handle ArgumentError or NameError
end

Вы можете обрабатывать разные типы исключений по-разному:

begin
  # ...
rescue ArgumentError
  # handle ArgumentError
rescue NameError
  # handle NameError
rescue
  # handle any StandardError
end

Исключение сопоставляется с блоком обработки, начиная с самого верхнего, и совпадает только один раз. Если в блоке begin возбуждается ArgumentError, он не будет обработан в блоке StandardError.

Вы можете повторить обработку исключений:

begin
  # ...
rescue
  # do something that may change the result of the begin block
  retry
end

Выполнение возобновится с начала блока begin, поэтому будьте осторожны, чтобы не создать бесконечный цикл.

Внутри блока rescue — единственное допустимое место для retry, все остальные использования приведут к возбуждению SyntaxError. Если вы хотите повторить итерацию блока, используйте redo. Подробности см. в Управляющих выражениях.

Чтобы всегда выполнить какой-то код, независимо от того, было ли возбуждено исключение или нет, используйте ensure:

begin
  # ...
rescue
  # ...
ensure
  # this always runs BUT does not implicitly return the last evaluated statement.
end

Вы также можете выполнить некоторый код, когда исключение не возбуждается:

begin
  # ...
rescue
  # ...
else
  # this runs only when no exception was raised AND return the last evaluated statement
ensure
  # this always runs.
  # It is evaluated after the evaluation of either the `rescue` or the `else` block.
  # It will not return implicitly.
end

Примечание: Без явного return в блоке ensure блок begin/end вернёт последнее вычисленное выражение перед входом в блок ‘ensure`.

Ruby Core © 1993–2024 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API