CHANGELOG.md

1.3.1 (2025-03-12)

Fix

• remove unnecessary encoding from screenshot response data

1.3.0 (2025-03-12)

Feat

• add method to retrieve screenshot as base64 encoded string

1.2.4 (2025-03-11)

Fix

• refactor Chrome constructor to use Optional for parameters

1.2.3 (2025-03-11)

Fix

• refactor proxy configuration retrieval for cleaner code flow

1.2.2 (2025-03-10)

Fix

• Get file extension from file path and changes use of reserved word 'format' to 'fmt'

1.2.1 (2025-03-09)

Fix

• resolve issue #29 where browser path was not found on macOS
• Quickstart code given in README is wrong

1.2.0 (2025-02-11)

Feat

• add close method and command to Page class functionality

1.1.0 (2025-02-11)

Feat

• add method to retrieve Page instance by its ID in Browser class

1.0.1 (2025-02-10)

Fix

• add dialog property to ConnectionHandler and manage dialog state

1.0.0 (2025-02-05)

BREAKING CHANGE

• now you'll have to use By.CSS_SELECTOR instead of By.CSS

Feat

• refactor import and export statements for better readability
• update changelog for version 0.7.0 and fix dependency versions
• add ping method to ConnectionHandler for browser connectivity check
• add tests for BrowserCommands in test_browser_commands.py

Fix

• add initial module files for commands, connection, events, and mixins
• add connection port parameter to Chrome browser initialization
• use deepcopy for templates to prevent mutation issues

Refactor

• rename constant CSS to CSS_SELECTOR
• add command imports and remove obsolete connection handler code
• refactor methods to be static in ConnectionHandler class
• refactor proxy configuration and cleanup logic in Browser class
• refactor ConnectionHandler to improve WebSocket management logic
• refactor Browser class initialization for better clarity and structure
• refactor Browser initialization to enhance flexibility and defaults
• refactor import statement for ConnectionHandler module
• refactor import paths for ConnectionHandler in browser modules
• implement ConnectionHandler for WebSocket browser automation
• implement command and event management for asynchronous processing
• remove unnecessary logging for WebSocket address fetching
• refactor Chrome class to use BrowserOptionsManager for path validation
• implement proxy and browser management in the new managers module
• refactor Browser class to use manager classes for better structure
• refactor DOM command scripts for clarity and efficiency

0.7.0 (2024-12-09)

Feat

• autoremove dialog from connection_handler when closed
• add handle_dialog method to PageCommands class
• add dialog handling methods to Page class
• add support for handling JavaScript dialog opening events
• refactor network response handling for base64 encoding support
• add clipping option for screenshots and implement element capture

Fix

• index error on method get_dialog_message
• update screenshot format from 'jpg' to 'jpeg' for consistency
• handle potential IndexError when retrieving valid page targetId
• filter valid pages using URL condition instead of title check

Refactor

• run ruff formatter to ensure code consistency
• run ruff formatter to ensure code consistency
• change screenshot format from PNG to JPG in commands and element

0.6.0 (2024-11-18)

Feat

• add callback ID handling for page load events in Page class
• update event registration to return callback IDs and add removal
• refactor DOM commands to use object_id instead of node_id

Fix

• refactor page navigation and loading logic for efficiency
• add page reload after navigating to a new URL in Page class
• refactor URL navigation to use evaluate_script for efficiency
• implement page refresh on URL unchanged and add navigation event
• update object ID reference in Page class for clarity
• refactor element search logic to simplify error handling
• DomCommands using object_id instead of node_id to prevent bugs
• handle OSError when cleaning up temporary directories in Browser

Refactor

• change error log to warning for missing callback ID
• refactor DOM command scripts for improved readability and reuse
• rename methods for clarity and consistency in WebElement class
• refactor parameter names for consistency in target methods
• normalize variable naming for consistency in fetch commands

0.5.1 (2024-11-12)

Fix

• simplify outer HTML retrieval for consistent object handling
• refactor click method to check option tag earlier in flow
• refactor bounding box retrieval to access nested response value
• handle KeyError instead of IndexError for element bounds retrieval
• enhance DOM command methods and rename for clarity and consistency
• add JavaScript bounding box retrieval for web elements
• remove redundant top-checks for element clicks in WebElement

0.5.0 (2024-11-11)

Feat

• add method to generate command for calling a function on an object
• implement script execution and visibility checks in click method
• add JavaScript functions for element visibility and interaction

Refactor

• enhance exception classes with descriptive error messages
• simplify command creation by using RuntimeCommands.evaluate_script
• refactor JavaScript execution and introduce runtime commands

0.4.4 (2024-11-11)

Fix

• remove redundant DOM content loaded event handling logic

0.4.3 (2024-11-11)

Fix

• rename event variables for clarity and improve timeout handling

Refactor

• remove debug print statement from connection event handling

0.4.2 (2024-11-11)

Fix

• update event handling to use DOM_CONTENT_LOADED for page load
• convert Browser context management to async methods

Refactor

• fix string formatting in logger info message for clarity

