Lancement des navigateurs / documentation Cypress

lorsque vous exécutez des tests dans Cypress, nous lançons un navigateur pour vous. Cela nous permet de:

1. créer un environnement de test propre et vierge.
2. accédez aux API de navigateur privilégiées pour l’automatisation.,

les Navigateurs

Quand le Cyprès est d’abord exécuter à partir du lanceur de Test, vous pouvez choisir d’exécuter Cyprès dans un certain nombre de navigateurs, y compris:

• Canaries
• google Chrome
• Chrome
• Bord
• Bord Beta
• Bord Canaries
• Bord Dev
• Electron
• Firefox
• Firefox Developer Edition
• Firefox Nightly

Cyprès détecte automatiquement les navigateurs disponibles sur votre système d’exploitation., Vous pouvez changer le navigateur dans le coureur de Test en utilisant le menu déroulant dans le coin supérieur droit:

télécharger la version spécifique de Chrome

le navigateur Chrome est à feuilles persistantes – ce qui signifie qu’il se mettra automatiquement à jour, provoquant parfois un changement de rupture dans vos tests automatisés. Nous accueillons chromium.cypress.io avec des liens pour télécharger une version spécifique de Chrome (dev, Canary et stable) pour chaque plate-forme.

Electron Browser

en plus des navigateurs présents sur votre système, vous remarquerez Qu’Electron est un navigateur disponible., Le navigateur Electron est une version de Chromium qui vient avec Electron.

le navigateur Electron a l’avantage de venir cuit dans Cypress et n’a pas besoin d’être installé séparément.

par défaut, lors de l’exécution de cypress run à partir de la CLI, nous lancerons Electron sans tête.

vous pouvez également lancer Electron headed:

cypress run --headed

car Electron est le navigateur par défaut – il est généralement exécuté en CI. Si vous voyez des échecs dans CI, pour les déboguer facilement, vous pouvez exécuter localement avec l’option--headed.,

navigateurs Chrome

tous les navigateurs aromatisés Chrome* seront détectés et sont pris en charge au-dessus de Chrome 64.

Vous pouvez lancer Chrome comme ceci:

cypress run --browser chrome

Pour utiliser cette commande dans CI, vous devez installer le navigateur de votre choix – ou utiliser l’une de nos images docker.

par défaut, nous lancerons Chrome en mode headed. Pour exécuter Chrome sans tête, vous pouvez passer l’argument--headless àcypress run.,

Vous pouvez également lancer Chrome:

cypress run --browser chromium

Ou Chrome Canary:

cypress run --browser chrome:canary

Ou Microsoft Edge (Chrome-based):

cypress run --browser edge

Ou Microsoft Bord Canaries (Chrome-based):

cypress run --browser edge:canary

Firefox

Firefox-famille des navigateurs sont pris en charge par des Cyprès.,

Vous pouvez lancer Firefox comme ceci:

cypress run --browser firefox

Ou Firefox Developer/tous les Soirs Édition:

cypress run --browser firefox:devcypress run --browser firefox:nightly

Pour utiliser cette commande en CI, vous devez installer ces autres navigateurs ou utilisez l’un de nos docker images.

Par défaut, nous allons lancer Firefox en tête mode. Pour exécuter Firefox sans tête, vous pouvez passer l’argument--headless àcypress run.,

lancement par un chemin

Vous pouvez lancer n’importe quel navigateur pris en charge en spécifiant un chemin vers le binaire:

cypress run --browser /usr/bin/chromium

cypress open --browser /usr/bin/chromium

Cypress détectera automatiquement le type de navigateur fourni et le lancera pour vous.

Voir le guide de ligne de commande pour plus d’informations sur le--browserargumentsavoir des problèmes pour lancer un navigateur? Consultez notre guide de dépannage

personnaliser les navigateurs disponibles

parfois, vous voudrez peut-être modifier la liste des navigateurs trouvés avant d’exécuter les tests.,

par exemple, votre application web peut uniquement être conçue pour fonctionner dans un navigateur Chrome, et non dans le navigateur Electron.

dans le fichier plugins, vous pouvez filtrer la liste des navigateurs passés à l’intérieur de l’objet configet renvoyer la liste des navigateurs que vous souhaitez sélectionner pendant cypress open.

