Class: Puppeteer::BrowserContext

Inherits:
Object
  • Object
show all
Includes:
EventCallbackable
Defined in:
lib/puppeteer/browser_context.rb

Constant Summary collapse

WEB_PERMISSION_TO_PROTOCOL = 
{
  'geolocation' => 'geolocation',
  'midi' => 'midi',
  'notifications' => 'notifications',
  # TODO: push isn't a valid type?
  # 'push' => 'push',
  'camera' => 'videoCapture',
  'microphone' => 'audioCapture',
  'background-sync' => 'backgroundSync',
  'ambient-light-sensor' => 'sensors',
  'accelerometer' => 'sensors',
  'gyroscope' => 'sensors',
  'magnetometer' => 'sensors',
  'accessibility-events' => 'accessibilityEvents',
  'clipboard-read' => 'clipboardReadWrite',
  'clipboard-write' => 'clipboardReadWrite',
  'payment-handler' => 'paymentHandler',
  'persistent-storage' => 'durableStorage',
  'idle-detection' => 'idleDetection',
  # chrome-specific permissions we have.
  'midi-sysex' => 'midiSysex',
}.freeze

Instance Method Summary collapse

Methods included from EventCallbackable

#add_event_listener, #emit_event, #observe_first, #on_event, #remove_event_listener

Constructor Details

#initialize(connection, browser, context_id) ⇒ BrowserContext

Returns a new instance of BrowserContext.

Parameters:



8
9
10
11
12
 
# File 'lib/puppeteer/browser_context.rb', line 8

def initialize(connection, browser, context_id)
  @connection = connection
  @browser = browser
  @id = context_id
end

Instance Method Details

#async_wait_for_target(predicate: , timeout: nil) ⇒ Object

Parameters:



49
 
# File 'lib/puppeteer/browser_context.rb', line 49

define_async_method :async_wait_for_target

#browser ⇒ Browser

Returns:



112
113
114
 
# File 'lib/puppeteer/browser_context.rb', line 112

def browser
  @browser
end

#clear_permission_overrides ⇒ Object 



98
99
100
101
102
103
104
 
# File 'lib/puppeteer/browser_context.rb', line 98

def clear_permission_overrides
  if @id
    @connection.send_message('Browser.resetPermissions', browserContextId: @id)
  else
    @connection.send_message('Browser.resetPermissions')
  end
end

#close ⇒ Object 



116
117
118
119
120
121
 
# File 'lib/puppeteer/browser_context.rb', line 116

def close
  unless @id
    raise 'Non-incognito profiles cannot be closed!'
  end
  @browser.dispose_context(@id)
end

#incognito? ⇒ Boolean

Returns:

  • (Boolean) 


58
59
60
 
# File 'lib/puppeteer/browser_context.rb', line 58

def incognito?
  !!@id
end

#new_page ⇒ Future<Puppeteer::Page>

Returns:



107
108
109
 
# File 'lib/puppeteer/browser_context.rb', line 107

def new_page
  @browser.create_page_in_context(@id)
end

#on(event_name, &block) ⇒ Object

Parameters:

  • event_name (Symbol) —

    either of :disconnected, :targetcreated, :targetchanged, :targetdestroyed



15
16
17
18
19
20
21
 
# File 'lib/puppeteer/browser_context.rb', line 15

def on(event_name, &block)
  unless BrowserContextEmittedEvents.values.include?(event_name.to_s)
    raise ArgumentError.new("Unknown event name: #{event_name}. Known events are #{BrowserContextEmittedEvents.values.to_a.join(", ")}")
  end

  super(event_name.to_s, &block)
end

#once(event_name, &block) ⇒ Object

Parameters:

  • event_name (Symbol) 


24
25
26
27
28
29
30
 
# File 'lib/puppeteer/browser_context.rb', line 24

def once(event_name, &block)
  unless BrowserContextEmittedEvents.values.include?(event_name.to_s)
    raise ArgumentError.new("Unknown event name: #{event_name}. Known events are #{BrowserContextEmittedEvents.values.to_a.join(", ")}")
  end

  super(event_name.to_s, &block)
end

#override_permissions(origin, permissions) ⇒ Object

Parameters:

  • origin (String)
  • permissions (Array<String>) 


87
88
89
90
91
92
93
94
95
96
 
# File 'lib/puppeteer/browser_context.rb', line 87

def override_permissions(origin, permissions)
  protocol_permissions = permissions.map do |permission|
    WEB_PERMISSION_TO_PROTOCOL[permission] or raise ArgumentError.new("Unknown permission: #{permission}")
  end
  @connection.send_message('Browser.grantPermissions', {
    origin: origin,
    browserContextId: @id,
    permissions: protocol_permissions,
  }.compact)
end

#pages ⇒ !Promise<!Array<!Puppeteer.Page>>

Returns:



52
53
54
55
56
 
# File 'lib/puppeteer/browser_context.rb', line 52

def pages
  targets.select { |target|
    target.type == 'page' || (target.type == 'other' && @browser.is_page_target_callback&.call(target.target_info))
  }.map(&:page).reject { |page| !page }
end

#targets ⇒ !Array<!Target>

Returns target.

Returns:

  • (!Array<!Target>) —

    target



33
34
35
 
# File 'lib/puppeteer/browser_context.rb', line 33

def targets
  @browser.targets.select { |target| target.browser_context == self }
end

#wait_for_target(predicate:, timeout: nil) ⇒ Puppeteer::Target

Parameters:

Returns:



39
40
41
42
43
44
 
# File 'lib/puppeteer/browser_context.rb', line 39

def wait_for_target(predicate:, timeout: nil)
  @browser.wait_for_target(
    predicate: ->(target) { target.browser_context == self && predicate.call(target) },
    timeout: timeout,
  )
end