Class: Selenium::WebDriver::BiDi::BrowsingContext Private

Inherits:
Object
  • Object
show all
Defined in:
lib/selenium/webdriver/bidi/browsing_context.rb

Overview

This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.

Implements the BrowsingContext Module of the WebDriver-BiDi specification Continue to use functionality from existing driver.navigate method

Constant Summary collapse

READINESS_STATE =

This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future. 

{
  'none' => 'none',
  'eager' => 'interactive',
  'normal' => 'complete'
}.freeze

Instance Method Summary collapse

Constructor Details

#initialize(bridge) ⇒ BrowsingContext

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

TODO: store current window handle in bridge object instead of always calling it



36
37
38
39
40
41
 
# File 'lib/selenium/webdriver/bidi/browsing_context.rb', line 36

def initialize(bridge)
  @bridge = bridge
  @bidi = @bridge.bidi
  page_load_strategy = bridge.capabilities[:page_load_strategy]
  @readiness = READINESS_STATE[page_load_strategy]
end

Instance Method Details

#activate(context_id: nil) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



109
110
111
112
 
# File 'lib/selenium/webdriver/bidi/browsing_context.rb', line 109

def activate(context_id: nil)
  context_id ||= @bridge.window_handle
  @bidi.send_cmd('browsingContext.activate', context: context_id)
end

#close(context_id: nil) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Closes the browsing context.

Parameters:

  • context_id (String) (defaults to: nil) —

    The ID of the context to close. Defaults to the window handle of the current context.



79
80
81
82
 
# File 'lib/selenium/webdriver/bidi/browsing_context.rb', line 79

def close(context_id: nil)
  context_id ||= @bridge.window_handle
  @bidi.send_cmd('browsingContext.close', context: context_id)
end

#create(type: nil, context_id: nil) ⇒ String

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Create a new browsing context.

Parameters:

  • type (Symbol) (defaults to: nil) —

    The type of browsing context to create. Valid options are :tab and :window with :window being the default

  • context_id (String) (defaults to: nil) —

    The reference context for the new browsing context. Defaults to the current window handle.

Returns:

  • (String) —

    The context ID of the created browsing context.



92
93
94
95
96
97
 
# File 'lib/selenium/webdriver/bidi/browsing_context.rb', line 92

def create(type: nil, context_id: nil)
  type ||= :window
  context_id ||= @bridge.window_handle
  result = @bidi.send_cmd('browsingContext.create', type: type.to_s, referenceContext: context_id)
  result['context']
end

#handle_user_prompt(context_id, accept: true, text: nil) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



105
106
107
 
# File 'lib/selenium/webdriver/bidi/browsing_context.rb', line 105

def handle_user_prompt(context_id, accept: true, text: nil)
  @bidi.send_cmd('browsingContext.handleUserPrompt', context: context_id, accept: accept, text: text)
end

#navigate(url, context_id: nil) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Navigates to the specified URL in the given browsing context.

Parameters:

  • url (String) —

    The URL to navigate to.

  • context_id (String, NilClass) (defaults to: nil) —

    The ID of the browsing context to navigate in. Defaults to the window handle of the current context.



48
49
50
51
 
# File 'lib/selenium/webdriver/bidi/browsing_context.rb', line 48

def navigate(url, context_id: nil)
  context_id ||= @bridge.window_handle
  @bidi.send_cmd('browsingContext.navigate', context: context_id, url: url, wait: @readiness)
end

#reload(context_id: nil, ignore_cache: false) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Reloads the browsing context.

Parameters:

  • context_id (String, NilClass) (defaults to: nil) —

    The ID of the context to reload. Defaults to the window handle of the current context.

  • ignore_cache (Boolean) (defaults to: false) —

    Whether to bypass the cache when reloading. Defaults to false.



69
70
71
72
73
 
# File 'lib/selenium/webdriver/bidi/browsing_context.rb', line 69

def reload(context_id: nil, ignore_cache: false)
  context_id ||= @bridge.window_handle
  params = {context: context_id, ignore_cache: ignore_cache, wait: @readiness}
  @bidi.send_cmd('browsingContext.reload', **params)
end

#set_viewport(context_id: nil, width: nil, height: nil, device_pixel_ratio: nil) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



99
100
101
102
103
 
# File 'lib/selenium/webdriver/bidi/browsing_context.rb', line 99

def set_viewport(context_id: nil, width: nil, height: nil, device_pixel_ratio: nil)
  context_id ||= @bridge.window_handle
  params = {context: context_id, viewport: {width:, height:}, device_pixel_ratio:}
  @bidi.send_cmd('browsingContext.setViewport', **params)
end

#traverse_history(delta, context_id: nil) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Traverses the browsing context history by a given delta.

Parameters:

  • delta (Integer) —

    The number of steps to traverse. Positive values go forwards, negative values go backwards.

  • context_id (String, NilClass) (defaults to: nil) —

    The ID of the context to traverse. Defaults to the window handle of the current context.



59
60
61
62
 
# File 'lib/selenium/webdriver/bidi/browsing_context.rb', line 59

def traverse_history(delta, context_id: nil)
  context_id ||= @bridge.window_handle
  @bidi.send_cmd('browsingContext.traverseHistory', context: context_id, delta: delta)
end