Change Log

0.2.0 (24 Nov 2023)​ #

– Fix sap issue
– Fix chrome, edge automation extension install issue
– Change to new license model

0.1.18 (30 May 2023)​ #

New features​

• Support to capture and operate across iframe elements.

Improvements​

• Improve performance.
• Improve packaging issue.
• Support latest version of Brave and Vivaldi.

0.1.17 (9 May 2023)​ #

Improvements​

• Refactor CDP API.
• Support Chrome version 113.
• Fix JAVA automation extension install issue.

0.1.14 (27 March 2023)​ #

New features​

• Add Headless support for Chrome and Edge in CDP mode.

Improvements​

• Fix Javascript exection failure in CDP mode.
• Fix set_text failure with Windows grideview by simulating keyboard.

0.1.12 (13 January 2023)​ #

New features​

• Add CDP API support for Chrome and Edge.

Improvements​

• Fix Java automation extension installation issue.

0.1.11 (18 November 2022)​ #

New features​

• Add scrape_data API to get structure data.
• Add screenshot_to_image API for BrowserTab to take a scrolling Screenshot for browsers tab for chromium-based browsers.
• Add screenshot_to_image API for WebElement to take a scrolling Screenshot for WebElement for chromium-based browsers.

Improvements​

• Fix bug: Recording issue for web element.
• Fix bug: Fix tab.goto issue and add is_wait_complete parameter.
• Change to browser native screenshot function for chromium-based browsers.

0.1.10 (19 October 2022)​ #

New features​

• Upgrade to Manifest V3 for Chrome and Edge extension.
• Support for installing Chrome and Edge extension from online web store.
• Support to pass additional arguments, when open the browser with method open.

Improvements​

• Enhanced online recording experience and the notifications when a browser extension is not ready.
• Fix bug: wait_disappear not working, when the element exists and then disappears.

0.1.9 (29 September 2022)​ #

New features​

• Support for setting up a shortcut key for image and UI locator capture.

Improvements​

• Improve the IA recording experience.
• Improve the Java recording experience.
• Optimised recording error messages are shown when the Edge browser uses multiple windows under different user profiles.

0.1.8 (23 September 2022)​ #

New features​

• New API: support locating by XPath, BrowserTab.find_element_by_xpath/find_elements_by_xpath/is_existing_by_xpath/wait_appear_by_xpath/wait_disappear_by_xpath.
• New API: support locating by CSS selector, BrowserTab.find_element_by_css_selector/find_elements_by_css_selector/is_existing_by_css_selector/wait_appear_by_css_selector/wait_disappear_by_css_selector.
• New API: support finding a single element or elements based on current element, WebElement.find_element/find_element_by_xpath/find_element_by_css_selector/find_elements/find_elements_by_xpath/find_elements_by_css_selector.
• Updated Web locator: get all Web element’s attributes.
• Support custom attibutes for Web locator.
• Support automation for custom chromium browsers, such as “Brave”, “Vivaldi” and so on, clicknium.chromium(“brave”).
• Support installation for custom chromium browser extension, clicknium.chromium(“brave”).extenion.install().

Improvements​

• Improve the experience of recording WeChat desktop client.
• Improve the experience of recording the similar elements, rather than scrolling to the first element.
• Optimize exception error, when save_to_image with invalid file path.
• Optimize locating elements: get_property would not scroll to the element.

0.1.7 (8 September 2022)​ #

Improvements​

• Hotfix: in the event that Chrome is running in multiple windows, there is a chance that the recorder won’t function properly.

0.1.6 (7 September 2022)​ #

Improvements​

• Enhance the Java extension installation process and examine the JAVA _HOME directory.
• Fix bug: set_text may get errors with method set-text for desktop applications.
• Fix bug: web elements can not be located without attribute tag.
• Fix bug: when a Javascript file’s content contains characters other than English, execute_js_file cannot function.
• Fix bug: when times is set to a negative number, mouse.scroll will not function.

0.1.5 (26 August 2022)​ #

New features​

