Class: Watir::FileField

Inherits:
Input show all
Defined in:
lib/watir-webdriver/elements/file_field.rb

Constant Summary

Constants included from AttributeHelper

AttributeHelper::IGNORED_ATTRIBUTES

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Input

#enabled?, #to_button, #to_checkbox, #to_file_field, #to_radio, #to_text_field, #type

Methods inherited from Element

#==, #attribute_value, #click, #double_click, #driver, #element, #exists?, #fire_event, #flash, #focus, #hash, #html, #initialize, #inspect, #parent, #present?, #right_click, #run_checkers, #send_keys, #style, #tag_name, #text, #visible?, #wait_until_present, #wait_while_present, #when_present

Methods included from AttributeHelper

#attribute_list, #attributes, #typed_attributes

Methods included from Container

#a, #abbr, #abbrs, #address, #addresses, #area, #areas, #article, #articles, #as, #aside, #asides, #audio, #audios, #b, #base, #bases, #bdo, #bdos, #blockquote, #blockquotes, #body, #bodys, #br, #brs, #bs, #button, #buttons, #canvas, #canvases, #caption, #captions, #cell, #cells, #checkbox, #checkboxes, #cite, #cites, #code, #codes, #col, #colgroup, #colgroups, #cols, #command, #commands, #datalist, #datalists, #dd, #dds, #del, #dels, #details, #dfn, #dfns, #div, #divs, #dl, #dls, #dt, #dts, #em, #embed, #embeds, #ems, #fieldset, #fieldsets, #figcaption, #figcaptions, #figure, #figures, #file_field, #file_fields, #font, #fonts, #footer, #footers, #form, #forms, #frame, #frames, #h1, #h1s, #h2, #h2s, #h3, #h3s, #h4, #h4s, #h5, #h5s, #h6, #h6s, #head, #header, #headers, #heads, #hgroup, #hgroups, #hidden, #hiddens, #hr, #hrs, #html, #htmls, #i, #iframe, #iframes, #image, #images, #img, #imgs, #input, #inputs, #ins, #inses, #is, #kbd, #kbds, #keygen, #keygens, #label, #labels, #legend, #legends, #li, #link, #links, #lis, #map, #maps, #mark, #marks, #menu, #menus, #meta, #metas, #meter, #meters, #nav, #navs, #noscript, #noscripts, #object, #objects, #ol, #ols, #optgroup, #optgroups, #option, #options, #output, #outputs, #p, #param, #params, #pre, #pres, #progress, #progresses, #ps, #q, #qs, #radio, #radios, #row, #rows, #rp, #rps, #rt, #rts, #rubies, #ruby, #samp, #samps, #script, #scripts, #section, #sections, #select, #select_list, #select_lists, #selects, #small, #smalls, #source, #sources, #span, #spans, #strong, #strongs, #style, #styles, #sub, #subs, #summaries, #summary, #sup, #sups, #table, #tables, #tbody, #tbodys, #td, #tds, #text_field, #text_fields, #textarea, #textareas, #tfoot, #tfoots, #th, #thead, #theads, #ths, #time, #times, #title, #titles, #tr, #track, #tracks, #trs, #ul, #uls, #var, #vars, #video, #videos, #wbr, #wbrs

Methods included from XpathSupport

#element_by_xpath, #elements_by_xpath

Constructor Details

This class inherits a constructor from Watir::Element

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class Watir::Element

Class Method Details

.from(parent, element) ⇒ Object 



4
5
6
7
8
9
10
 
# File 'lib/watir-webdriver/elements/file_field.rb', line 4

def self.from(parent, element)
  if element.attribute(:type) != "file"
    raise TypeError, "expected type=file for #{element.inspect}"
  end

  super
end

Instance Method Details

#set(path) ⇒ Object

Set the file field to the given path

Parameters:

Raises:

  • (Errno::ENOENT) —

    if the file doesn’t exist



20
21
22
23
 
# File 'lib/watir-webdriver/elements/file_field.rb', line 20

def set(path)
  raise Errno::ENOENT, path unless File.exist?(path)
  self.value = path
end

#value ⇒ String

Return the value of this field

In IE, the path returned depends on the “Include local directory path when uploading files to a server” security setting:

Returns:

See Also:



47
48
49
50
51
 
# File 'lib/watir-webdriver/elements/file_field.rb', line 47

def value
  # since 'value' is an attribute on input fields, we override this here
  assert_exists
  @element.value
end

#value=(path) ⇒ Object

Set the file field to the given path

Parameters:



30
31
32
33
34
 
# File 'lib/watir-webdriver/elements/file_field.rb', line 30

def value=(path)
  assert_exists
  path = path.gsub(File::SEPARATOR, File::ALT_SEPARATOR) if File::ALT_SEPARATOR
  @element.send_keys path
end