Avvio dei browser / Documentazione di Cypress

Quando esegui test in Cypress, lanciamo un browser per te. Ciò ci consente di:

1. Creare un ambiente di test pulito e incontaminato.
2. Accedere alle API del browser privilegiate per l’automazione.,

Browser

Quando il Cipresso è inizialmente eseguire il Test Runner, è possibile scegliere di eseguire il Cipresso in un numero selezionato di browser tra cui:

• Canarie
• Chrome
• Chromium
• Edge
• Edge Beta
• Edge Canarie
• Edge Dev
• Elettrone
• Firefox
• Firefox Developer Edition
• Firefox Nightly

Cipresso rileva automaticamente i browser disponibili sul vostro sistema operativo., Puoi cambiare il browser nel Test Runner utilizzando il menu a discesa nell’angolo in alto a destra:

Scarica la versione specifica di Chrome

Il browser Chrome è sempreverde, il che significa che si aggiornerà automaticamente, a volte causando un cambiamento di rottura nei test automatici. Ospitiamo chromium.cypress.io con i link per scaricare una specifica versione rilasciata di Chrome (dev, Canary e stable) per ogni piattaforma.

Electron Browser

Oltre ai browser presenti sul tuo sistema, noterai che Electron è un browser disponibile., Il browser Electron è una versione di Chromium che viene fornito con Electron.

Il browser Electron ha il vantaggio di venire cotto in Cypress e non ha bisogno di essere installato separatamente.

Per impostazione predefinita, quando si eseguecypress run dalla CLI, lanceremo Electron senza testa.

Puoi anche lanciare Electron intestato:

cypress run --headed

Perché Electron è il browser predefinito – in genere viene eseguito in CI. Se si riscontrano errori in CI, per eseguirli facilmente è possibile eseguirli localmente con l’opzione --headed.,

Browser Chrome

Tutti i browser Chrome* aromatizzati verranno rilevati e sono supportati sopra Chrome 64.

Puoi lanciare Chrome in questo modo:

cypress run --browser chrome

Per utilizzare questo comando in CI, devi installare il browser che desideri o utilizzare una delle nostre immagini docker.

Per impostazione predefinita, lanceremo Chrome in modalità intestata. Per eseguire Chrome senza testa, è possibile passare l’argomento --headless a cypress run.,

È anche possibile avviare il Cromo:

cypress run --browser chromium

O Chrome Canary:

cypress run --browser chrome:canary

O Microsoft Bordo (Cromo-based):

cypress run --browser edge

O Microsoft Bordo Canarie (Cromo-based):

cypress run --browser edge:canary

Firefox

Firefox-famiglia di browser sono supportati da Cipressi.,

È possibile avviare Firefox in questo modo:

cypress run --browser firefox

O Firefox Developer/Nightly Edition:

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

Per utilizzare questo comando in CI, è necessario installare questi altri browser – o utilizzare una delle nostre immagini docker.

Per impostazione predefinita, lanceremo Firefox in modalità intestata. Per eseguire Firefox senza testa, è possibile passare l’argomento --headless a cypress run.,

Avvio da un percorso

È possibile avviare qualsiasi browser supportato specificando un percorso al binario:

cypress run --browser /usr/bin/chromium

cypress open --browser /usr/bin/chromium

Cypress rileverà automaticamente il tipo di browser fornito e avviarlo per voi.

Vedere la guida della riga di comando per ulteriori informazioni sugli argomenti--browserHai problemi a lanciare un browser? Consulta la nostra guida alla risoluzione dei problemi

Personalizza i browser disponibili

A volte potresti voler modificare l’elenco dei browser trovati prima di eseguire i test.,

Ad esempio, l’applicazione Web potrebbe essere progettata solo per funzionare in un browser Chrome e non all’interno del browser Electron.

Nel file plugins, è possibile filtrare l’elenco dei browser passati all’interno dell’oggetto confige restituire l’elenco dei browser che si desidera disponibili per la selezione durante cypress open.

