Méthodes des connecteurs au chrome

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 9 minutes de lecture

    • Les méthodes de connecteur Chromium effectuent différentes tâches sur les applications, les écrans et les éléments sur les écrans des Google ChromeMicrosoft Edge navigateurs.

    Niveaux de la méthode du connecteur de chrome

    Méthodes au niveau de l’application

    Méthodes au niveau de l’écran

    Méthodes au niveau de l’élément

    Méthodes au niveau de l’application

    Naviguer

    Lance la page Web en fonction de l’URL spécifiée.

    Pour fournir des entrées, consultez Configurer les propriétés des ports
    Tableau 1. Paramètres de méthode de navigation
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    URL URL de la page Web. Données dans Chaîne Aucune valeur par défaut Non
    Délai Option permettant de spécifier le délai en secondes après lequel l’opération expire. Données dans Entier Aucune valeur par défaut Non
    Retour Si la valeur est Vrai, la page Web a été lancée. Sinon, si la valeur est Faux, la page Web n’a pas été lancée. Sortie de données Booléen Non applicable Non applicable

    WaitForAnyScreen

    Définit un délai avant le chargement des écrans spécifiés.

    Pour spécifier l’écran, procédez comme suit :
    1. Cliquez sur l’icône Paramètres de méthode ( Icône Paramètres de méthode.).
    2. Dans la fenêtre CHOISIR DES ÉCRANS, sélectionnez l’écran requis.
    3. Cliquez sur OK.
    Pour fournir des entrées aux champs, reportez-vous à la section Configurer les propriétés des ports.
    Tableau 2. Paramètres de méthode de navigation
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    MatchAllChildren Si la valeur est Vrai, avant de charger l’écran, la méthode met en correspondance les éléments capturés à partir de la page Web. Sinon, si la valeur est Faux, la méthode ne correspond à aucun élément. Données dans Booléen Aucune valeur par défaut Non Les éléments se trouvent dans la section MATCH CHILDREN de la fenêtre Connecteur Chromium.
    Délai Spécifie le délai en secondes après lequel l’opération expire. Données dans Entier Aucune valeur par défaut Non

    Méthodes au niveau de l’écran

    Fermer

    Ferme la fenêtre de l’écran capturé.

    Foyer

    Définit le focus sur la fenêtre capturée.
    Tableau 3. Paramètres de méthode de navigation
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Retour Si la valeur est Vrai, le focus a été placé sur la fenêtre capturée. Sinon, si la valeur est Faux, le focus n’était pas défini sur la fenêtre capturée. Sortie de données Booléen Aucune valeur par défaut Non applicable

    GetFields

    Renvoie les valeurs des champs ou éléments spécifiés. Par exemple, il peut renvoyer le texte d’un bouton.

    Pour spécifier les champs, procédez comme suit.
    1. Cliquez sur l’icône Paramètres de méthode ( Icône Paramètres de méthode.).
    2. Dans la fenêtre CHOISIR DES ÉLÉMENTS DE FORMULAIRE, sélectionnez les champs requis.
    3. Cliquez sur OK.
    Tableau 4. Paramètres de méthode GetFields
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Nom du champ ou de l’élément Champ ou élément pour lequel la méthode renvoie la valeur. Sortie de données Chaîne Aucune valeur par défaut Non applicable

    GetInnerHtml

    Renvoie le HTML interne de l’écran capturé.
    Tableau 5. Paramètres de méthode GetInnerHtml
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Retour Renvoie le HTML interne de l’écran capturé. Sortie de données Objet Non applicable Non applicable

    GetPageSource

    Renvoie la source de page de l’écran capturé.
    Tableau 6. Paramètres de méthode GetPageSource
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Retour Renvoie la source de page de l’écran capturé. Sortie de données Chaîne Non applicable Non applicable

    GetScreenShot

    Renvoie la capture d’écran de l’écran configuré.
    Tableau 7. Paramètres de la méthode GetScreenShot
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Retour Renvoie la capture d’écran de l’écran configuré. Sortie de données Image matricielle Aucune valeur par défaut Non applicable

    GetTitle

    Renvoie le titre de la page Web capturée.
    Tableau 8. Paramètre de méthode GetTitle
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Retour Renvoie le titre de la page Web capturée. Sortie de données Chaîne Aucune valeur par défaut Non applicable

    URL de destination

    Renvoie l’URL de la page Web qui a été capturée.
    Tableau 9. Paramètres de méthode GetURL
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Retour Renvoie l’URL de la page Web qui a été capturée. Sortie de données Chaîne Aucune valeur par défaut Non applicable

    GetValueByXPath

    Renvoie la valeur dans un nœud XML à partir du chemin XML spécifié.

    Pour fournir des entrées aux champs, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 10. Paramètres de méthode GetValueByXPath
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    XPath XPath de la page Web capturée. Données dans Chaîne Aucune valeur par défaut Non
    Retour Renvoie la valeur du nœud XML. Sortie de données Chaîne Non applicable Non applicable

    IsCreated

    Renvoie la valeur booléenne selon que l’écran est affiché correctement ou non sur l’application Web.

    Pour fournir des entrées aux champs, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 11. Paramètres de la méthode IsCreated
    Paramètre Description Type de port de données Type de données Type par défaut Obligatoire? Notes
    MatchAllChildren Si la valeur est Vrai, avant le rendu de l’écran, la méthode tente de faire correspondre tous les éléments capturés. Sinon, si la valeur est Faux, aucune correspondance n’est effectuée. Données dans Booléen Aucune valeur par défaut Non Vous pouvez trouver les éléments capturés dans la section MATCH CHILDREN de la fenêtre Connecteur Chromium.
    Retour Si la valeur est Vrai, l’écran s’affiche correctement. Sinon, si la valeur est Faux, l’écran n’a pas réussi à s’afficher. Sortie de données Booléen Non applicable Non applicable

    Méthodes au niveau de l’élément

    Cliquer sur

    Effectue une opération de clic sur l’élément.

    Foyer

    Met l’accent sur l’élément.

    Pour fournir des entrées aux champs, reportez-vous à la section Configurer les propriétés des ports.
    Tableau 12. Paramètres de la méthode de mise au point
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    scrollIntoView Si la valeur est Vrai, la méthode utilise la barre de défilement pour accéder à l’élément capturé sur la page Web. Sinon, si la valeur est Faux, elle ne défile pas jusqu’à l’élément capturé. Données dans Booléen Aucune valeur par défaut Non
    Retour Si la valeur est Vrai, la méthode met l’accent sur l’élément. Sinon, si la valeur est Faux, la méthode n’a pas réussi à définir la mise au point sur l’élément. Sortie de données Booléen Non applicable Non applicable

    GetInnerHTML

    Renvoie le code HTML interne de l’élément capturé.
    Tableau 13. Paramètres de méthode GetInnerHTML
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Retour Renvoie le code HTML interne de l’élément capturé. Sortie de données Chaîne Aucun type par défaut Non applicable

    GetInnerText

    Renvoie le texte intérieur de l’élément capturé.
    Tableau 14. Paramètres de méthode GetInnerText
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Retour Renvoie le texte intérieur de l’élément capturé. Sortie de données Chaîne Non applicable Non applicable

    GetOuterHTML

    Renvoie l’élément HTML et ses attributs, ainsi que les balises de début et de fin de l’élément capturé.
    Tableau 15. Paramètres de méthode GetOuterHTML
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Retour Renvoie le code HTML externe de l’élément capturé. Sortie de données Chaîne Aucune valeur par défaut Non applicable

    GetOuterText

    Renvoie le contenu textuel de l’élément capturé.
    Tableau 16. Paramètres de méthode GetOuterText
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Retour Renvoie le contenu textuel de l’élément capturé. Sortie de données Chaîne Aucune valeur par défaut Non applicable

    IsCreated

    Renvoie l’état booléen indiquant si l’élément capturé a été chargé.
    Tableau 17. Paramètre de méthode IsCreated
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Retour Si la valeur est Vrai, l’élément capturé a été chargé. Sinon, si la valeur est Faux, l’élément capturé n’a pas pu être chargé. Sortie de données Booléen Aucune valeur par défaut Non applicable

    Définir le mot de passe

    Automatisez la saisie sécurisée du mot de passe dans le champ mot de passe d’une application Web. Par exemple, saisissez le mot de passe de manière sécurisée dans le champ mot de passe d’un formulaire de connexion.

    Pour fournir des entrées aux champs, reportez-vous à la section Configurer les propriétés des ports.
    Tableau 18. Paramètres de la méthode SetPassword
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    Mot de passe Accepte le mot de passe comme une chaîne sécurisée. Données dans Chaîne sécurisée Néant Oui Comme il accepte le mot de passe comme une chaîne sécurisée, il n’affiche la longueur de la chaîne que lorsque vous cliquez avec le bouton droit sur le paramètre, puis cliquez sur Prévisualiser les données.
    UseSendKeys SendKeys est une méthode utilisée pour envoyer des entrées clavier telles que des caractères, des chiffres et des symboles à des zones de texte à l’intérieur d’une application. Données dans Booléen Faux Oui
    Conseil :
    Si la méthode SetPassword ne parvient pas à saisir le mot de passe dans le champ mot de passe, définissez la valeur sur Vrai et exécutez à nouveau la méthode.

    Clés d’envoi

    Transmet des touches de raccourci à l’élément capturé.

    Pour fournir des entrées aux champs, reportez-vous à la section Configurer les propriétés des ports.
    Tableau 19. Paramètres de méthode SendKeys
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    Clés Prend les touches de raccourci. Données dans Chaîne Aucune valeur par défaut Non
    Valeur ClearExistingValue Si la valeur est Vrai, la méthode efface toute valeur existante dans le champ. Sinon, si la valeur est Faux, la valeur existante n’est pas effacée. Données dans Booléen Aucune valeur par défaut Non
    TypeDelay Définit le délai de frappe entre chaque touche. Données dans Double Aucune valeur par défaut Non

    GetInstanceCount

    Renvoie le nombre d’instances où l’élément est disponible.

    GetOuterHTML

    Obtient le code HTML externe de l’élément capturé.

    Clés d’envoi

    Simule les frappes sur les pages Web et les fenêtres.
    Entrées
    Valeur ClearExistingValue
    TypeDelay

    SimulateMouseEvent

    Simule l’événement de souris que vous spécifiez sur un élément d’une application Web. Par exemple, simulez un clic droit de la souris sur un élément.
    Important :
    Pour simuler un événement de souris sur un élément, cet événement spécifique doit déjà être défini dans le HTML de la page Web. Par exemple, pour simuler l’événement contextmenu sur un élément, l’événement contextmenu doit déjà être défini dans le code HTML.
    Pour fournir des entrées aux champs, consultez Configurer les propriétés des ports
    Tableau 20. Paramètres de la méthode SimulateMouseEvent
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    Événement de souris Événement de souris qui se produit sur l’élément de page Web capturé. Au moment où l’événement mouse se produit sur un élément de page Web, cet élément doit déjà avoir l’événement mouse défini dans le HTML. Données dans MouseEventType cliquer sur Oui La méthode prend en charge ces événements de souris.
    • cliquer sur
    • dblclick
    • mousedown
    • mouseup
    • pointer avec la souris
    • mousemove
    • mouseout
    • contextmenu
    Bouton de la souris Simule le clic de la souris sur l’élément de page Web capturé. Données dans Type de bouton de souris Gauche Oui La méthode prend en charge ces actions de bouton de la souris.
    • Gauche
    • milieu
    • Droit

    Simulerun événement

    Simule l’événement HTML que vous spécifiez sur une Google page Chrome ou un élément de la page.

    Pour fournir des entrées aux champs, consultez Configurer les propriétés des ports
    Tableau 21. Paramètres de la méthode SimulateEvent
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire?
    EventName Nom de l’événement HTML. La méthode prend en charge les événements fournis et vous devez saisir le nom de l’événement exactement comme spécifié.

    Événements HTML

    • charger
    • décharger
    • annuler
    • erreur
    • sélectionner
    • changement
    • envoyer
    • réinitialiser
    • focus
    • estomper
    • redimensionner
    • Défiler
    		 Données dans Chaîne Néant Oui