Extension for Safari

Starting with UiPath.UIAutomation.Activities version 24.10.0, Safari UI Automation support is available in preview. The extension for Safari allows you to:

• Design UI automations in Studio Web within the Safari browser on macOS.
• Execute browser automations in Safari using a local macOS Robot, previously installed and connected to the Orchestrator.
• Start attended browser automations in Safari via the macOS Assistant.

To create and run such automations, you must install the UiPath Name extension for Safari.

You can start from Studio Web by adding any UI Automation activities. When accessing Studio Web from Safari, you are prompted to install the UiPath extension for Safari from the App Store. Follow the setup guide to configure the extension, then start designing your workflows for browser automation in Safari.

Note:

To create browser automations in Safari on machines running macOS, the minimum supported version is macOS 12.

Install

Install from UiPath Studio Web

1. In UiPath Automation Cloud™, access Studio Web.
2. Add a Use Browser activity to your project. You are prompted to install the UiPath extension for Safari.
   
   

   

   
   
3. Select the Install extension button.
4. You are directed to the App Store, to install the UiPath Browser Automation extension.
5. Select Get to install the extension, and then Open it.
   
   

   

   
   
6. After selecting Open, you are directed to a configuration window.
   
   

   

   
   
7. Select Open Safari settings to access the Extensions window, where you can set the right permissions for the newly installed extension.
   1. Enable the UiPath Browser Automation extension in the left-side panel.
      
      

      

      
      
   2. Select Always Allow on Every Website and confirm this choice.
      
      

      

      
      
   3. If you intend to use private browsing, enable the Allow Private Browsing setting.
8. Once you complete these steps, a message informs you that the extension is now available.

Install from App Store

You can access the UiPath extension for Safari directly in the App Store and continue the installation process from step 4 of the previous section.

Install from UiPath Assistant

Installing the Safari extension from Studio Web or directly from the App Store also installs the Native Host component. This means that you can run automations from UiPath Assistant without the need for additional installation.

You can install the UiPath Extension for Safari from UiPath Assistant, from the UiPath Extensions page, through an Install button which redirects you to the App Store.

Uninstall

Uninstall from Safari settings

1. Access Safari Settings.
2. Navigate to the Extensions tab.
3. Select the Uninstall button.
   
   

   

   
   
4. Select the Show in Finder button. This opens the Finder with the application selected.
   
   

   

   
   
5. Right-click the UiPath for Safari application and select the Move to the Bin button.
   
   

   

   
   

   If you see a pop-up message stating that the application could not be deleted because it is currently in use, you have to make sure the extension application is closed.

   
   

   

   
   

   To do this, open Activity Monitor and search for UiPath Native Host for Safari. Select the application, and choose Stop. In the next step, select Quit.

   
   

   

   
   

   Now, you can go back to Finder, and select again Move to Bin.

   
   

   

   
   
6. Enter your Mac credentials and then select the OK button to authorize this deletion.
   
   

   

   
   
7. The extension is now uninstalled. Once the extension is deleted, it is removed from the Safari extension bar and from Safari Settings Extensions tab.

Accessibility configuration

To use the Hardware Events input mode, you must specifically grant UiPath Assistant access to your Mac using the Privacy & Security settings.

To do so, follow the steps below:

1. Select the Apple menu.
2. Select System Settings.
3. Select Privacy & Security in the left sidebar.
4. Go to Accessibility by selecting the arrow on the right-hand side.

5. Enable UiPath Assistant application from the list.

   If you do not see the application, click the plus button at the bottom of the list, search for UiPath Assistant, select the application, and choose Open.

   Mac credentials are requested for this change.

Known limitations

Consider the following limitations when creating browser automations for Safari:

• The extension cannot access file URLs. This is a Safari limitation, as explained in this Apple Developer forum thread (Allow access to file URLs for web extensions).

• The extension does not support multiple profiles.