Quando si apre il Test Runner in un progetto che utilizza le modifiche di cui sopra al file plugins, solo i browser Chrome trovati sul sistema verranno visualizzati nell’elenco dei browser disponibili.,

Se si restituisce un elenco vuoto di browser obrowsers: null, l’elenco predefinito verrà ripristinato automaticamente.

Se hai installato un browser basato su Chromium come Brave, Vivaldi puoi aggiungerli all’elenco dei browser restituiti. Ecco un file plugins che inserisce un browser Brave locale nell’elenco restituito.

Una volta selezionato, il browser Brave viene rilevato utilizzando lo stesso approccio di qualsiasi altro browser della famiglia chromium.,

Se si modifica l’elenco dei browser, è possibile visualizzare la configurazione risolta nella scheda Impostazioni del Test Runner.

Browser non supportati

Molti browser come Safari e Internet Explorer non sono attualmente supportati. Il supporto per più browser è sulla nostra tabella di marcia. Puoi leggere una spiegazione sulla nostra futura roadmap cross browser qui.

Ambiente browser

Cypress avvia il browser in un modo diverso da un normale ambiente browser. Ma si lancia in un modo che crediamo rende il test più affidabile e accessibile.,

Avvio dei browser

Quando Cypress va a lanciare il tuo browser, ti darà l’opportunità di modificare gli argomenti utilizzati per avviare il browser.

Questo ti permette di fare cose come:

• Carica la tua estensione
• Abilita o disabilita le funzionalità sperimentali

Questa parte dell’API è documentata qui.

Cypress Profile

Cypress genera il proprio profilo isolato a parte il normale profilo del browser., Ciò significa che cose come history voci, cookies e 3rd party extensions dalla tua normale sessione di navigazione non influenzeranno i tuoi test in Cypress.

Aspetta, ho bisogno delle mie estensioni per sviluppatori!

Non è un problema: devi reinstallarli una volta nel browser lanciato da Cypress. Continueremo a utilizzare questo profilo di test Cypress nei lanci successivi in modo che tutta la configurazione venga preservata.,

Barriere disabilitate

Cypress disabilita automaticamente alcune funzionalità nel browser lanciato da Cypress che tendono a ostacolare i test automatici.

Il Cypress ha avviato automaticamente il browser:

• Ignora gli errori del certificato.
• Permette bloccato pop-up.
• Disabilita ‘Salvataggio delle password’.
• disabilita ‘Compilazione automatica di moduli e password’.
• disabilita la richiesta di diventare il tuo browser principale.
• Disabilita le notifiche di rilevamento del dispositivo.
• Disabilita le traduzioni linguistiche.,
• Disabilita il ripristino delle sessioni.
• Disabilita il traffico di rete in background.
• Disabilita la limitazione dello sfondo e del renderer.
• Disabilita i prompt che richiedono l’autorizzazione all’uso di dispositivi come fotocamere o microfoni
• Disabilita i requisiti gestuali dell’utente per la riproduzione automatica dei video.

Puoi vedere tutte le opzioni predefinite della riga di comando di Chrome che inviamo qui.

Icona del browser

Potresti notare che se hai già il browser aperto vedrai due delle stesse icone del browser nel tuo dock.,

Comprendiamo che quando Cypress è in esecuzione nel proprio profilo può essere difficile distinguere tra il normale browser e Cypress.

Per questo motivo potresti trovare utile scaricare e utilizzare le versioni del canale di rilascio di un browser (Dev, Canary, ecc.). Questi browser hanno icone diverse dal browser stabile standard, rendendoli più distinguibili. È inoltre possibile utilizzare il browser Electron in bundle, che non ha un’icona dock.,

Inoltre, nei browser basati su Chrome, abbiamo reso il browser generato da Cypress diverso dalle sessioni regolari. Vedrai un tema più scuro intorno al chrome del browser. Sarete sempre in grado di distinguere visivamente questi.

Risoluzione dei problemi

Problemi con l’avvio dei browser installati? Ulteriori informazioni sulla risoluzione dei problemi di avvio del browser