Méthodes de connecteurs Chromium

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 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 la méthode des connecteurs Chromium

    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 du port
    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? Notes
    URL URL de la page Web. Données entrantes 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 entrantes 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. Données sortantes Booléen Non applicable Non applicable

    WaitForAnyScreen (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 la méthode ( icône des paramètres de la 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 à Configurer les propriétés du port.
    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 entrantes 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 entrantes 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? Notes
    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. Données sortantes Booléen Aucune valeur par défaut Non applicable

    GetFields (Obtenir des champs)

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

    Pour spécifier les champs, procédez comme suit.
    1. Cliquez sur l’icône des paramètres de la méthode ( icône des paramètres de la 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 la méthode GetFields
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    Nom du champ ou de l’élément Champ ou élément pour lequel la méthode retourne la valeur. Données sortantes Chaîne Aucune valeur par défaut Non applicable

    GetInnerHtml (en anglais)

    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? Notes
    Retour Renvoie le code HTML interne de l’écran capturé. Données sortantes Objet Non applicable Non applicable

    GetPageSource (en anglais)

    Renvoie la source de page de l’écran capturé.
    Tableau 6. Paramètres de la méthode GetPageSource
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    Retour Renvoie la source de page de l’écran capturé. Données sortantes 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? Notes
    Retour Renvoie la capture d’écran de l’écran configuré. Données sortantes Bitmap Aucune valeur par défaut Non applicable

    GetTitle (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? Notes
    Retour Renvoie le titre de la page Web capturée. Données sortantes Chaîne Aucune valeur par défaut Non applicable

    Geturl

    Renvoie l’URL de la page Web capturée.
    Tableau 9. Paramètres de la méthode GetURL
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    Retour Renvoie l’URL de la page Web capturée. Données sortantes 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 Configurer les propriétés du portà .

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

    IsCreated (Créé par le système)

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

    Pour fournir des entrées dans les champs, reportez-vous Configurer les propriétés du portà .

    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 true, 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 établie. Données entrantes 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 est rendu correctement. Sinon, si la valeur est faux, l’écran n’a pas réussi à s’afficher. Données sortantes 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 Configurer les propriétés du portà .
    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? Notes
    scrollIntoView Si la valeur est True, 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 entrantes Booléen Aucune valeur par défaut Non
    Retour Si la valeur est True, la méthode définit le focus sur l’élément. Sinon, si la valeur est False, la méthode n’a pas réussi à définir le focus sur l’élément. Données sortantes Booléen Non applicable Non applicable

    GetInnerHTML (en anglais)

    Renvoie le code HTML interne de l’élément capturé.
    Tableau 13. 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? Notes
    Retour Renvoie le code HTML interne de l’élément capturé. Données sortantes Chaîne Aucun type par défaut Non applicable

    GetInnerText

    Renvoie le texte intérieur 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? Notes
    Retour Renvoie le texte intérieur dans l’élément capturé. Données sortantes 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 la méthode GetOuterHTML
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire? Notes
    Retour Renvoie le code HTML externe de l’élément capturé. Données sortantes Chaîne Aucune valeur par défaut Non applicable

    GetOuterText (en anglais)

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

    IsCreated (Créé par le système)

    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? Notes
    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é. Données sortantes Booléen Aucune valeur par défaut Non applicable

    SetPassword (Définir un 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 dans les champs, reportez-vous Configurer les propriétés du portà .
    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 entrantes Chaîne sécurisée Aucun Oui Étant donné qu’il accepte le mot de passe en tant que 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.
    Utiliser SendKeys 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 au sein d’une application. Données entrantes 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 les touches de raccourci à l’élément capturé.

    Pour fournir des entrées dans les champs, reportez-vous Configurer les propriétés du portà .
    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? Notes
    Clés Utilise les touches de raccourci. Données entrantes Chaîne Aucune valeur par défaut Non
    ClearExistingValue (Effacer la valeur existante) Si la valeur est True, 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 entrantes Booléen Aucune valeur par défaut Non
    Délai de type Définit le délai de frappe entre chaque touche. Données entrantes Double Aucune valeur par défaut Non

    GetInstanceCount

    Renvoie un 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 clavier sur les pages Web et les fenêtres.
    Entrées
    ClearExistingValue (Effacer la valeur existante)
    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 sur un élément.
    Important :
    Pour simuler un événement de souris sur un élément, il faut déjà que cet événement spécifique soit 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 aux champs, consultez Configurer les propriétés du port
    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
    Mouseevent É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 code HTML. Données entrantes 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
    • Contextmenu
    MouseButton (Bouton de souris) Simule le clic du bouton de la souris sur l’élément de page Web capturé. Données entrantes MouseButtonType (Type de bouton de souris) Gauche Oui La méthode prend en charge ces actions de bouton de souris.
    • Gauche
    • Milieu
    • Droit

    SimulateEvent

    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 du port
    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? Notes
    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

    • Charge
    • Décharger
    • annuler
    • erreur
    • sélectionner
    • changement
    • envoyer
    • réinitialiser
    • focus
    • estomper
    • Redimensionner
    • Défiler
    Données entrantes Chaîne Aucun Oui