0.4.1 (2024-11-08)

Fix

• fixes workflow removing unnecessary hifen
• reduce sleep duration in key press handling for improved speed

0.4.0 (2024-11-08)

Feat

• add type_keys method for realistic key input simulation

0.3.1 (2024-11-08)

Fix

• addning new package version
• removing encode utf8 in get_pdf_base64

0.3.0 (2024-11-08)

Feat

• set_download_path added in browser class methods

0.2.0 (2024-11-08)

Feat

• dynamic lib version using pyproject

0.1.1 (2024-11-07)

Fix

• ensure browser process terminates after executing close command

0.1.0 (2024-11-07)

Feat

• add method to delete all cookies from the browser session
• add is_enabled property to check element's enabled status
• add option to raise exception in wait_element method
• add method to set browser download path via command
• refactor text extraction using BeautifulSoup for accuracy
• add method to get properties and improve XPath handling
• refactor text retrieval methods and improve code readability
• add timeout parameter to page navigation and loading methods
• add cookie management and scroll into view functionality
• add method to retrieve page PDF data as base64 string
• add async property to retrieve inner HTML of the element
• add async page_source property to retrieve page source code
• add async property to retrieve the current page URL
• add method to find multiple DOM elements using selectors
• refactor WebElement to use FindElementsMixin for clarity
• add FindElementsMixin for asynchronous DOM element handling
• add methods to retrieve network response bodies from logs
• add method to retrieve matching network logs from the page
• add cookie management methods to the Browser class
• add ElementNotFound exception to handle missing elements
• add value property and handle option tag clicks in WebElement
• rename FIND_ELEMENT_XPATH_TEMPLATE to EVALUATE_TEMPLATE
• add exception handling for element not found in find_element method
• downgrade Python version requirement to 3.10 in pyproject.toml
• add async function to fetch browser WebSocket address
• simplify text input handling by using insert_text command
• add TargetCommands class for managing target operations
• add method to generate command for disabling the Page domain
• add method to generate text insertion commands for inputs
• add Page class to manage browser page interactions and events
• add page management methods to the Browser class
• add detailed logging for command responses and event handling
• add event classes for browser, DOM, fetch, and network actions
• add NetworkCommands class for managing network operations
• implement fetch command methods for handling requests and responses
• add method to enable DOM domain events in DomCommands class
• add proxy configuration and fetch event handling to Browser
• refactor connection errors to use custom exceptions for clarity
• add methods to clear callbacks and close WebSocket connection
• remove unnecessary newline at the end of PageEvents class file
• add context managers and async file handling for efficiency
• implement singleton pattern and prevent multiple initializations
• add dynamic connection port handling for browser instance
• add temporary directory management for browser session storage
• add logging for connection events and command executions
• add PageEvents class with PAGE_LOADED event constant
• add temporary callback option to event registration method
• add page event handling and improve loading timeout management
• add utility function to decode base64 images to bytes
• add WebElement class for handling browser elements asynchronously
• add enumeration for selector types in constants module
• add PageCommands class for browser page control functions
• add InputCommands class for handling mouse and keyboard events
• implement DOM commands for interacting with web elements
• refactor BrowserCommands to include new window management methods
• implement some basic methods to navigate and control the browser instance
• enhance ConnectionHandler with detailed docstrings for methods
• add .gitignore, .python-version, and poetry.lock files

Fix

• browser context now uses the storage commands to get cookies, while the page context us cookies, while page context uses network
• update cookie retrieval to use NetworkCommands for consistency
• remove download path method from Browser and add to Page class
• add options to disable first-run and browser check flags
• handle KeyError when retrieving network response bodies
• use get() to safely retrieve attributes in WebElement class
• rename class attribute retrieval for clarity and consistency
• enhance get_properties and simplify text retrieval method
• enhance create_web_element call with additional value parameter
• fix incorrect key access in JavaScript evaluation result
• update cookie management to clear browser cookies correctly
• filter pages by title instead of URL in Browser class
• filter out non-page entries when fetching valid page IDs
• xpath element solved
• refactor event callback storage to use unique callback IDs
• add JavaScript execution method and enhance click offsets
• simplify response handling and improve event callback structure
• reorder page event enabling to ensure proper browser startup
• add JSON handling and improve WebSocket command execution

Refactor

• improve WebElement representation and handle None for nodeValue
• add newline at end of file for ElementNotFound exception class
• remove unused aiohttp import and clean up whitespace
• remove unnecessary blank lines in storage.py for clarity
• fix missing newline at the end of the file in page.py
• remove unnecessary whitespace in InputCommands class methods
• refactor DOM command methods for improved clarity and usability
• refactor Page class to inherit from FindElementsMixin
• refactor code to remove duplicate import of StorageCommands
• clarify error messages for command and callback validation
• refactor ConnectionHandler to simplify initialization and connect logic
• remove unnecessary whitespace in element.py for cleaner code
• refactor WebElement to enhance attribute retrieval methods
• refactor connection handling and improve error messaging
• refactor Browser class to use abstract base class and commands