Browser automation mode

Vue d’ensemble des méthodes d’automatisation des navigateurs disponibles dans UiPath — Extension navigateur, WebDriver et Automatisation Chromium — et de la marche à suivre pour choisir entre elles.

UiPath prend en charge plusieurs méthodes d’automatisation des navigateurs, chacune étant adaptée à différents environnements de déploiement et à différentes cibles de navigateur. Le paramètre Mode d’automatisation du navigateur vous permet de choisir la méthode à utiliser, soit pour une étendue de workflow spécifique via l’activité Utiliser l’application/le navigateur , soit comme valeur par défaut à l’échelle du projet dans Paramètres du projet moderne UI Automation > Application/Navigateur.

Méthodes d’automatisation

UiPath fournit trois méthodes d'automatisation sous-jacentes, exposées sous forme de cinq modes:

L’extension navigateur injecte l’extension UiPath dans le navigateur pour interagir directement avec les pages Web. Il nécessite l'installation de l'extension, mais fournit la couverture d'automatisation la plus riche et est compatible avec les quatre principaux navigateurs pris en charge: Chrome, Edge, Firefox, Safari.

WebDriver utilise le protocole W3C WebDriver pour ouvrir et contrôler une session de navigateur dédiée via un fichier binaire de pilote spécifique au navigateur (chromedriver, msedgedriver, geckodriver). Il fonctionne sans l'extension UiPath et prend en charge les quatre principaux navigateurs. Une variante sans affichage exécute le navigateur sans fenêtre visible.

Chromium Automation utilise le protocole CDP Chrome pour contrôler directement les navigateurs basés sur Chromium, sans téléchargement d’extension ou de pilote requis. Il est le plus simple à configurer sur Chrome et Edge. Une variante sans affichage est également disponible.

Modes disponibles

Extension de navigateur

Utilise l’extension de navigateur UiPath pour automatiser le navigateur cible. L'extension injecte des scripts dans les pages Web pour interagir avec la page et signale les informations sur les éléments au robot.

• Nécessite: l'extension de navigateur UiPath installée et activée dans le profil de navigateur cible
• Navigateurs pris en charge: Chrome, Edge, Firefox, Safari
• Fenêtre du navigateur: Visible

Il s'agit du mode par défaut. Choisissez-le pour l'automatisation Attended ou Unattended standard où le navigateur s'exécute sur la même machine que l'installation du Robot et de l'extension est possible.

Remarque :

Pour automatiser les pages en mode navigation privée (Incognito), ouvrez chrome://extensions., localisez l'extension UiPath et activez Autoriser en mode navigation privée et Autoriser l'accès aux URL de fichier.

WebDriver avec interface utilisateur

Ouvre une nouvelle session de navigateur visible contrôlée par le protocole W3C WebDriver. UiPath communique avec le navigateur par le biais d'un serveur WebDriver spécifique au navigateur.

• Nécessite: un binaire WebDriver compatible avec la version de navigateur installée
• Navigateurs pris en charge: Chrome, Edge, Firefox
• Fenêtre du navigateur: Visible

Remarque :

WebDriver crée un nouveau user-data-dir pour chaque session et ne peut pas se connecter à une instance de navigateur déjà ouverte sur le bureau de l'utilisateur. WebDriver n’est donc pas adapté à l’automatisation Attended. Pour l'automatisation Unattended, il ne s'agit pas d'une limitation.

WebDriver sans interface utilisateur

Identique à WebDriver avec interface graphique, mais le navigateur s'exécute sans fenêtre visible.

• Nécessite: un binaire WebDriver compatible avec la version de navigateur installée
• Navigateurs pris en charge: Chrome, Edge, Firefox
• Fenêtre du navigateur: Aucune (sans affichage)

Remarque :

Certaines opérations qui nécessitent une fenêtre visible, telles que le glisser-déposer natif ou la simulation à l'aide d'une souris matérielle, ne sont pas prises en charge en mode sans affichage.

