Class: Mechanize::Page::Link

Inherits:
Object
  • Object
show all
Defined in:
lib/mechanize/page/link.rb

Direct Known Subclasses

Base, Frame, MetaRefresh

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(node, mech, page) ⇒ Link

Returns a new instance of Link.



21
22
23
24
25
26
27
28
29
 
# File 'lib/mechanize/page/link.rb', line 21

def initialize(node, mech, page)
  @node       = node
  @attributes = node
  @href       = node['href']
  @mech       = mech
  @page       = page
  @text       = nil
  @uri        = nil
end

Instance Attribute Details

#attributes ⇒ Object (readonly)

Returns the value of attribute attributes.



17
18
19
 
# File 'lib/mechanize/page/link.rb', line 17

def attributes
  @attributes
end

#href ⇒ Object (readonly)

Returns the value of attribute href.



16
17
18
 
# File 'lib/mechanize/page/link.rb', line 16

def href
  @href
end

#node ⇒ Object (readonly)

Returns the value of attribute node.



15
16
17
 
# File 'lib/mechanize/page/link.rb', line 15

def node
  @node
end

#page ⇒ Object (readonly) Also known as: referer

Returns the value of attribute page.



18
19
20
 
# File 'lib/mechanize/page/link.rb', line 18

def page
  @page
end

Instance Method Details

#click ⇒ Object

Click on this link



32
33
34
 
# File 'lib/mechanize/page/link.rb', line 32

def click
  @mech.click self
end

#dom_class ⇒ Object

This method is a shorthand to get a link’s DOM class Common usage:

page.link_with(:dom_class => "links_exact_class")



46
47
48
 
# File 'lib/mechanize/page/link.rb', line 46

def dom_class
  node['class']
end

#dom_id ⇒ Object

This method is a shorthand to get link’s DOM id. Common usage:

page.link_with(:dom_id => "links_exact_id")



39
40
41
 
# File 'lib/mechanize/page/link.rb', line 39

def dom_id
  node['id']
end

#noreferrer? ⇒ Boolean

Test if this link should not be traced.

Returns:

  • (Boolean) 


70
71
72
 
# File 'lib/mechanize/page/link.rb', line 70

def noreferrer?
  rel?('noreferrer')
end

#pretty_print(q) ⇒ Object

:nodoc:



50
51
52
53
54
55
 
# File 'lib/mechanize/page/link.rb', line 50

def pretty_print(q) # :nodoc:
  q.object_group(self) {
    q.breakable; q.pp text
    q.breakable; q.pp href
  }
end

#rel ⇒ Object

A list of words in the rel attribute, all lower-cased.



60
61
62
 
# File 'lib/mechanize/page/link.rb', line 60

def rel
  @rel ||= (val = attributes['rel']) ? val.downcase.split(' ') : []
end

#rel?(kind) ⇒ Boolean

Test if the rel attribute includes kind.

Returns:

  • (Boolean) 


65
66
67
 
# File 'lib/mechanize/page/link.rb', line 65

def rel? kind
  rel.include? kind
end

#resolved_uri ⇒ Object

A fully resolved URI for the #href for this link.



110
111
112
 
# File 'lib/mechanize/page/link.rb', line 110

def resolved_uri
  @mech.resolve uri
end

#text ⇒ Object Also known as: to_s

The text content of this link



75
76
77
78
79
80
81
82
83
84
85
86
87
88
 
# File 'lib/mechanize/page/link.rb', line 75

def text
  return @text if @text

  @text = @node.inner_text

  # If there is no text, try to find an image and use it's alt text
  if (@text.nil? or @text.empty?) and imgs = @node.search('img') then
    @text = imgs.map do |e|
      e['alt']
    end.join
  end

  @text
end

#uri ⇒ Object

A URI for the #href for this link. The link is first parsed as a raw link. If that fails parsing an escaped link is attepmted.



95
96
97
98
99
100
101
102
103
104
105
106
107
 
# File 'lib/mechanize/page/link.rb', line 95

def uri
  @uri ||= if @href then
             begin
               URI.parse @href
             rescue URI::InvalidURIError
               begin
                 URI.parse(Addressable::URI.escape(@href))
               rescue Addressable::URI::InvalidURIError
                 raise URI::InvalidURIError
               end
             end
           end
end