RuntimeError is a descendant of StandardError, and rescues happen exactly once per exception handling block. That is, your first code example will never hit RuntimeError because it's swallowed by the implicit StandardError. Here's a class tree of Exception from my local irb: - Exception |- ErrorHighlight::Spotter::NonAscii |- IRB::Abort |- IRB::LoadAbort |- NoMemoryError |- ScriptError | |- LoadError | | `- Gem::LoadError | | |- Gem::ConflictError | | `- Gem::MissingSpecError | | `- Gem::MissingSpecVersionError | |- NotImplementedError | `- SyntaxError |- SecurityError |- SignalException | `- Interrupt |- StandardError | |- ArgumentError | | |- Gem::Requirement::BadRequirementError | | |- IO::Buffer::MaskError | | `- UncaughtThrowError | |- EncodingError | | |- Encoding::CompatibilityError | | |- Encoding::ConverterNotFoundError | | |- Encoding::InvalidByteSequenceError | | `- Encoding::UndefinedConversionError | |- FiberError | |- Fiddle::Error | | |- Fiddle::ClearedReferenceError | | `- Fiddle::DLError | |- Gem::Molinillo::ResolverError | | |- Gem::Molinillo::CircularDependencyError | | |- Gem::Molinillo::NoSuchDependencyError | | `- Gem::Molinillo::VersionConflict | |- Gem::TSort::Cyclic | |- IOError | | |- EOFError | | `- IO::TimeoutError | |- IRB::CantChangeBinding | |- IRB::CantReturnToNormalMode | |- IRB::Command::CommandArgumentError | |- IRB::IllegalParameter | |- IRB::IrbAlreadyDead | |- IRB::IrbSwitchedToCurrentThread | |- IRB::NoSuchJob | |- IRB::RubyLex::TerminateLineInput | |- IRB::SourceFinder::EvaluationError | |- IRB::UndefinedPromptMode | |- IRB::UnrecognizedSwitch | |- IndexError | | |- KeyError | | `- StopIteration | | |- ClosedQueueError | | `- Ractor::ClosedError | |- JSON::JSONError | | |- JSON::GeneratorError | | |- JSON::MissingUnicodeSupport | | `- JSON::ParserError | | `- JSON::NestingError | | `- JSON::CircularDatastructure | |- LocalJumpError | |- Math::DomainError | |- NameError | | `- NoMethodError | |- NoMatchingPatternError | | `- NoMatchingPatternKeyError | |- RangeError | | `- FloatDomainError | |- RegexpError | | `- Regexp::TimeoutError | |- Reline::ConfigEncodingConversionError | |- Reline::Terminfo::TerminfoError | |- Ripper::TokenPattern::Error | | |- Ripper::TokenPattern::CompileError | | `- Ripper::TokenPattern::MatchError | |- RuntimeError | | |- FrozenError | | |- Gem::Exception | | | |- Gem::CommandLineError | | | |- Gem::DependencyError | | | | |- Gem::DependencyResolutionError | | | | `- Gem::UnsatisfiableDependencyError | | | |- Gem::DependencyRemovalException | | | |- Gem::DocumentError | | | |- Gem::EndOfYAMLException | | | |- Gem::FilePermissionError | | | |- Gem::FormatException | | | |- Gem::GemNotFoundException | | | | `- Gem::SpecificGemNotFoundException | | | |- Gem::GemNotInHomeException | | | |- Gem::ImpossibleDependenciesError | | | |- Gem::InstallError | | | | `- Gem::RuntimeRequirementNotMetError | | | |- Gem::InvalidSpecificationException | | | |- Gem::OperationNotSupportedError | | | |- Gem::RemoteError | | | |- Gem::RemoteInstallationCancelled | | | |- Gem::RemoteInstallationSkipped | | | |- Gem::RemoteSourceException | | | |- Gem::RequestSet::Lockfile::ParseError | | | |- Gem::RubyVersionMismatch | | | |- Gem::UninstallError | | | |- Gem::UnknownCommandError | | | |- Gem::VerificationError | | | `- Gem::WebauthnVerificationError | | |- IO::Buffer::AccessError | | |- IO::Buffer::AllocationError | | |- IO::Buffer::InvalidatedError | | |- IO::Buffer::LockedError | | |- RDoc::Error | | |- Ractor::Error | | | |- Ractor::IsolationError | | | |- Ractor::MovedError | | | |- Ractor::RemoteError | | | `- Ractor::UnsafeError | | `- Reline::Config::InvalidInputrc | |- SystemCallError | | |- Errno::E2BIG | | |- Errno::EACCES | | |- Errno::EADDRINUSE | | |- Errno::EADDRNOTAVAIL | | |- Errno::EAFNOSUPPORT | | |- Errno::EAGAIN | | | |- IO::EAGAINWaitReadable | | | `- IO::EAGAINWaitWritable | | |- Errno::EALREADY | | |- Errno::EAUTH | | |- Errno::EBADARCH | | |- Errno::EBADEXEC | | |- Errno::EBADF | | |- Errno::EBADMACHO | | |- Errno::EBADMSG | | |- Errno::EBADRPC | | |- Errno::EBUSY | | |- Errno::ECANCELED | | |- Errno::ECHILD | | |- Errno::ECONNABORTED | | |- Errno::ECONNREFUSED | | |- Errno::ECONNRESET | | |- Errno::EDEADLK | | |- Errno::EDESTADDRREQ | | |- Errno::EDEVERR | | |- Errno::EDOM | | |- Errno::EDQUOT | | |- Errno::EEXIST | | |- Errno::EFAULT | | |- Errno::EFBIG | | |- Errno::EFTYPE | | |- Errno::EHOSTDOWN | | |- Errno::EHOSTUNREACH | | |- Errno::EIDRM | | |- Errno::EILSEQ | | |- Errno::EINPROGRESS | | | |- IO::EINPROGRESSWaitReadable | | | `- IO::EINPROGRESSWaitWritable | | |- Errno::EINTR | | |- Errno::EINVAL | | |- Errno::EIO | | |- Errno::EISCONN | | |- Errno::EISDIR | | |- Errno::ELAST | | |- Errno::ELOOP | | |- Errno::EMFILE | | |- Errno::EMLINK | | |- Errno::EMSGSIZE | | |- Errno::EMULTIHOP | | |- Errno::ENAMETOOLONG | | |- Errno::ENEEDAUTH | | |- Errno::ENETDOWN | | |- Errno::ENETRESET | | |- Errno::ENETUNREACH | | |- Errno::ENFILE | | |- Errno::ENOATTR | | |- Errno::ENOBUFS | | |- Errno::ENODATA | | |- Errno::ENODEV | | |- Errno::ENOENT | | |- Errno::ENOEXEC | | |- Errno::ENOLCK | | |- Errno::ENOLINK | | |- Errno::ENOMEM | | |- Errno::ENOMSG | | |- Errno::ENOPOLICY | | |- Errno::ENOPROTOOPT | | |- Errno::ENOSPC | | |- Errno::ENOSR | | |- Errno::ENOSTR | | |- Errno::ENOSYS | | |- Errno::ENOTBLK | | |- Errno::ENOTCONN | | |- Errno::ENOTDIR | | |- Errno::ENOTEMPTY | | |- Errno::ENOTRECOVERABLE | | |- Errno::ENOTSOCK | | |- Errno::ENOTSUP | | |- Errno::ENOTTY | | |- Errno::ENXIO | | |- Errno::EOPNOTSUPP | | |- Errno::EOVERFLOW | | |- Errno::EOWNERDEAD | | |- Errno::EPERM | | |- Errno::EPFNOSUPPORT | | |- Errno::EPIPE | | |- Errno::EPROCLIM | | |- Errno::EPROCUNAVAIL | | |- Errno::EPROGMISMATCH | | |- Errno::EPROGUNAVAIL | | |- Errno::EPROTO | | |- Errno::EPROTONOSUPPORT | | |- Errno::EPROTOTYPE | | |- Errno::EPWROFF | | |- Errno::ERANGE | | |- Errno::EREMOTE | | |- Errno::EROFS | | |- Errno::ERPCMISMATCH | | |- Errno::ESHLIBVERS | | |- Errno::ESHUTDOWN | | |- Errno::ESOCKTNOSUPPORT | | |- Errno::ESPIPE | | |- Errno::ESRCH | | |- Errno::ESTALE | | |- Errno::ETIME | | |- Errno::ETIMEDOUT | | |- Errno::ETOOMANYREFS | | |- Errno::ETXTBSY | | |- Errno::EUSERS | | |- Errno::EXDEV | | `- Errno::NOERROR | |- ThreadError | |- TypeError | `- ZeroDivisionError |- SystemExit | `- Gem::SystemExitException |- SystemStackError `- fatal -a On Tue, Oct 29, 2024 at 8:48 AM Rodrigo Rosenfeld Rosas via ruby-core < ruby-core@ml.ruby-lang.org> wrote:
Hello, I couldn't find any documentation about the subject, so I thought this behavior should be probably documented.
Given the following code:
def raise_error raise "runtime error message" rescue => e "StandardError: #{e.message}" rescue RuntimeError => e puts "RuntimeError raised: #{e.message}" raise StandardError, "standard error message" end
# same, but the order of the rescue blocks are inverted def raise_error2 raise "runtime error message" rescue RuntimeError => e puts "RuntimeError raised: #{e.message}" raise StandardError, "standard error message" rescue => e "StandardError: #{e.message}" end
p ["raise_error", raise_error ]
begin p ["raise_error2", raise_error2] rescue => e puts "raise_error2 raised: #{e.message}" end
When we run it, this is the output in Ruby 3.3.5:
["raise_error", "StandardError: runtime error message"]
RuntimeError raised: runtime error message
raise_error2 raised: standard error message
In the first case (raise_error), the code raised from the RuntimeError rescue block is rescued by the StandardError block, but when inverting the order of the rescue blocks (raise_error2) then this won't happen.
Is this part of the specs? Is this behavior documented somewhere? Could this behavior differ in different Ruby implementations and versions? Or can we rely on such behavior?
This chapter doesn't include such case in its examples:
https://ruby-doc.com/docs/ProgrammingRuby/html/tut_exceptions.html
Or this documentation about Exceptions:
https://ruby-doc.org/3.3.5/syntax/exceptions_rdoc.html
Is there a recommended way for wrapping exceptions into a particular one and then handling that exception from within the same method rescue blocks? Or is this considered a bad practice?
______________________________________________ ruby-core mailing list -- ruby-core@ml.ruby-lang.org To unsubscribe send an email to ruby-core-leave@ml.ruby-lang.org ruby-core info -- https://ml.ruby-lang.org/mailman3/lists/ruby-core.ml.ruby-lang.org/
-- Austin Ziegler • halostatue@gmail.com • austin@halostatue.ca http://www.halostatue.ca/ • http://twitter.com/halostatue