Comme WebDriver avec interface graphique, ce mode crée un nouveau user-data-dir et ne peut pas se connecter à un navigateur déjà ouvert. Un binaire WebDriver compatible doit être téléchargé lors du runtime. Le mode navigation privée est pris en charge sans configuration supplémentaire.

Automatisation Chromium

Utilise le protocole CDP Chrome pour contrôler directement le navigateur. Aucune installation d’extension ou un fichier binaire WebDriver n’est requis — UiPath se lance et gère la session du navigateur en interne.

• Nécessite: le processus du navigateur lancé avec l’indicateur --remote-debugging-port=0
• Navigateurs pris en charge: Chrome, Edge et tous les navigateurs basés sur Chromium
• Fenêtre du navigateur: Visible

Choisissez ce mode pour la configuration la plus simple sur Chrome ou Edge. Il ne prend pas en charge Firefox ou Safari.

Remarque :

Chromium Automation crée un nouveau user-data-dir pour chaque session et ne peut pas se connecter à une instance de navigateur déjà ouverte sur le bureau de l'utilisateur. Il n’est donc pas adapté à l’automatisation Attended. Pour l'automatisation Unattended, il ne s'agit pas d'une limitation.

Le mode navigation privée est pris en charge sans configuration supplémentaire.

Automatisation Chromium sans interface utilisateur

Identique à Chromium Automation, mais le navigateur s’exécute sans fenêtre visible.

• Nécessite: le processus du navigateur lancé avec l’indicateur --remote-debugging-port=0
• Navigateurs pris en charge: Chrome, Edge et tous les navigateurs basés sur Chromium
• Fenêtre du navigateur: Aucune (sans affichage)

Ce mode combine une configuration zéro configuration avec l'exécution sans affichage, ce qui le rend bien adapté à l'automatisation unattended sur des serveurs ou des pipelines CI/CD.

Remarque :

Comme l’automatisation Chromium, ce mode crée une nouvelle user-data-dir et est bloqué lorsque la stratégie de groupe DeveloperToolsAvailability est définie sur 2. Le mode navigation privée est pris en charge sans configuration supplémentaire.

Comparaison

Exigences de configuration

De quoi chaque mode dépend avant de pouvoir s'exécuter.

Mode	Extension requise	WebDriver requis	Sans affichage	Configuration supplémentaire
Extension de navigateur	✅	❌	❌	Installer l’extension UiPath
WebDriver avec interface utilisateur	❌	✅	❌	Télécharger le fichier binaire WebDriver
WebDriver sans interface utilisateur	❌	✅	✅	Télécharger le fichier binaire WebDriver
Automatisation Chromium	❌	❌	❌	Lancer le navigateur avec l’indicateur --remote-debugging-port=0
Automatisation Chromium sans interface utilisateur	❌	❌	✅	Lancer le navigateur avec l’indicateur --remote-debugging-port=0

Capabilities

Ce que chaque mode prend en charge une fois qu'il est en cours d'exécution.

Mode	Automatisation assistée	Incognito (aucune configuration)	Navigateurs pris en charge
Extension de navigateur	✅	❌	Chrome, Edge, Firefox, Safari
WebDriver avec interface utilisateur	❌	✅	Chrome, Edge, Firefox
WebDriver sans interface utilisateur	❌	✅	Chrome, Edge, Firefox
Automatisation Chromium	❌	✅	Chrome, Edge, basé sur Chromium
Automatisation Chromium sans interface utilisateur	❌	✅	Chrome, Edge, basé sur Chromium

Choix d’un mode