lorsque vous ouvrez le test Runner dans un projet qui utilise les modifications ci-dessus à votre fichier de plugins, seuls les navigateurs Chrome trouvés sur le système s’afficheront dans la liste des navigateurs disponibles.,

Si vous revenez d’une liste vide de navigateurs ou browsers: null, la liste par défaut sera automatiquement restauré.

Si vous avez installé un navigateur basé sur Chromium comme Brave, Vivaldi, vous pouvez les ajouter à la liste des navigateurs retournés. Voici un fichier de plugins qui insère un navigateur Local Brave dans la liste renvoyée.

Une fois sélectionné, le navigateur Brave est détecté en utilisant la même approche que tout autre navigateur de la famillechromium.,

Si vous modifiez la liste des navigateurs, vous pouvez voir l’résolu de configuration dans l’onglet Paramètres du Test Runner.

navigateurs non pris en charge

de nombreux navigateurs tels que Safari et Internet Explorer ne sont actuellement pas pris en charge. La prise en charge de plus de navigateurs est sur notre feuille de route. Vous pouvez lire une explication sur notre future feuille de route cross browser ici.

environnement de navigateur

Cypress lance le navigateur d’une manière différente d’un environnement de navigateur ordinaire. Mais il se lance d’une manière qui, selon nous, rend les tests plus fiables et accessibles.,

lancement des navigateurs

lorsque Cypress va lancer votre navigateur, il vous donnera l’occasion de modifier les arguments utilisés pour lancer le navigateur.

Cela vous permet de faire des choses comme:

• Charger votre propre extension
• Activer ou désactiver des fonctionnalités expérimentales

Cette partie de l’API est décrite ici.

Cyprès Profil

Cyprès génère son propre profil isolé en dehors de votre navigateur profil., Cela signifie que les entréeshistory,cookies Et3rd party extensions de votre session de navigation habituelle n’affecteront pas vos tests dans Cypress.

attendez, j’ai besoin de mes extensions de développeur!

Ce n’est pas un problème – vous devez les réinstaller une fois dans le navigateur lancé par Cypress. Nous continuerons à utiliser ce profil de test Cypress lors des lancements ultérieurs afin que toute votre configuration soit préservée.,

barrières désactivées

Cypress désactive automatiquement certaines fonctionnalités du navigateur lancé par Cypress qui ont tendance à entraver les tests automatisés.

le navigateur Cypress a lancé automatiquement:

• ignore les erreurs de certificat.
• permet de bloquer les pop-ups.
• désactive L’enregistrement des mots de passe.
• désactive le remplissage automatique des formulaires et des mots de passe.
• désactive la demande de devenir votre navigateur principal.
• désactive les notifications de découverte de périphérique.
• Désactive les traductions.,
• désactive la restauration des sessions.
• désactive le trafic réseau en arrière-plan.
• désactive la limitation de l’arrière-plan et du moteur de rendu.
• désactive les invites demandant l’autorisation d’utiliser des appareils tels que des caméras ou des micros
• désactive les exigences de geste de l’utilisateur pour la lecture automatique des vidéos.

Vous pouvez voir tous les commutateurs de ligne de commande chrome par défaut que nous envoyons ici.

icône du navigateur

vous remarquerez peut-être que si vous avez déjà le navigateur ouvert, vous verrez deux des mêmes icônes de navigateur dans votre dock.,

Nous comprenons que lorsque Cyprès s’exécute dans son propre profil, il peut être difficile de faire la différence entre votre navigateur et de Cyprès.

pour cette raison, vous pouvez trouver le téléchargement et l’utilisation des versions du canal de publication d’un navigateur (Dev, Canary, etc.) utiles. Ces navigateurs ont des icônes différentes du navigateur stable standard, ce qui les rend plus distinguables. Vous pouvez également utiliser le navigateur Electron fourni, qui n’a pas d’icône de dock.,

de plus, dans les navigateurs basés sur Chrome, nous avons rendu le navigateur généré par Cypress différent des sessions ordinaires. Vous verrez un thème plus sombre autour du chrome le navigateur. Vous serez toujours en mesure de les distinguer visuellement.

dépannage

vous rencontrez des problèmes lors du lancement des navigateurs installés? En savoir plus sur le dépannage du lancement du navigateur