class Airbrake::Rails::App

@api private
@since v9.0.3
App is a wrapper around Rails.application.

def self.engines

def self.engines
  @engines ||= [*::Rails::Engine.subclasses, ::Rails.application]
end

def self.recognize_route(request)

Returns:
  • (Airbrake::Rails::App::Route, nil) -

Parameters:
  • [] () -- request
def self.recognize_route(request)
  # Duplicate `request` because `recognize` *can* strip the request's
  # `path_info`, which results in broken engine links (when the engine has
  # an isolated namespace).
  request_copy = request.dup
  # Save original script name because `router.recognize(request)` mutates
  # it. It's a Rails bug. More info in:
  #   * https://github.com/airbrake/airbrake/issues/1072
  #   * https://github.com/rails/rails/issues/31152
  original_script_name = request.env['SCRIPT_NAME']
  # We must search every engine individually to find a concrete route. If
  # we rely only on the `Rails.application.routes.router`, then the
  # recognize call would return the root route, neglecting PATH_INFO
  # completely. For example:
  #   * a request is made to `marketing#pricing`
  #   * `Rails.application` recognizes it as `marketing#/` (incorrect)
  #   * `Marketing::Engine` recognizes it as `marketing#/pricing` (correct)
  engines.each do |engine|
    engine.routes.router.recognize(request_copy) do |route, _params|
      # Restore original script name. Remove this code when/if the Rails
      # bug is fixed: https://github.com/airbrake/airbrake/issues/1072
      request.env['SCRIPT_NAME'] = original_script_name
      # Skip "catch-all" routes such as:
      #   get '*path => 'pages#about'
      #
      # Ideally, we should be using `route.glob?` but in Rails 7+ this
      # call would fail with a `NoMethodError`. This is because in
      # Rails 7+ the AST for the route is not kept in memory anymore.
      #
      # See: https://github.com/rails/rails/pull/43006#discussion_r783895766
      next if route.path.spec.any?(ActionDispatch::Journey::Nodes::Star)
      path =
        if engine == ::Rails.application
          route.path.spec.to_s
        else
          "#{engine.engine_name}##{route.path.spec}"
        end
      # Rails can recognize multiple routes for the given request. For
      # example, if we visit /users/2/edit, then Rails sees these routes:
      #   * "/users/:id/edit(.:format)"
      #   *  "/"
      #
      # We return the first route as, what it seems, the most optimal
      # approach.
      return Route.new(path)
    end
  end
  nil
end