123456789_123456789_123456789_123456789_123456789_

Class: Capybara::Driver::Base

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Subclasses:
RackTest::Driver, Selenium::Driver
Inherits: Object
Defined in: lib/capybara/driver/base.rb

Instance Attribute Summary

Instance Method Summary

Instance Attribute Details

#needs_server? ⇒ Boolean (readonly)

[ GitHub ] 

  


# File 'lib/capybara/driver/base.rb', line 165



def needs_server?
  false
end


  








  

    #session   (rw, private)
  

  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 175



def session
  @session ||= nil
end


  








  

    #session=(value)   (rw)
  

  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 4



attr_writer :session


  








  

    #wait?  ⇒ Boolean  (readonly)
  

  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 159



def wait?
  false
end


  







Instance Method Details



  

    #accept_modal(type, **options, &blk)  ⇒ String 
  



  

    

Execute the block, and then accept the modal opened.


  





  
Parameters:


    
  
  • 
    type
    (:alert, :confirm, :prompt)
  
    • 
  
  • 
    options
    (Hash)
—    
    

    a customizable set of options
    

    
  
    • 


    
Options Hash (**options):

    
    
        
  • 
          :wait
          (Numeric)
            — 
    

    How long to wait for the modal to appear after executing the block.
    

            
    • 
        
  • 
          :text
          (String, Regexp)
            — 
    

    Text to verify is in the message shown in the modal
    

            
    • 
        
  • 
          :with
          (String)
            — 
    

    Text to fill in in the case of a prompt
    

            
    • 
    


Returns:


    
  
  • 
    (String)
—    
    

    the message shown in the modal
    

    
  
    • 



Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 138



def accept_modal(type, **options, &blk)
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#accept_modal'
end


  








  

    #active_element  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 66



def active_element
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#active_element'
end


  








  

    #close_window(handle)  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 108



def close_window(handle)
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#close_window'
end


  








  

    #current_url  
  



  

    
  





  
Raises:


    
  
  • 
    (NotImplementedError)
  
    • 





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 6



def current_url
  raise NotImplementedError
end


  








  

    #current_window_handle  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 88



def current_window_handle
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#current_window_handle'
end


  








  

    #dismiss_modal(type, **options, &blk)  ⇒ String 
  



  

    

Execute the block, and then dismiss the modal opened.


  





  
Parameters:


    
  
  • 
    type
    (:alert, :confirm, :prompt)
  
    • 
  
  • 
    options
    (Hash)
—    
    

    a customizable set of options
    

    
  
    • 


    
Options Hash (**options):

    
    
        
  • 
          :wait
          (Numeric)
            — 
    

    How long to wait for the modal to appear after executing the block.
    

            
    • 
        
  • 
          :text
          (String, Regexp)
            — 
    

    Text to verify is in the message shown in the modal
    

            
    • 
    


Returns:


    
  
  • 
    (String)
—    
    

    the message shown in the modal
    

    
  
    • 



Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 151



def dismiss_modal(type, **options, &blk)
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#dismiss_modal'
end


  








  

    #evaluate_async_script(script, *args)  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 46



def evaluate_async_script(script, *args)
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#evaluate_script_asnyc'
end


  








  

    #evaluate_script(script, *args)  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 42



def evaluate_script(script, *args)
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#evaluate_script'
end


  








  

    #execute_script(script, *args)  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 38



def execute_script(script, *args)
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#execute_script'
end


  








  

    #find_css(query, **options)  
  



  

    
  





  
Raises:


    
  
  • 
    (NotImplementedError)
  
    • 





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 22



def find_css(query, **options)
  raise NotImplementedError
end


  








  

    #find_xpath(query, **options)  
  



  

    
  





  
Raises:


    
  
  • 
    (NotImplementedError)
  
    • 





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 18



def find_xpath(query, **options)
  raise NotImplementedError
end


  








  

    #frame_title  
  

  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 78



def frame_title
  find_xpath('/html/head/title').map(&:all_text).first.to_s
end


  








  

    #frame_url  
  

  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 82



def frame_url
  evaluate_script('document.location.href')
rescue Capybara::NotSupportedByDriverError
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#frame_title'
end


  








  

    #fullscreen_window(handle)  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 104



def fullscreen_window(handle)
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#fullscreen_window'
end


  








  

    #go_back  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 30



def go_back
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#go_back'
end


  








  

    #go_forward  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 34



def go_forward
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#go_forward'
end


  








  

    #html  
  



  

    
  





  
Raises:


    
  
  • 
    (NotImplementedError)
  
    • 





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 26



def html
  raise NotImplementedError
end


  








  

    #invalid_element_errors  
  

  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 155



def invalid_element_errors
  []
end


  








  

    #maximize_window(handle)  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 100



def maximize_window(handle)
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#maximize_window'
end


  








  

    #no_such_window_error  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 124



def no_such_window_error
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#no_such_window_error'
end


  








  

    #open_new_window  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 116



def open_new_window
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#open_new_window'
end


  








  

    #refresh  
  



  

    
  





  
Raises:


    
  
  • 
    (NotImplementedError)
  
    • 





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 14



def refresh
  raise NotImplementedError
end


  








  

    #reset!  
  

  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 163



def reset!; end


  








  

    #resize_window_to(handle, width, height)  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 96



def resize_window_to(handle, width, height)
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#resize_window_to'
end


  








  

    #response_headers  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 54



def response_headers
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#response_headers'
end


  








  

    #save_screenshot(path, **options)  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 50



def save_screenshot(path, **options)
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#save_screenshot'
end


  








  

    #send_keys  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 62



def send_keys(*)
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#send_keys'
end


  








  

    #session_options  
  

  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 169



def session_options
  session&.config || Capybara.session_options
end


  








  

    #status_code  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 58



def status_code
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#status_code'
end


  








  

    #switch_to_frame(frame)  
  



  

    
  





  
Parameters:



Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 74



def switch_to_frame(frame)
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#switch_to_frame'
end


  








  

    #switch_to_window(handle)  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 120



def switch_to_window(handle)
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#switch_to_window'
end


  








  

    #visit(path)  
  



  

    
  





  
Raises:


    
  
  • 
    (NotImplementedError)
  
    • 





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 10



def visit(path)
  raise NotImplementedError
end


  








  

    #window_handles  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 112



def window_handles
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#window_handles'
end


  








  

    #window_size(handle)  
  



  

    
  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/capybara/driver/base.rb', line 92



def window_size(handle)
  raise Capybara::NotSupportedByDriverError, 'Capybara::Driver::Base#window_size'
end