"Fossies" - the Fresh Open Source Software Archive

Member "selenium-selenium-4.8.1/rb/lib/selenium/webdriver/common/driver_extensions/has_network_interception.rb" (17 Feb 2023, 2665 Bytes) of package /linux/www/selenium-selenium-4.8.1.tar.gz:

As a special service "Fossies" has tried to format the requested source page into HTML format using (guessed) Ruby source code syntax highlighting (style: standard) with prefixed line numbers and code folding option. Alternatively you can here view or download the uninterpreted source code file. See also the last Fossies "Diffs" side-by-side code changes report for "has_network_interception.rb": 4.7.0_vs_4.8.0.

    1 # frozen_string_literal: true
    2 
    3 # Licensed to the Software Freedom Conservancy (SFC) under one
    4 # or more contributor license agreements.  See the NOTICE file
    5 # distributed with this work for additional information
    6 # regarding copyright ownership.  The SFC licenses this file
    7 # to you under the Apache License, Version 2.0 (the
    8 # "License"); you may not use this file except in compliance
    9 # with the License.  You may obtain a copy of the License at
   10 #
   11 #   http://www.apache.org/licenses/LICENSE-2.0
   12 #
   13 # Unless required by applicable law or agreed to in writing,
   14 # software distributed under the License is distributed on an
   15 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
   16 # KIND, either express or implied.  See the License for the
   17 # specific language governing permissions and limitations
   18 # under the License.
   19 
   20 module Selenium
   21   module WebDriver
   22     module DriverExtensions
   23       module HasNetworkInterception
   24         #
   25         # Intercepts requests coming from browser allowing
   26         # to either pass them through like proxy or provide
   27         # a stubbed response instead.
   28         #
   29         # @example Log requests and pass through
   30         #   driver.intercept do |request, &continue|
   31         #     puts "#{request.method} #{request.url}"
   32         #     continue.call(request)
   33         #   end
   34         #
   35         # @example Stub requests for images
   36         #   driver.intercept do |request, &continue|
   37         #     if request.url.match?(/\.png$/)
   38         #       request.url = 'https://upload.wikimedia.org/wikipedia/commons/d/d5/Selenium_Logo.png'
   39         #     end
   40         #     continue.call(request)
   41         #   end
   42         #
   43         # @example Log responses and pass through
   44         #   driver.intercept do |request, &continue|
   45         #     continue.call(request) do |response|
   46         #       puts "#{response.code} #{response.body}"
   47         #     end
   48         #   end
   49         #
   50         # @example Mutate specific response
   51         #   driver.intercept do |request, &continue|
   52         #     continue.call(request) do |response|
   53         #       response.body << 'Added by Selenium!' if request.url.include?('/myurl')
   54         #     end
   55         #   end
   56         #
   57         # @param [Proc] block which is called when request is intercepted
   58         # @yieldparam [DevTools::Request] request
   59         # @yieldparam [Proc] continue block which proceeds with the request and optionally yields response
   60         #
   61 
   62         def intercept(&block)
   63           @interceptor ||= DevTools::NetworkInterceptor.new(devtools)
   64           @interceptor.intercept(&block)
   65         end
   66       end # HasNetworkInterception
   67     end # DriverExtensions
   68   end # WebDriver
   69 end # Selenium