Class: Puppeteer::NetworkManager

Inherits:
Object
  • Object
show all
Includes:
DebugPrint, EventCallbackable, IfPresent
Defined in:
lib/puppeteer/network_manager.rb

Defined Under Namespace

Classes: Credentials, InternalNetworkCondition

Instance Method Summary collapse

Methods included from IfPresent

#if_present

Methods included from EventCallbackable

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

Methods included from DebugPrint

#debug_print, #debug_puts

Constructor Details

#initialize(client, ignore_https_errors, frame_manager) ⇒ NetworkManager

Returns a new instance of NetworkManager.

Parameters:



59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
 
# File 'lib/puppeteer/network_manager.rb', line 59

def initialize(client, ignore_https_errors, frame_manager)
  @client = client
  @ignore_https_errors = ignore_https_errors
  @frame_manager = frame_manager

  # @type {!Map<string, !Request>}
  @request_id_to_request = {}

  # @type {!Map<string, !Protocol.Network.requestWillBeSentPayload>}
  @request_id_to_request_with_be_sent_event = {}

  @extra_http_headers = {}

  @attempted_authentications = Set.new
  @user_request_interception_enabled = false
  @protocol_request_interception_enabled = false
  @user_cache_disabled = false
  @request_id_to_interception_id = {}
  @internal_network_condition = InternalNetworkCondition.new(@client)

  @client.on_event('Fetch.requestPaused') do |event|
    handle_request_paused(event)
  end
  @client.on_event('Fetch.authRequired') do |event|
    handle_auth_required(event)
  end
  @client.on_event('Network.requestWillBeSent') do |event|
    handle_request_will_be_sent(event)
  end
  @client.on_event('Network.requestServedFromCache') do |event|
    handle_request_served_from_cache(event)
  end
  @client.on_event('Network.responseReceived') do |event|
    handle_response_received(event)
  end
  @client.on_event('Network.loadingFinished') do |event|
    handle_loading_finished(event)
  end
  @client.on_event('Network.loadingFailed') do |event|
    handle_loading_failed(event)
  end
end

Instance Method Details

#authenticate(username:, password:) ⇒ Object

Parameters:

  • username (String|NilClass)
  • password (String|NilClass) 


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

def authenticate(username:, password:)
  @credentials = Credentials.new(username: username, password: password)
  update_protocol_request_interception
end

#cache_enabled=(enabled) ⇒ Object 



149
150
151
152
 
# File 'lib/puppeteer/network_manager.rb', line 149

def cache_enabled=(enabled)
  @user_cache_disabled = !enabled
  update_protocol_cache_disabled
end

#emulate_network_conditions(network_condition) ⇒ Object

Parameters:



140
141
142
 
# File 'lib/puppeteer/network_manager.rb', line 140

def emulate_network_conditions(network_condition)
  @internal_network_condition.network_condition = network_condition
end

#extra_http_headers ⇒ !Object<string, string>

Returns:

  • (!Object<string, string>) 


130
131
132
 
# File 'lib/puppeteer/network_manager.rb', line 130

def extra_http_headers
  @extra_http_headers.dup
end

#extra_http_headers=(headers) ⇒ Object

Parameters:

  • extraHTTPHeaders (!Object<string, string>) 


117
118
119
120
121
122
123
124
125
126
127
 
# File 'lib/puppeteer/network_manager.rb', line 117

def extra_http_headers=(headers)
  new_extra_http_headers = {}
  headers.each do |key, value|
    unless value.is_a?(String)
      raise ArgumentError.new("Expected value of header \"#{key}\" to be String, but \"#{value}\" is found.")
    end
    new_extra_http_headers[key.downcase] = value
  end
  @extra_http_headers = new_extra_http_headers
  @client.send_message('Network.setExtraHTTPHeaders', headers: new_extra_http_headers)
end

#init ⇒ Object 



102
103
104
105
106
107
 
# File 'lib/puppeteer/network_manager.rb', line 102

def init
  @client.send_message('Network.enable')
  if @ignore_https_errors
    @client.send_message('Security.setIgnoreCertificateErrors', ignore: true)
  end
end

#offline_mode=(value) ⇒ Object

Parameters:

  • value (TrueClass|FalseClass) 


135
136
137
 
# File 'lib/puppeteer/network_manager.rb', line 135

def offline_mode=(value)
  @internal_network_condition.offline_mode=(value)
end

#request_interception=(enabled) ⇒ Object 



154
155
156
157
 
# File 'lib/puppeteer/network_manager.rb', line 154

def request_interception=(enabled)
  @user_request_interception_enabled = enabled
  update_protocol_request_interception
end

#user_agent=(user_agent) ⇒ Object

Parameters:

  • user_agent (String) 


145
146
147
 
# File 'lib/puppeteer/network_manager.rb', line 145

def user_agent=(user_agent)
  @client.send_message('Network.setUserAgentOverride', userAgent: user_agent)
end