Méthodes de connecteur Chrome

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 10 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 méthode du connecteur Chrome

    Méthodes au niveau de l’application

    Méthodes au niveau de l’écran

    Méthodes au niveau des éléments

    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 la 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

    AttendreToutÉcran

    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 des paramètres de méthode (icône des 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 dans les champs, reportez-vous à la section Configurer les propriétés des ports.
    Tableau 2. Paramètres de la méthode de navigation
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    MatchAllChildren (en anglais seulement) Si True, avant de charger l’écran, la méthode correspond aux é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 Chrome Connector.
    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é.

    Focus

    Définit le focus sur la fenêtre capturée.
    Tableau 3. Paramètres de la 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é défini sur la fenêtre capturée. Sinon, si la valeur est Faux, le focus n’a pas été défini sur la fenêtre capturée. Sortie de données Booléen Aucune valeur par défaut Non applicable

    Obtenir des champs

    Renvoie les valeurs des champs ou des é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 des paramètres de méthode (icône des paramètres de méthode).
    2. Dans la fenêtre CHOISIR LES ÉLÉMENTS DU 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 retourne la valeur. Sortie de données Chaîne Aucune valeur par défaut Non applicable

    GetInnerHtml (en anglais seulement)

    Renvoie le code HTML interne de l’écran capturé.
    Tableau 5. Paramètres de la 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’écran capturé. Sortie de données Objet Non applicable Non applicable

    GetPageSource (en anglais seulement)

    Renvoie la source de la 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 la page de l’écran capturé. Sortie de données Chaîne Non applicable Non applicable

    Obtenir une capture d’écran

    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

    Obtenir le titre

    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

    GetURL

    Renvoie l’URL de la page Web 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 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 dans les 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 à partir du nœud XML. Sortie de données Chaîne Non applicable Non applicable

    IsCreated (Créé le )

    Renvoie la valeur booléenne selon que l’écran est rendu avec succès ou non sur l’application Web.

    Pour fournir des entrées dans les 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 (en anglais seulement) Si la valeur est Vrai, avant que l’écran ne soit rendu, 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 Chrome Connector.
    Retour Si la valeur est Vrai, l’écran est restitué. 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 des éléments

    Cliquer sur

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

    Focus

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

    Pour fournir des entrées dans les 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 définit le focus sur l’élément. Sinon, si la valeur est Faux, la méthode n’a pas réussi à définir le focus sur l’élément. Sortie de données Booléen Non applicable Non applicable

    GetInnerHTML (en anglais)

    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 (en anglais seulement)

    Renvoie le texte interne dans l’élément capturé.
    Tableau 14. Paramètres de la 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 interne dans l’élément capturé. Sortie de données Chaîne Non applicable Non applicable

    GetOuterHTML

    Renvoie l’élément HTML et ses attributs, 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 (en anglais seulement)

    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 (Créé le )

    Renvoie l’état booléen indiquant si l’élément capturé a été chargé.
    Tableau 17. Paramètre de la 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, le chargement de l’élément capturé a échoué. 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 en toute sécurité dans le champ Mot de passe d’un formulaire de connexion.

    Pour fournir des entrées dans les 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 Aucun Oui Étant donné qu’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 de la souris sur le paramètre, puis cliquez sur Prévisualiser les données.
    UseSendKeys (en anglais seulement) 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 password, définissez la valeur sur True et exécutez à nouveau la méthode.

    SendKeys (Envoyer des clés)

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

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

    Obtenir un nombre d’instances

    Renvoie un décompte du nombre d’instances où l’élément est disponible.

    GetOuterHTML

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

    SendKeys (Envoyer des clés)

    Simule les frappes au clavier sur les pages Web et les fenêtres.
    Entrées
    ClearExistingValue (en anglais seulement)
    Délai de type

    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à avoir été défini dans le code HTML de la page Web. Par exemple, pour simuler l’événement contextmenu sur un élément, l’élément doit déjà avoir l’événement contextmenu défini dans le code HTML.
    Pour fournir des entrées dans les 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 la 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 (Type d’événement de souris) 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
    • Menu contextuel
    MouseButton (Bouton de la souris) Simule le clic du bouton de la souris sur l’élément de page Web capturé. Données dans MouseButtonType (Type de bouton de souris) Gauche Oui La méthode prend en charge ces actions de bouton de la souris.
    • Gauche
    • milieu
    • Droit

    SimulateEvent (Simuler un é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 dans les 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 Aucun Oui