• New API: support mouse emulation events, clicknium.mouse.click/double_click/up/down/move/scroll/position.
• Support validation elements with specified index.

Improvements​

• Improve the experience of installing browser extensions.
• Optimize the default names for locators.
• Refine Java automation and Java application automation.
• Fix bug: Clicknium module can not run on Windows 7.
• Fix bug: automating browsers may get errors when opening browsers concurrently.
• Fix bug: locating elements may get errors with the default value for attribute index.
• Fix bug: recording elements may get errors when other browsers’ extensions running.
• Fix bug: missing name attribute while recording for UIA locator.

0.1.4 (12 August 2022)​ #

New features​

• New API: BrowserTab.scroll(delta_x, delta_y), scroll the current browser tab with the scroll bar.
• New API: WebElement.scroll(delta_x, delta_y), scroll the current web element with the scroll bar.
• Support regular expression operator in the locator.
• Support automation for explorer appbar control on Windows 11.
• Update the requirements of clicknium python module. With the python version greater than 3.9(include 3.9), pythonnet module will be installed by default.

Improvements​

• Improve the attach error for the browser tab when the browser extension is not ready.
• Improve the experience of recording the similar elements.
• Improve the performance of Clicknium Recorder.
• Improve UI button style for Clicknium Recorder.
• Fix bug: record ‘svg’ element failed with error “Unexpected character encountered while parsing value: ‘responseData.htmlAttributes.class'”.
• Fix bug: find_elements must wait until the web page has been loaded.
• Fix bug: set_text can not work when the text is a number.
• Fix bug: remind users if there are a number of Chrome windows with various user profiles, recording fails.

0.1.3 (1 August 2022)​ #

New features​

• New API: clicknium.edge/chrome/firefox.extension.is_installed(), check whether the extension is installed.
• Updated API: add with function for browsertab class.
• Updated locator: support ‘class’ and ‘ancestorclass’ attribute in locator of web automation.

Improvements​

• Improve browser extension installation experience.
• Fix web automation bug: validation failed for web element with tabIndex property.
• Fix bug: can not get actual element’s rectangle, when window’s DPI changed.
• Fix bug: new_tab was not working when url does not start with https://, http:// or file://.
• Fix bug: open browser can not get correct tab id when there is some other popup window.
• Fix bug: send_hotkey does not support some modifier keys, such as ‘^’ (for ctrl).

0.1.2 (19 July 2022)​ #

New features​

• New API: new_tab on browser class.
• New API: clicknium.edge/chrome/firefox.extension.detect(), it can get the installation state of the browser extension.
• New API: clicknium.edge/chrome/firefox.extension.install_or_update(), it will install brower extension when extension is not installed or has a newer version.
• New API: get_screenshot, global interface to capture the screenshot.
• Updated API: set_text with new parameter overwrite, indicate whether overwrite the text or append the text on the target element.

Improvements​

• Fix yrate not working issue for API click, double_click.
• Improve browser extension installation experience.
• The front active window will be selected when there are multiple windows matched by given locator during automation run.
• Fix UIA bug: validation failed on navigation pane of Windows File Explorer.
• Improve locator for web automation: trim the space for the value of attribute sinfo, name etc.
• Fix web automation bug: modifier_key was not working on web element.
• Improve recording element experience on SAP to ensure the generated locator is SAP specific.

0.1.0 (30 June 2022)​ #

Initial release version.

• Several desktop automation libraries: UIA, Java, IA, SAP automation.
• Several web automation libraries: Chrome, Edge, Internet Explorer(IE), FireFox.
• Support automation based on image recognization.
• Unified automation API for different applications, such as click, set_text, get_text, send_hotkey, select_item etc.
• Special APIs for web automation: open browser, attach to already opened browser, get active tab, close browser, refresh tab, close tab etc.
• Special API for application window: maximize, minimize, restore etc.
• Special API for SAP Windows GUI application: login, call_transaction, get_statusbar etc.
• API to install Chrome/Edge/Firefox browser extension.

PreviousWindowsNativeError