Skip to content

CHANGELOG.md

Latest commit

 

History

History
918 lines (751 loc) · 43.3 KB

CHANGELOG.md

File metadata and controls

918 lines (751 loc) · 43.3 KB

Unreleased

Added

Changed

Fixed

  • Full-page screenshots no longer resize the window, preventing focus steal on macOS [#580]

Removed

0.17.2 (March 23, 2026)

Added

  • Ferrum::Network::Response#body! returns body or throws error if implicable
  • Ferrum::Browser#new(dockerize: true) whether to add CLI flags to run a browser in a container, false by default
  • Initial support for RBS types [#565]

Changed

  • Ferrum::Network::Response#body returns body or nil in case of errors
  • Disable Chrome code sign clones [#555]
  • Ruby version required is >= 3.1 [#565]

Fixed

  • Proper handle wss urls, and fix session_id loss for undetermined order of CDP events [#559]
  • browser.reset tries to dispose default implicit context [#566], [#540]

Removed

0.17.1 (May 11, 2025)

Added

Changed

Fixed

  • Can't use single quotes in screenshot :selector [#465]
  • remote_debug_url for modern Chrome returns chrome-devtools-frontend.appspot.com absolute url

Removed

0.17 - (May 10, 2025)

Added

  • Ferrum::Network::Exchange#blob? determines if the exchange is blob [#516]
  • Ferrum::Network::Request#headers are enhanced and supplemented with Network.requestWillBeSentExtraInfo [#506]
  • Ferrum::Page#off to unsubscribe from CDP events [#455]
  • Ferrum::Mouse#scroll_by to be able to scroll by, as alternative to scroll_to [#514]
  • Ferrum::Network::Exchange#unknown determines if the exchange is in an unknown state, meaning that browser might not return info about it [#426]
  • Ferrum::Network::Exchange#loader_id returns loader id [#426]
  • Ferrum::Browser#debug opens headless session in the browser devtools frontend [#519]
  • Ferrum::Frame#parent returns the parent frame if this frame is nested [#523]
  • Ferrum::Frame#frame_element returns the element in which the window is embedded [#524]
  • Ferrum::Page#start_screencast starts sending frames to record screencast [#494]
  • Ferrum::Page#stop_screencast stops sending frames [#494]
  • Ferrum::Browser#new(incognito: false) whether to create an incognito profile for the browser startup window, true by default.

Changed

  • Ferrum::Network::Exchange#finished? takes into account that exchange might be in an unknown state after loader changed(next go_to call) and considers such as finished [#426]
  • headless: "new" mode is removed as it's now default in modern Chrome, just use headless: true instead [#518]

Fixed

  • Correctly set mouse events buttons property [#509]
  • Prevent 'Hash#[]=': can't add a new key into hash during iteration [#513]
  • Ferrum::Network::Exchange#finished? and Ferrum::Network#wait_for_idle take into account that request can be a blob [#496]
  • Safe call body method (DOM) when page is empty and no html [#522]

Removed

0.16 - (Dec 1, 2024)

Added

  • Ferrum::Network#wait_for_idle! raises an error if timeout reached.
  • Ferrum::Browser#close closes browser gracefully issuing a CDP command, doesn't clean up ruby resources.
  • Ferrum::Node#remove removes node from DOM tree.
  • Ferrum::Node#exists? check whether the node in ruby world still exists in the DOM tree.
  • Ferrum::Cookies#store stores all cookies of current page in a file.
  • Ferrum::Cookies#load Loads all cookies from the file and sets them for current page.
  • Ferrum::Page#screenshot supports webp image format.
  • Ferrum::Page#activate activates the target for the given page.

Changed

  • Ferrum::Network#wait_for_idle now returns true or false. Doesn't raise an error [BREAKING CHANGE].

Fixed

  • :ws_url option is now used without modifications WYSIWYG.
  • Network.requestWillBeSent callback didn't handle params in a type-safe way
  • Page.frameStoppedLoading callback shouldn't wait for document_node_id response
  • JSON::NestingError is raised when browser returns very deeply nested JSON and crashes the thread [#498]

Removed

0.15 - (Feb 17, 2024)

Added

  • Ferrum::Page#disable_javascript disables the JavaScript from the HTML source [#407]
  • Ferrum::Page#set_viewport emulates the viewport [#406]
  • Ferrum::Downloads [#416]
    • #files information about downloaded files
    • #wait wait for file download to be completed
    • #set_behavior where and whether to store file
  • Browser::Client#command accepts :async parameter [#433]
  • Ferrum::Browser introduce :flatten mode with one connection and sessions [#434]
  • Support for ping requests [#417]
  • Ferrum::Browser introduce :ws_url option to set external websocket for a browser [#435]

Changed

  • Ferrum::Page#screeshot accepts :area option [#410]
  • Resizing page on creation is gone and moved to Cuprite [#427]
  • Min Ruby version is 2.7
  • Refactored internal API of Ferrum::Browser, Ferrum::Page, Ferrum::Context, Ferrum::Contexts, Ferrum::Target instead of passing browser and making cyclic dependency on the browser instance, we pass now a thin client [#431]
  • Bump websocket-driver to ~> 0.7 [#432]
  • Got rid of Concurrent::Async in Ferrum::Browser::Subscriber [#432]
  • Ferrum::Page#set_window_bounds is renamed to Ferrum::Page#window_bounds=
  • Ferrum::Page get right client from the Target and passes it down everywhere [#433]
  • Ferrum::Network::InterceptedRequest accepts Ferrum::Browser::Client instead of Ferrum::Page [#433]
  • Ferrum::Browser::Client -> Ferrum::Client [#433]

Fixed

  • Exceptions within .on() were swallowed by a thread pool of Concurrent::Async [#432]
  • Ferrum::Context#add_target puts wrong target to pendings sometimes [#433]
  • Leaking connection descriptors in tests and after browser quit [#433]
  • Check if network exchange exists before manipulating it [#442]

Removed

0.14 - (Sep 14, 2023)

Added

  • Ferrum::Page#device_pixel_ratio returns the ratio of the resolution in physical pixels to the resolution in CSS pixels for the current display device.
  • Ferrum::Network#cache(disable: true | false) whether or not to use cache for every request
  • Ferrum::Network::Exchange#redirect? determines if the exchange is a redirect
  • Ferrum::Network::Exchange#xhr? determines if the exchange is XHR
  • Ferrum::Network::Request#xhr? determines if the request is XHR
  • Ferrum::Network::Response#loaded? returns true if the response is fully loaded
  • Ferrum::Network::Response#redirect? returns true if the response is a redirect
  • Ferrum::Node#in_viewport? checks if the element in viewport (optional argument scope as Ferrum::Node)
  • Ferrum::Node#scroll_into_view - scrolls to element if needed (when it's not in the viewport)
  • Ferrum::Cookies#each - is now Enumerable and supports each method
  • Ferrum::Cookies::Cookie
    • #priority
    • #sameparty?
    • #source_scheme
    • #source_port
    • #to_s
    • #to_h
  • Ferrum::Network::Request#to_h
  • Ferrum::Network::Response#to_h

Changed

Fixed

  • Ferrum::Network::Exchange#finished? returns true only fully loaded responses
  • Ferrum::Page#resize set deviceScaleFactor as 0 by default [#330]
  • Ferrum::Network#intercept silently discards unknown resource_types [#313]
  • Truncated Chrome WS URL results in Ferrum::DeadBrowserError [#327]
  • Websocket connection remains indefinitely in :connecting state and causes TimeoutError [#329]
  • Exchange#navigation_request? Handle nil request [#339]
  • Raise Ferrum::StatusError for any top frame navigation error [#341]
  • Ferrum::Network::Response#loaded? for redirect response [#338]

Removed

0.13 - (Nov 12, 2022)

Added

  • Ferrum::Browser::VersionInfo
  • Ferrum::Browser
    • #version requests the browser's version information.
    • #create_page(proxy: { host: "x.x.x.x", port: "8800", user: "user", password: "pa$$" }) proxy option, supports creating a page in a new context that uses proxy settings.
  • Ferrum::Page#timeout = n page supports its own timeout
  • Ferrum::Frame#execution_id returns execution context id and doesn't raises error
  • Ferrum::Frame#execution_id! returns execution context id and raises error when times out on borrowing

Changed

Fixed

  • Ferrum::Keyboard
    • #up, #down accept only one key.
  • Ferrum::Page#goto fixed undefined method url for nil:NilClass when page times out and there are pending requests.
  • Runtime.consoleAPICalled didn't show log messages
  • Ferrum::Page#subscribe_frame_detached added to clean up old frames
  • Ferrum::Proxy was hanging at the exit due to issue in Webrick
  • Ferrum::NoExecutionContextError is raised sometimes when we block on Ferrum::Page#frame_by

Removed

  • Ferrum::Browser#proxy_server
  • Ferrum::Browser.new(proxy: { server: true }) :server option.

0.12 - (Sep 13, 2022)

Added

  • Alias Ferrum::Frame#content= to Ferrum::Frame#set_content
  • Alias Ferrum::Node#propery to Ferrum::Node#[]
  • Implement Ferrum::Network#blacklist= and Ferrum::Network#whitelist=
  • Alias Ferrum::Network#blocklist= to Ferrum::Network#blacklist=
  • Alias Ferrum::Network#allowlist= to Ferrum::Network#whitelist=
  • Alias Ferrum::Page#go to Ferrum::Page#go_to
  • Ferrum::Browser#create_page accepts now new_context: true which can create a page in incognito context, and yields a block with this page, after which the page is closed.
  • Ferrum::Browser supports new option :proxy https://github.com/rubycdp/ferrum#proxy
  • Ferrum::Network::Response#params attr_reader added
  • Ferrum::Node
    • #selected checks selected options. Returns an array of Ferrum::Node that's selected.
    • #select selects options by passed attribute, default: :value.
    • #computed_style returns hash of computed styles
  • Ferrum::JavaScriptError#stack_trace attr_reader
  • Windows support
  • Show warning and accept dialog if no handler given
  • Ferrum::Cookies#set ability to set cookie using Ferrum::Cookies::Cookie object
  • Ferrum::Network#emulate_network_conditions activates emulation of network conditions
  • Ferrum::Network#offline_mode puts browser into offline mode
  • Ferrum::Page#tracing - instance of Ferrum::Page::Tracing for trace capabilities.
  • Ferrum::Page::Tracing#record(&block) start/stop tracing for steps provided in passed block

Changed

  • Use Concurrent::MVar as execution_id in Ferrum::Frame
  • Min Ruby version is 2.6 and 3.0 is supported
  • Ferrum::Page#bypass_csp accepts hash as argument enabled: true by default
  • Ferrum::Context#has_target? -> Ferrum::Context#target?
  • We now start looking for Chrome first instead of Chromium, the order for checking binaries has changed
  • Multiple methods are moved into Utils:
    • Ferrum.with_attempts -> Ferrum::Utils::Attempt.with_retry
    • Ferrum.started -> Ferrum::Utils::ElapsedTime.start
    • Ferrum.elapsed_time -> Ferrum::Utils::ElapsedTime.elapsed_time
    • Ferrum.monotonic_time -> Ferrum::Utils::ElapsedTime.monotonic_time
    • Ferrum.timeout? -> Ferrum::Utils::ElapsedTime.timeout?
    • Ferrum.windows? -> Ferrum::Utils::Platform.windows?
    • Ferrum.mac? -> Ferrum::Utils::Platform.mac?
    • Ferrum.mri? -> Ferrum::Utils::Platform.mri?

Fixed

  • Ferrum::Node#selected, Ferrum::Node#select to work in frame scope

Removed

0.11 - (Mar 11, 2021)

Added

  • Ferrum::CoordinatesNotFoundError
  • Ferrum::Node
    • #wait_for_stop_moving wait for any js or css movements to finish
    • #moving? shows if node is moving
    • #focusable? if node can have focus
  • Ferrum::Page
    • #playback_rate shows the rate
    • #playback_rate= control css animation speed
    • position get window position
    • position= set window position
  • Ferrum::Browser#evaluate_on_new_document evaluate js on every new document
  • --no-startup-window flag to Chrome by default

Changed

  • Ferrum::NodeIsMovingError -> Ferrum::NodeMovingError
  • Ferrum::Node::MOVING_WAIT -> Ferrum::Node::MOVING_WAIT_DELAY
  • Ferrum::Node::MOVING_ATTEMPTS -> Ferrum::Node::MOVING_WAIT_ATTEMPTS
  • Concurrent::Hash -> Concurrent::Map in contexts

Fixed

  • Typo Ferrum::Page::Screenshot::PAPEP_FORMATS -> Ferrum::Page::Screenshot::PAPER_FORMATS

Removed

0.10.2 - (Feb 24, 2021)

Added

Changed

Fixed

  • Set Ferrum::Page @event when setting up main frame

Removed

0.10.1 - (Feb 24, 2021)

Added

Changed

Fixed

  • Don't mutate options in Ferrum::Frame::Runtime#call

Removed

0.10 - (Feb 23, 2021)

Added

  • Added alias go_to for goto
  • Introduce Ferrum::Browser option :pending_connection_errors
  • You can pass background to screenshot method browser.screenshot(background_color: Ferrum::RGBA.new(0, 0, 0, 0.0))
  • Ferrum::StatusError#pendings attr_reader added
  • Ferrum::ProcessTimeoutError#output attr_reader added
  • Ferrum::Page#mhtml

Changed

  • Ferrum::Browser::Process::PROCESS_TIMEOUT is 2 -> 10 by default
  • Ferrum::Browser::Network#authorize now accepts block
  • Ferrum::Page#pdf method now streams file with transferMode: "ReturnAsStream" mode good for large files

Fixed

  • execution_id in Runtime is called with retry
  • Main frame is set correct under some circumstances
  • Network.loadingFailed event is added to catch canceled requests
  • detectCycle for cyclic JS objects
  • Fall back to JS when finding element position with get_content_quads
  • Temporary user-data-dir is removed after Ferrum::Browser::Process#stop

Removed

0.9 - (Jul 24, 2020)

Added

  • Ferrum::NodeIsMovingError to raise error when node is moving before clicking
  • FERRUM_NODE_MOVING_WAIT and FERRUM_NODE_MOVING_ATTEMPTS envs are added to wait until node stops moving with at least n attempts
  • Ferrum::Page#wait_for_reload waits until page is reloaded
  • :ignore_default_browser_options option is added to Ferrum::Browser to exclude Ferrum's defaults
  • XVFB support
  • Ferrum::Runtime::CyclicObject is returned when JS object cannot be represented in Ruby
  • FERRUM_LOGGING_SCREENSHOTS env is added to skip showing Base64 screenshots in logger

Changed

Fixed

  • Ferrum::Network::Request#respond can accept content longer than 45 chars
  • Ferrum::Browser::Subscriber is thread safe

Removed

0.8 - (Apr 7, 2020)

Added

  • Ferrum::Frame supports looking up nodes inside frame with methods:
    • #at_css
    • #css
    • #at_xpath
    • #xpath
  • Ferrum::Page#set_content can be used to set the content of the page
  • :ws_max_receive_size option is added to Ferrum::Browser
  • Ferrum::ProcessTimeoutError error instead of RuntimeError
  • Ferrum::Page#stop to stop loading page

Changed

  • Fix Ruby 2.7 warnings
  • Ferrum::Node#click accepts offset: { :x, :y, :position (:top | :center) and :delay options
  • Instantiate empty main frame in advance
  • Ferrum::Mouse#move supports steps as option :steps
  • Delegatecurrent_title to page
  • Ferrum::Browser::Cookies#set supports :httponly and :samesite options

Fixed

  • Ferrum::Frame#execution_id should be set only once
  • Ferrum::Page#doctype can be nil
  • Add :slowmoable option to all methods with visual representation
  • Ferrum::Page#screenshot works for html tag set with 100% width and height

Removed

  • .ruby-version file from repository

0.7 - (Jan 28, 2020)

Fixed

  • Fix issue when connection is refused and shows up as pending
  • Can set Accept-Language even if User-Agent is not provided

Added

  • FERRUM_GOTO_WAIT env is added with default value of 0.1
  • Ferrum::Network::Response#type shows type of the response
  • Ferrum::Network
    • #wait_for_idle wait for network idle
    • idle? shows if there are no connections
    • total_connections shows total number of connections
    • finished_connections shows a number of closed connections
    • pending_connections shows a number of opened connections
  • Ferrum::Network::Exchange
    • #intercepted_request attr accessor for intercepted request if any
    • #blank? shows if request is absent
    • #finished? returns true if request blocked or response is given
    • #pending? shows if exchange is still waiting response
  • Ferrum::Network::InterceptedRequest
    • #status? one of responded|continued|aborted
  • Initial support for Firefox
  • Dedicated queue for request interruptions
  • Ferrum::Browser
    • accepts :extensions option with :source key which can have js text to be executed when page is opened
    • #bypass_csp can now bypass csp headers when injecting scripts

Changed

  • Ferrum::StatusError#pendings now shows all pending connections when time is out
  • Ferrum::Browser::Process#path is delegated to Command

Fixed

Removed

  • Stop listening to Page.domContentEventFired, Page.frameScheduledNavigation and Page.frameClearedScheduledNavigation events

0.6.2 - (Oct 30, 2019)

Added

  • Ferrum::Target:
    • #page= attribute writer
    • #maybe_sleep_if_new_window - sleep with Ferrum::Target::NEW_WINDOW_WAIT seconds by Ferrum::Target#window? condition

Changed

Fixed

Removed

0.6.1 - (Oct 30, 2019)

Added

  • Ferrum::Frame#execution_id? - boolean of equals passed argument execution_id and current execution_id from current class instance

Changed

  • Ferrum::Page::Frames - fix missing frame:
    • #frame_by - optional argument execution_id removed with change subscriber to search by Ferrum::Frame#execution_id?

Fixed

Removed

0.6.0 - (Oct 29, 2019)

Added

  • description of browser.add_script_tag/browser.add_style_tag in README
  • Ferrum::Target#attached? - boolean of the check the exists of Ferrum::Target#page
  • Ferrum::Page::Screenshot::DEFAULT_PDF_OPTIONS - pdf settings constant
  • Ferrum::Page::Screenshot::PAPER_FORMATS - available formats constant
  • Ferrum::Page::Frames module implementation:
    • #main_frame - attribute reader as new instance of Ferrum::Frame created by Runtime.executionContextCreated.context.auxData.frameId
    • #frames - results of delegated #values method into instance variable frames
    • #frame_by - searching method by attributes: id, execution_id, name (optional)
    • #frames_subscribe - apply listeners of 'Page/Network/Runtime' streams of the frame-related events
  • Ferrum::Browser#add_script_tag - delegation to Ferrum::Page#add_script_tag
  • Ferrum::Browser#add_style_tag - delegation to Ferrum::Page#add_style_tag
  • Ferrum::Network::AuthRequest class implementation:
    • initializer accepts two arguments:
    • page as first - instance of Ferrum::Page
    • params as second - params from on subscriber "Fetch.authRequired"
    • #navigation_request? - delegation to isNavigationRequest of passed to instance params
    • #auth_challenge? - strict equal of source as argument with delegation to authChallenge.source of passed to instance params
    • #match? - boolean match of regexp as argument with #url
    • #continue - fires the command Fetch.continueWithAuth on Ferrum::Page instance with passed options as argument
    • #abort - fires the command Fetch.failRequest on Ferrum::Page instance with errorReason: "BlockedByClient" on current requestId
    • #url - delegation to request.url of passed to instance params
    • #method - delegation to request.method of passed to instance params
    • #headers - delegation to request.headers of passed to instance params
    • #initial_priority - delegation to request.initialPriority of passed to instance params
    • #referrer_policy - delegation to request.referrerPolicy of passed to instance params
    • #inspect - simple implementation of native inspect method with returns of the current internal state

Changed

  • Ferrum::Page::Screenshot#screenshot - handle :full option
  • Ferrum::Page::Frame into Ferrum::Frame:
    • initializer accepts three arguments:
    • id as first - value of Page.frameAttached.frameId
    • page as second - instance of Ferrum::Page
    • parent_id as third - with nil as default value
    • Ferrum::Page::Frame#name/Ferrum::Page::Frame#name= - class attribute accessor
    • Ferrum::Page::Frame#state= - attribute writer for state instance variable, can be started_loading | navigated | scheduled_navigation | cleared_scheduled_navigation | stopped_loading
    • Ferrum::Page::Frame#main? - boolean of the check the not existed parent_id instance variable
    • Ferrum::Page::Frame#execution_context_id converted into Ferrum::Frame#execution_id with use execution_id instance variable
    • Ferrum::Page::Frame#frame_url into Ferrum::Frame#url - 'document.location.href' reference
    • Ferrum::Page::Frame#frame_title into Ferrum::Frame#title - 'document.title' reference
    • Ferrum::Page::Frame#inspect - simple implementation of native inspect method with returns of the current internal state
  • Ferrum::Page::DOM into Ferrum::Frame::DOM:
    • Ferrum::Page::DOM#title renamed into Ferrum::Frame::DOM#current_title
    • Ferrum::Frame::DOM#doctype - serialized 'document.doctype' reference
    • Ferrum::Frame::DOM#css/Ferrum::Frame::DOM#at_css - added @page references for command related methods
  • Ferrum::Page::Runtime into Ferrum::Frame::Runtime:
    • Ferrum::Frame::DOM#evaluate_on - added @page references for command related methods
    • Ferrum::Frame::SCRIPT_SRC_TAG - js implementation for: createElement <script>, fil in src with appendChild into document.head
    • Ferrum::Frame::SCRIPT_TEXT_TAG - js implementation for: createElement <script>, fil in text with appendChild into document.head
    • Ferrum::Frame::STYLE_TAG - js implementation for: createElement <style> with appendChild into document.head
    • Ferrum::Frame::LINK_TAG - js implementation for: createElement , fil in href with appendChild into document.head
    • Ferrum::Frame::Runtime#add_script_tag - fires evaluate_async with passed args: url, path, content, type: "text/javascript"
    • Ferrum::Frame::Runtime#add_style_tag - fires evaluate_async with passed args: url, path, content
  • Ferrum::Network - switch from deprecated Network.continueInterceptedRequest to Fetch.continueRequest
  • Ferrum::Network::Exchange:
    • first argument page for initialize with fill page instance variable
    • #build_response - fix arguments for Network::Response.new
    • #inspect - simple implementation of native inspect method with returns of the current internal state
  • Ferrum::Network::InterceptedRequest:
    • #interception_id into #request_id as requestId reference on passed params
    • #respond - the custom request fulfilment support implementation by fires the command Fetch.failRequest on Ferrum::Page instance with passed options as argument
  • Ferrum::Network::Response:
    • first argument page for initialize with fill page instance variable
    • #body - implementation of ability to get response body by fires the command Network.getResponseBody on Ferrum::Page instance with on specific requestId
    • #main? - boolean of equals page.network.response and current class instance
    • #== - boolean of equals passed argument object.id and current requestId from params instance variable
    • #inspect - simple implementation of native inspect method with returns of the current internal state
  • Ferrum::Node:
    • replaced first argument page into frame / page instance variable initialized as frame.page
    • #frame_id - delegation to frameId of passed to instance description
    • #frame - instance of frame from page instance found by #frame_id
  • Ferrum::Page::Event - add frames implementation:
    • event/document_id attribute readers
    • #subscribe listeners replaced with #frames_subscribe from included Ferrum::Page::Frames instance
    • #resize - evaluate JS: document.documentElement.scrollWidth, document.documentElement.scrollHeight for fullscreen case

Fixed

Removed

  • Ferrum::Page
    • #frame_name
    • #frame_url, with delegated Ferrum::Browser#frame_url
    • #frame_title, with delegated Ferrum::Browser#frame_title
    • #within_frame, with delegated Ferrum::Browser#within_frame
  • Ferrum::Page::Event:
    • include DOM, Runtime, Frame
    • waiting_frames instance variable
    • frame_stack instance variable

0.5.0 - (Sep 27, 2019)

Added

  • description of Thread safety approach section in README
  • Ferrum::NoSuchTargetError
  • Ferrum::Network::Request#url_fragment - delegation to urlFragment of instance request
  • The removing of temporary directory on Ferrum::Browser::Process#stop: Ferrum::Browser::Process.directory_remover proc for remove entry with the passed path to the temporary directory as an argument
  • Ferrum::Page#viewport_size - evaluates JS: innerWidth and innerHeight values on window object
  • Ferrum::Page#document_size - evaluates JS: offsetWidth and offsetHeight values on document.documentElement object
  • Ferrum::Browser#viewport_size - delegation to Ferrum::Page#viewport_size
  • Ferrum::Context class implementation:
    • initializer accepts three arguments:
    • browser as first - instance of Ferrum::Browser
    • contexts as second - instance of Ferrum::Contexts
    • id as third - the value of browser command: Target.createBrowserContext.browserContextId
    • includes id attribute reader - the passed argument: id
    • includes targets attribute reader - the thread safe instance of hash
    • includes pendings attribute reader - the thread safe instance of mutable variable
    • includes POSITION constant - the freeze array of first last symbols
    • #default_target - memoization of #create_target result
    • #create_target - assigns target.id as fetch of targetId from Target.createTarget with assign target from targetInfo
    • #page - delegation to default_target of Ferrum::Context
    • #pages - delegations to page's taken from Ferrum::Context#targets as values
    • #windows - delegations to page's taken from Ferrum::Context#targets as values with window? truthy condition takes position as first argument and optional second argument size with 1 as default value may raise ArgumentError on the passed position which not included into Ferrum::Context::POSITION constant values
    • #create_page - delegation to target with the target recreation by Ferrum::Context#create_target
    • #add_target - creates new instance of Ferrum::Target with fill by Ferrum::Target.window? condition of: targets instance variable on id or pendings instance variable as replace of @value
    • #update_target - updates specific target in targets instance variable by target_id and params which are passed as arguments
    • #delete_target - deletes from targets instance variable by passed target_id as argument
    • #dispose - disposes from contexts instance variable by passed id as attribute reader
    • #inspect - simple implementation of native inspect method with returns of the current internal state
  • Ferrum::Target class implementation:
    • initializer accepts two arguments:
    • browser as first - instance of Ferrum::Browser
    • params as second (optional) - instance of Ferrum::Contexts
    • #update - attribute writer for params instance variable by passed params as one argument
    • #page - new instance of Ferrum::Page created for specific targetId
    • #window? - boolean of the check the exists of Ferrum::Target#opener_id
    • #id - delegation to targetId of passed to instance params
    • #type - delegation to type of passed to instance params
    • #title - delegation to title of passed to instance params
    • #url - delegation to url of passed to instance params
    • #opener_id - delegation to openerId of passed to instance params
    • #context_id - delegation to browserContextId of passed to instance params
  • Ferrum::Contexts class implementation: (subscriber on Target.targetCreated)
    • initializer accepts browser as the one argument
    • includes contexts attribute reader - the thread safe instance of hash
    • #default_context - memoization of #create result
    • #find_by - finding the last match in contexts instance variable by match of passed target_id into targets.keys required target_id: value argument returns nil on the not-matched case
    • #create - assigns new instance of Ferrum::Context with fetched browserContextId from Target.createBrowserContext into contexts instance variable returns the created instance of Ferrum::Context
    • #dispose - removes specific context from contexts instance variable by passed context_id with fires Target.disposeBrowserContext browser command returns true boolean on the success dispose
    • #reset - nullify the default_context instance variable and fires the dispose method on each context in contexts instance variable
  • Ferrum::Browser#contexts - reader of Ferrum::Contexts instance:
  • Ferrum::Browser#default_context - delegation to Ferrum::Browser#contexts
  • the delegation to Ferrum::Browser#default_context:
    • Ferrum::Browser#create_target
    • Ferrum::Browser#create_page
    • Ferrum::Browser#pages
    • Ferrum::Browser#windows

Changed

  • Ferrum::NoSuchWindowError into NoSuchPageError
  • Ferrum::Page::NEW_WINDOW_WAIT moved as unchanged to Ferrum::Target
  • Ferrum::Browser#page - the delegation from Ferrum::Browser#targets to Ferrum::Browser#default_context
  • Ferrum::Browser#page - from the instance of Ferrum::Browser#targets into delegation to Ferrum::Browser#default_context

Fixed

Removed

  • Ferrum::EmptyTargetsError the hack to handle new window which doesn't have events at all by Ferrum::Page#session_id with Target.attachToTarget and Target.detachFromTarget usage
  • Ferrum::Page#close_connection - the logic is moved to Ferrum::Page#close directly
  • the third argument (new_window = false) for Ferrum::Page initializer
  • Ferrum::Targets class with the delegations to Ferrum::Targets instance in Ferrum::Browser instance:
    • Ferrum::Browser#window_handle
    • Ferrum::Browser#window_handles
    • Ferrum::Browser#switch_to_window
    • Ferrum::Browser#open_new_window
    • Ferrum::Browser#close_window
    • Ferrum::Browser#within_window

0.4.0 - (Sep 17, 2019)

Added

  • Ferrum::Network module - moved logic from Ferrum::Page::Net with addition changes
  • Ferrum::Browser#network - instance of Ferrum::Network from delegated Ferrum::Page instance
  • Ferrum::Network#request & Ferrum::Network#response - delegation to Network::Exchange instance
  • Ferrum::Network#first_by / Ferrum::Network#last_by - implemented searching by passed request_id in Network::Exchange instance
  • Ferrum::Browser#traffic delegation to Ferrum::Network of Network::Exchange instances
  • Ferrum::Network::Exchange - simple request/response constructor with monitoring
    • #build_request - instance of Network::Request with passed params
    • #build_response - instance of Network::Response with passed params
    • #build_error - instance of Network::Error with passed params
    • #navigation_request? - the request verification on document by passed frame_id
    • #blocked? - boolean which becomes true when no the constructed response
    • #to_a - returns array of constructed request/response/error instances
  • Ferrum::Network::Request#type - delegation to type of passed to instance params
  • Ferrum::Network::Request#type? - boolean compare with type of instance with passed type as argument
  • Ferrum::Network::Request#frame_id - delegation to frameId of passed to instance params
  • Ferrum::Network::InterceptedRequest#abort - fires continue method of instance with errorReason as Aborted
  • Ferrum::Network::InterceptedRequest#inspect - simple implementation of native inspect method with returns of the current internal state
  • Ferrum::Page::Frame#frame_id - reader to public available of frameId by Ferrum::Page#frame_id

Changed

  • description of Network/Authorization/Interception sections in README
  • Ferrum::Browser#screenshot & Ferrum::Browser#pdf methods are returns bin when no path is given
  • Ferrum::Browser#status delegated to Ferrum::Network
  • Ferrum::Browser#authorize delegated to Ferrum::Network
  • Ferrum::Network module into class approach for InterceptedRequest/Request/Response/Error classes
  • Ferrum::Browser#intercept_request into Ferrum::Network#intercept
  • Ferrum::Browser#subscribe into Ferrum::Network#subscribe with public available
  • Ferrum::Browser#authorized_response into Ferrum::Network#authorized_response with public available
  • Ferrum::Browser#clear_memory_cache & Ferrum::Browser#clear_network_traffic merged to Ferrum::Network#clear with addition of traffic clear by the argument as symbol type of traffic/cache
  • Ferrum::Network::Request#time - use wallTime params fir time detection
  • body_size attribute writer of Ferrum::Network::Response with reduce of size on headers_size to handle encodedDataLength when Network.responseReceived is not dispatched

Fixed

Removed

  • Ferrum::Network::Response#redirect_url
  • Ferrum::Page::Net
  • Ferrum::Browser#abort_request
  • Ferrum::Browser#continue_request
  • Ferrum::Browser#response_headers
  • Ferrum::Browser#network_traffic
  • Ferrum::Network::InterceptedRequest#is_navigation_request= (attribute writer)

0.3.0 - (Sep 12, 2019)

Added

  • CI build by TravisCI for ruby versions: 2.3/2.4/2.5/2.6/jruby-9.2.8.0
  • fix specs with support of MacOS time formats
  • Ferrum::Mouse::CLICK_WAIT as FERRUM_CLICK_WAIT ENV-var with 0.1 as default value
  • Ferrum::Browser#authorize option :type with valid values :server (by default), :proxy
  • Logo 🎉
  • Ferrum::Node#inner_text - evaluates JS: this.innerText on Node instance
  • Ferrum::Page::Runtime::INTERMITTENT_ATTEMPTS as FERRUM_INTERMITTENT_ATTEMPTS ENV-var with 6 as default value
  • Ferrum::Page::Runtime::INTERMITTENT_SLEEP as FERRUM_INTERMITTENT_SLEEP ENV-var with 0.1 as default value
  • Ferrum::Page#on getting the name as option with :dialog/:request_intercepted cases & block as last argument
  • Ferrum::Browser#on - delegated actions to Ferrum::Page instance
  • Ferrum::Dialog object to handle JavaScript Dialog's
    • required page, params as init arguments
    • #accept fires JS: Page.handleJavaScriptDialog as command on provided Ferrum::Page instance with options which included accept: true
    • #dismiss fires JS: Page.handleJavaScriptDialog as command on provided Ferrum::Page instance with accept: false
    • #match? compare message by passed regexp
    • description of Dialog feature in README
  • Ferrum::Page::Event extend of Concurrent::Event with implementation of reset/wait fix
    • implement Ferrum::Page::Event#iteration to reuse synchronize block on @iteration value of Concurrent::Event
    • redefinition of Concurrent::Event#reset - increase @iteration outside of if @set block
  • FERRUM_PROCESS_TIMEOUT ENV-var as Ferrum::Browser::Process::PROCESS_TIMEOUT with 2 as default value
  • Elapsed time implementation:
    • Ferrum::Browser::Process::WAIT_KILLED with 0.05
    • Ferrum.monotonic_time - delegation to Concurrent object
    • Ferrum.started - class variable @@started as monotonic_time
    • Ferrum.elapsed_time - a difference of monotonic_time as minuend and passed time as argument or @@started as subtrahend
    • Ferrum.timeout? - boolean compare passed values (start, timeout) by elapsed_time
  • JRuby support by replaces of ::Process::CLOCK_MONOTONIC usages according to Elapsed-time implementation

Changed

  • fix globally changing of Thread behaviour on options abort_on_exception/report_on_exception
  • Ferrum::Page::Input#find_position into Ferrum::Node#find_position
  • Ferrum::Browser#scroll_to into Ferrum::Mouse#scroll_to
  • option :timeout into :wait for Ferrum::Page#command / Ferrum::Mouse#click
  • description of Authorization options in README
  • Ferrum::Page::Net#intercept_request block as last argument into Ferrum::Page::Net#on(:request_intercepted) with passed block
  • Ferrum::Browser::TIMEOUT into Ferrum::Browser::DEFAULT_TIMEOUT as FERRUM_DEFAULT_TIMEOUT ENV-var with 5 as default value
  • usage of Concurrent::Event into Ferrum::Page::Event as @event of Ferrum::Page instance
  • Ferrum::Page::NEW_WINDOW_BUG_SLEEP into Ferrum::Page::NEW_WINDOW_WAIT as FERRUM_NEW_WINDOW_WAIT ENV-var with 0.3 as default value

Fixed

Removed

  • Ferrum::Page::Input
  • Ferrum::Browser#proxy_authorize / Ferrum::Page::Net#proxy_authorize
  • Ferrum::ModalNotFoundError
  • Ferrum::Page#reset_modals with delegation to Ferrum::Browser
  • Ferrum::Page#find_modal with delegation to Ferrum::Browser
  • Ferrum::Page#accept_prompt with delegation to Ferrum::Browser
  • Ferrum::Page#dismiss_confirm with delegation to Ferrum::Browser
  • Ferrum::Page#accept_confirm with delegation to Ferrum::Browser
  • Ferrum::Browser#on_request_intercepted

0.2.1 - (Sep 5, 2019)

Added

  • handle EOFError/Errno::ECONNRESET/Errno::EPIPE errors with rescue
  • description options of Customization in README

Changed

  • increased Browser::Process::PROCESS_TIMEOUT constant by 1
  • Ferrum::Network::InterceptedRequest#match? to handle cases for Ruby 2.3 and less

Fixed

Removed

0.2.0 - (Sep 3, 2019)

Added

  • snippet examples of the actions in README
  • Ferrum::Node#focus - fires the command DOM.focus on Ferrum::Page instance
  • Ferrum::Node#blur - evaluates JS: this.blur() on Ferrum::Page instance
  • Ferrum::Node#click - fires the native click on Ferrum::Page instance
  • usage of FERRUM_INTERMITTENT_ATTEMPTS ENV-var on the rescue of runtime intermittent error
  • implementation's of Ferrum::Page::DOM#xpath & Ferrum::Page::DOM#at_xpath
  • Ferrum.with_attempts - retry attempt with the sleep on the block passed as an argument
  • Ferrum::NoExecutionContextError - raises when there's no context available
  • Ferrum::Node#attribute - evaluates JS: this.getAttribute with passed name
  • Ferrum::Mouse - dedicated class of mouse actions: click/down/up/move
  • Ferrum::Browser#mouse - delegated actions to Ferrum::Mouse instance extracted from Ferrum::Page::Input
  • Ferrum::Page::Input#find_position - usage of DOM.getContentQuads to find position of node by top/left
  • Ferrum::Keyboard - dedicated class of keyboard actions: down/up/type/modifiers
  • Ferrum::Browser#keyboard - delegated actions to Ferrum::Keyboard instance extracted from Ferrum::Page::Input
  • Ferrum::Headers dedicated class of headers manager with get/set/clear/add actions which delegated to Ferrum::Page instance
  • Ferrum::Cookies dedicated class which includes logic from Ferrum::Browser::API::Cookie & Ferrum::Cookie with actions: all/[]/set/remove/clear
  • Ferrum::Page#cookies - delegated actions to Ferrum::Cookies instance
  • Ferrum::Page::Screenshot module with methods screenshot/pdf implemented by commands Page.captureScreenshot/Page.printToPDF
  • Ferrum::Browser#screenshot - delegated actions to Page::Screenshot module
  • Ferrum::Network::InterceptedRequest
    • auth_challenge?
    • match?
    • abort
    • continue
    • url
    • method
    • headers
    • initial_priority
    • referrer_policy
  • Ferrum::Browser#intercept_request - method with delegated to Ferrum::Page::Net which sets pattern into Network.setRequestInterception
  • Ferrum::Browser#on_request_intercepted - method with delegated to Ferrum::Page::Net which applies passed block
  • Ferrum::Browser#abort_request - method with delegated to Ferrum::Page::Net which stops request by passed interception_id

Changed

  • Ferrum::Page::Input#send_keys into Ferrum::Page::Input#type
  • Ferrum::DeadBrowser into Ferrum::DeadBrowserError
  • Ferrum::ModalNotFound into Ferrum::ModalNotFoundError
  • Ferrum::StatusFailError into Ferrum::StatusError
  • Ferrum::NodeError into Ferrum::NodeNotFoundError
  • Ferrum::Page#go_back into Ferrum::Page#back
  • Ferrum::Page#go_forward into Ferrum::Page#forward
  • Ferrum::Page::Dom#property into Ferrum::Page#property
  • Ferrum::Page::Dom#select_file into Ferrum::Page#select_file
  • Ferrum::Node::#click getting the mode argument as option with right/double/left cases
  • Ferrum::Page::Frame#switch_to_frame into Ferrum::Page::Frame#within_frame with added case of ArgumentError

Fixed

Removed

  • Ferrum::ObsoleteNode error
  • Ferrum::FrameNotFound error
  • Ferrum::Page::Input#set
    • #set
    • #select
    • #type
    • #generate_modifiers
  • Ferrum::Node
    • #attributes
    • #[]
    • #select_option
    • #unselect_option
    • #visible?
    • #checked?
    • #selected?
    • #disabled?
    • #path
    • #right_click
    • #double_click
  • Ferrum::Browser::API - Header, Cookie, Screenshot, Intercept
  • Ferrum::Browser
    • #set_overrides
    • #url_whitelist
    • #url_blacklist

0.1.2 - (Aug 27, 2019)

Added

  • catch of the intermittent errors inside of evaluate's methods
  • Ferrum::Page::Runtime#evaluate_on - fires Runtime.callFunctionOn command with functionDeclaration on Ferrum::Page

Changed

Fixed

Removed

  • Ferrum::Page::Runtime#evaluate_in

0.1.1 - (Aug 26, 2019)

Added

  • stringify the url which passed to Ferrum::Page#goto

Changed

Fixed

Removed

0.1.0 - (Aug 26, 2019)

Added

  • fires the Ferrum::NodeError on zero of node_id

Changed

  • basic description in README

Fixed

Removed

0.1.0.alpha - (Aug 2, 2019)

Added

  • Initial implementation
    • Ferrum
    • Ferrum::Network - simple requests/responses data store
    • Ferrum::Browser - basic command interface
    • Ferrum::Cookie - simple store of the cookie attributes
    • Ferrum::Node - abstract level of DOM-node with basic methods
    • Ferrum::Page - basic object of the command references, which included DOM, network and browser logic
    • Ferrum::Targets - initialize of the window manager with a clean browser state
    • classes of errors with a description of specific reason

Changed

Fixed

Removed