Scénario	Mode recommandé
Automatisation du bureau standard, l’extension peut être installée	Extension de navigateur
Automatisation Attended (fonctionner avec le navigateur déjà ouvert de l'utilisateur)	Extension de navigateur
L’extension ne peut pas être installée, le navigateur doit être visible	WebDriver avec interface utilisateur
L’extension ne peut pas être installée, aucun affichage n’est disponible	WebDriver sans interface utilisateur
Chrome ou Edge, configuration la plus simple possible	Automatisation Chromium
Automatisation Unattended ou du serveur sur Chrome/Edge, aucun affichage	Automatisation Chromium sans interface utilisateur
Firefox ou Safari sans extension	WebDriver avec interface utilisateur graphique ou WebDriver sans interface utilisateur
DeveloperToolsAvailability La stratégie de groupe restreint les outils de développement	Extension de navigateur ou WebDriver

Configurer le mode

Pour une activité spécifique

1. Ajoutez une activité Utiliser l'application/le navigateur à votre workflow.
2. Dans le panneau Propriétés , localisez Mode d'automatisation du navigateur.
3. Sélectionnez le mode souhaité dans la liste déroulante.

Résultat: le mode sélectionné s'applique à chaque activité UI Automation limitée à ce conteneur Utiliser l'application/le navigateur .

En tant que projet par défaut

1. Ouvrez les Paramètres du projet à partir de l'icône en forme d'engrenage dans le panneau Projet .
2. Accédez à UI Automation Modern > Application/Navigateur.
3. Définissez le Mode d'automatisation du navigateur sur votre valeur par défaut préférée.
4. Sélectionnez Enregistrer.

Résultat: les nouvelles activités Utiliser l'application/le navigateur ajoutées au projet utilisent le mode sélectionné, sauf si une activité spécifique est remplacée.

Le paramètre au niveau de l'activité est prioritaire sur le paramètre par défaut du projet dans son étendue.

Important :

La propriété Mode d'automatisation du navigateur pour l'activité Utiliser l'application/le navigateur et le paramètre de projet dans UI Automation Modern > Application/Navigateur sont disponibles à partir de UIAutomation v26.10.0.

Limitations

• Les modes d’automatisation Chromium ne prennent en charge que les navigateurs basés sur Chromium. Leur utilisation avec Firefox ou Safari renvoie une erreur; aucun recours automatique ne se produit.
• Les modes sans affichage ne prennent pas en charge les opérations qui dépendent d’une fenêtre visible ou d’un rendu au niveau du système d’exploitation, telles que le glisser-déposer de la souris matérielle ou certaines opérations de capture d’écran.
• WebDriver et Chromium Automation créent un nouveau user-data-dir pour chaque session. Ils ne peuvent pas se connecter à un navigateur déjà ouvert sur le bureau de l'utilisateur, ce qui les rend inadaptés à l'automatisation Attended. Il ne s'agit pas d'une limitation pour l'automatisation unattended.
• Les sessions WebDriver et Automatisation Chromium utilisent un profil de navigateur isolé. Les extensions, les mots de passe enregistrés et les cookies de session utilisateur du profil de navigateur par défaut ne sont pas disponibles.
• WebDriver nécessite qu'un binaire spécifique au navigateur (chromedriver, msedgedriver ou geckodriver) soit téléchargé au moment du runtime et restera compatible avec la version de navigateur installée. L’extension de navigateur et l’automatisation Chromium n’ont pas une telle dépendance binaire externe.
• L’automatisation Chromium est bloquée lorsque la stratégie de groupe DisponibilitéOutilsDéveloppement est définie sur 2 (utilisation des outils de développement interdite). Utilisez l’extension de navigateur ou WebDriver dans les environnements où cette politique est appliquée.
• L'extension navigateur nécessite une configuration manuelle supplémentaire pour automatiser les pages en mode Incognito: l'utilisateur doit ouvrir chrome://extensions, localiser l'extension UiPath et activer Autoriser en mode navigation privée et Autoriser l'accès aux URL de fichier. WebDriver et Automatisation Chromium prennent en charge le mode navigation privée sans configuration supplémentaire.