Method: Nokogiri::XML::Searchable#ancestor!

Defined in:: lib/ryoba/nokogiri/xml/searchable.rb

#ancestor!(selector = nil) ⇒ `Nokogiri::XML::Element`

Like #ancestors!, but returns only the first matching ancestor.

Examples:

xml = Nokogiri::XML(<<-XML)
  <body>
    <div id="a">
      <div id="b">
        <img src="cat.jpg">
      </div>
    </div>
  </body>
XML

xml.at("img").ancestor!        # == Node div#b
xml.at("img").ancestor!("#a")  # == Node div#a
xml.at("img").ancestor!("#z")  # raises exception

Parameters:

selector (String) (defaults to: nil)

Returns:

(Nokogiri::XML::Element)

Raises:

(Ryoba::Error) —
if no ancestors match selector



128
129
130

# File 'lib/ryoba/nokogiri/xml/searchable.rb', line 128

def ancestor!(selector = nil)
  self.ancestors!(selector).first
end