Cosa è Cucumber File di funzionalità e definizione dei passaggi? (Esempio)

⚡ Riepilogo intelligente

Cucumber I file delle funzionalità descrivono il comportamento in linguaggio Gherkin semplice, mentre le definizioni dei passaggi contengono il codice che esegue ogni riga. Ogni Cucumber Il progetto necessita di entrambi, memorizzati in una struttura di cartelle fissa all'interno di una directory delle funzionalità.

  • 🔘 Due file: Un file di funzionalità specifica cosa dovrebbe accadere; un file di definizione dei passaggi specifica come l'automazione lo realizza.
  • ☑️ Parole chiave del cetriolino: Caratteristica, Scenario, Dato, Quando e Quindi danno a uno scenario la sua struttura e la sua forma leggibile.
  • ✅ Niente due punti sui gradini: Feature e Scenario richiedono i due punti, mentre Given, When e Then non devono, altrimenti il ​​passaggio viene ignorato.
  • 🧪 Set di dati: La sezione "Scenario Outline" e la tabella "Esempi" riproducono uno scenario confrontandolo con numerose righe di input.
  • ️ Configurazione condivisa: Lo sfondo solleva ripetutamente i passaggi dati fuori da ogni scenario in una funzionalità.
  • 📊 Corrispondenza: Cucumber Ignora la parola chiave durante la corrispondenza, quindi due passaggi potrebbero non condividere mai lo stesso testo.

Cucumber Definizione di file di funzionalità e step spiegata con un esempio

Per ogni progetto Cucumber, nella directory principale del progetto è presente una singola directory denominata "features". È qui che risiedono tutte le funzionalità di Cucumber. All'interno di questa directory si trovano ulteriori directory, ovvero step_definition e support.

Quel layout è importante perché Cucumber Il sistema individua i file in base alle convenzioni anziché alla configurazione. Un file di funzionalità che si trova al di fuori della directory delle funzionalità non viene mai letto.

Che cos'è il "File funzionalità"?

Il file delle funzionalità contiene una descrizione di alto livello del file Scenario di prova in linguaggio semplice. È noto come CetriolinoGherkin è un linguaggio di testo semplice in inglese.

Cucumber Il file delle funzionalità è composto dai seguenti componenti:

  • Caratteristica: Una funzionalità descriverebbe lo script di test corrente che deve essere eseguito.
  • Scenario: Lo scenario descrive i passaggi e il risultato atteso per un particolare caso di test.
  • Schema dello scenario: lo stesso scenario può essere eseguito per più set di dati utilizzando la struttura dello scenario. I dati sono forniti da una struttura tabellare separata da (II).
  • Dato: Specifica il contesto del testo da eseguire. Utilizzando le tabelle dati “Given”, è anche possibile parametrizzare il passo.
  • Quando: “Quando” specifica l’azione di test che deve essere eseguita.
  • Poi: L'esito atteso del test può essere rappresentato da “Allora”.

Ogni file contiene una singola funzionalità. Gli scenari sottostanti sono esempi concreti che illustrano la funzionalità, e ogni scenario segue lo stesso schema: descrivere il contesto iniziale, descrivere un evento, descrivere il risultato atteso.

Successivamente, impareremo come scrivere Feature File Cucumber con esempio.

Esempio di file di funzionalità di esempio:

L'esempio originale pubblicato con questo tutorial è riprodotto qui di seguito esattamente come è stato scritto.

Feature: Visit career guide page in career.guru99.com
Scenario: Visit career.guru99.com
Given: I am on career.guru99.com
When: I click on career guide menu
Then: I should see career guide page

⚠️ Correzione: l'esempio sopra posiziona i due punti dopo Dato, Quando and Poi. Gherkin mette i due punti dopo Caratteristica and Scenario solo. Una parola chiave step seguita da due punti non viene interpretata come uno step, quindi Cucumber ignora silenziosamente la riga. Il file corretto è il seguente.

Feature: Visit career guide page in career.guru99.com

  Scenario: Visit career.guru99.com
    Given I am on career.guru99.com
    When I click on career guide menu
    Then I should see career guide page

L'indentazione non è richiesta dal parser, ma due spazi per livello sono lo stile convenzionale e rendono molto più facile la scansione di un file di feature lungo. L'animazione qui sotto mostra l'elaborazione di un file di feature e ogni passaggio che diventa verde man mano che viene completato.

Animazione di un Cucumber file di funzionalità in esecuzione con ogni passaggio Gherkin segnalato a sua volta

Cos'è la “definizione del passo”?

La definizione del passaggio mappa i passaggi del test case nei file delle funzionalità (introdotti da Given/When/Then) al codice. Esegue i passaggi sull'applicazione in fase di test e controlla i risultati rispetto ai risultati attesi. Affinché la definizione di un passo possa essere eseguita, deve corrispondere al componente specificato in una funzione. La definizione del passo è definita nei file Ruby in "features/step_definitions/*_steps.rb".

La corrispondenza viene effettuata basandosi esclusivamente sul testo del passaggio. Cucumber non tiene conto della parola chiave quando cerca una definizione, motivo per cui due passaggi nella stessa suite potrebbero non avere mai lo stesso testo, anche se uno è un Dato e l'altro un Allora.

Esempio di definizione del passo: Qui useremo sopra Cucumber Esempio di file di funzionalità per la navigazione su career.guru99.com. Utilizzeremo funzionalità come "Quando, Allora, Dato" come mostrato di seguito. Cucumber Esempi di file di funzionalità.

Step 1:

Given (/^ I am on career.guru99.com$/) do

Browser.goto "http://career.guru99.com" -This will visit career.guru99 on browser

end

Step 2:
When (/^ click on career guide menu$/) do

Browser.text (:name, " career guide" ).click – This will click "career guide menu"

end

Step 3:

Then (/^ I should see career guide page$/) do

Browser.goto "http://career.guru99.com/category/career-guide/" - It will visit "career guide page"

end

⚠️ Nota sulle lingue: le definizioni sopra sono Ruby, che è dove Cucumber avviato ed è per questo che la cartella si chiama step_definitions e i file terminano in _steps.rb. Lo stesso file di funzionalità guida le definizioni dei passaggi scritte in Java, Javasceneggiatura, Python o C# senza apportare alcuna modifica al Gherkin. In Cucumber-JVM l'espressione regolare si sposta in un'annotazione su un metodo:

@Given("I am on career.guru99.com")
public void i_am_on_the_career_page() {
    driver.get("http://career.guru99.com");
}

Qualunque linguaggio tu scelga, la definizione del passaggio è l'unico posto in cui devono essere inseriti i dettagli di implementazione. Keeping I selettori e le chiamate HTTP dal file delle funzionalità sono ciò che permette a un non programmatore di leggere lo scenario. prima di tutto Cucumber copione Questa guida illustra la realizzazione di questa combinazione dall'inizio alla fine.

Descrizione dello scenario ed esempi in un file di funzionalità

Copiare uno scenario tre volte per modificare un singolo valore è il modo più comune in cui un file di funzionalità diventa illeggibile. Schema dello scenario sostituisce le copie con un modello e un Esempi la tabella fornisce i valori.

I parametri sono scritti tra parentesi angolari e devono corrispondere all'intestazione di colonna nella tabella sottostante. Cucumber sostituisce i valori prima di cercare una definizione di passaggio corrispondente, quindi le definizioni stesse non necessitano di alcuna gestione speciale.

Scenario Outline: Search the career guide
  Given I am on career.guru99.com
  When I search for "<keyword>"
  Then I should see the <section> section

  Examples:
    | keyword   | section       |
    | interview | Interview Tips|
    | resume    | Resume Guide  |

Ecco alcuni punti importanti da tenere a mente quando si utilizzano gli schemi:

  • La struttura viene eseguita una volta per ogni riga di dati. La prima riga è l'intestazione e non viene mai eseguita.
  • Una sezione di descrizione dello scenario deve essere seguita da almeno una sezione di esempi, altrimenti non funziona nulla.
  • Non è necessario che i tubi del tavolo siano allineati, sebbene allinearli mantenga il file leggibile.
  • Mantieni la tabella piccola. Una tabella con trenta righe è solitamente un segno che i dati appartengono a una test basato sui dati anziché.

Contesto, E, Ma e le altre parole chiave del cetriolino

Oltre ai sei componenti elencati in precedenza, Gherkin dispone di alcune parole chiave che mantengono leggibili i file di funzionalità più lunghi.

  • sfondo — un blocco di passaggi Given che viene eseguito prima di ogni scenario nella funzionalità. Elimina la ripetizione della stessa precondizione all'inizio di ogni scenario.
  • E altre ancora… and Ma — sostituti per un Given, When o Then ripetuto. Sono più leggibili e si comportano in modo identico; Cucumber corrispondenze sul testo del passaggio in entrambi i sensi.
  • Regola — un gruppo facoltativoping, aggiunto in Gherkin 6, che raccoglie gli scenari che illustrano una regola aziendale.
  • Stringhe di documenti — un blocco di testo racchiuso tra tre virgolette doppie, passato alla definizione del passo come singolo argomento quando una riga non è sufficiente.
  • Tabelle dati — righe separate da barra verticale collegate a un singolo passaggio, utilizzate per passare un elenco di valori a tale passaggio.
  • Tags — etichette che iniziano con una chiocciola, posizionate sopra una Funzionalità o uno Scenario in modo che sia possibile selezionarne un sottoinsieme in fase di esecuzione.
  • Commenti — una riga che inizia con un cancelletto. I commenti sono consentiti solo all'inizio di una riga e Gherkin non supporta i commenti a blocco.

Nel complesso, un file di funzionalità con configurazione condivisa si presenta così:

Feature: Career guide navigation

  Background:
    Given I am on career.guru99.com

  Scenario: Open the career guide menu
    Given I am signed in
    And my profile is complete
    When I click on career guide menu
    Then I should see career guide page
    But I should not see the admin panel

Errori comuni nei file di funzionalità e come risolverli

ponte Cucumber I problemi segnalati dai principianti non sono difetti del framework. Si tratta di piccole violazioni delle regole di Gherkin che si verificano silenziosamente.

Errore Che succede Fissare
Due punti dopo Dato, Quando o Allora La riga non viene riconosciuta come un passaggio e viene saltata Utilizzare i due punti solo dopo Feature e Scenario
Due passaggi con testo identico Cucumber li considera duplicati perché la parola chiave viene ignorata Riformulare un passaggio in modo che i due abbiano un significato diverso.
File delle funzionalità al di fuori della directory delle funzionalità Il file non viene mai rilevato e non vengono eseguiti test Conserva ogni .feature file nella cartella delle funzionalità
Quindici passaggi in uno scenario Lo scenario smette di funzionare come documentazione Punta a tre o cinque passaggi e inserisci i dettagli nella definizione di ciascun passaggio.
Quindi esegue delle asserzioni su una riga del database Il test ha esito positivo, mentre il comportamento visibile all'utente è errato. Asserisci sull'output osservabile come la pagina o la risposta
Schema di scenario senza tabella di esempi Il modello non viene mai eseguito Aggiungi una sezione Esempi direttamente sotto la struttura

Risolvere questi problemi prima che la suite cresca è molto più economico che risolverli in seguito, perché ogni scenario scritto nel frattempo copia la stessa forma. Una volta che i file delle funzionalità si comportano correttamente, il passo successivo è cablare il progetto: vedere il Cucumber installazione guida passo passo e il più ampio test di automazione serie.

DOMANDE FREQUENTI

No. Un file .feature può dichiarare esattamente una Feature, sebbene possa contenere un numero illimitato di scenari. Se hai bisogno di una seconda Feature, crea un secondo file: questa limitazione è ciò che rende la cartella navigabile man mano che la suite si espande.

No. Gherkin è localizzato in oltre settanta lingue. Aggiungendo un'intestazione di lingua alla prima riga del file, le parole chiave vengono modificate, consentendo a un team di scrivere scenari nella stessa lingua parlata dai suoi esperti di dominio.

Contiene tutto ciò che non è una definizione di passaggio: configurazione dell'ambiente, configurazione del browser, hook che vengono eseguiti prima o dopo uno scenario e codice helper condiviso. Keeping separa i file di definizione dei passaggi di arresto impedendo che si trasformino in un file inutileping terra.

Cucumber Il sistema segnala il passaggio come non definito anziché fallito e stampa un frammento di codice suggerito che è possibile incollare in un file di definizione dei passaggi. Lo scenario viene contrassegnato come non superato, quindi un passaggio non definito non viene mai automaticamente conteggiato come successo.

Un tag posizionato sopra una Feature o uno Scenario consente all'esecutore di selezionare un sottoinsieme al momento dell'esecuzione, indipendentemente dalla struttura delle cartelle. I team solitamente etichettano un set di test di base, un set di test di test più lenti e un set di test in corso, quindi eseguono solo ciò che è necessario per una determinata fase della pipeline.

I modelli linguistici di grandi dimensioni elaborano Gherkin a partire da un criterio di accettazione efficace e generano gli scheletri di definizione corrispondenti ancora più rapidamente. RevEsamina l'output per individuare testi di passaggio duplicati e scenari che rivelano dettagli di implementazione, ovvero i punti in cui il codice Gherkin generato solitamente presenta degli errori.

Molto. Dato un file di funzionalità aperto, Copilot deduce l'espressione regolare e la firma del metodo per uno step non definito e completa il corpo a partire dal codice circostante. Consideratelo una prima bozza; le asserzioni che propone necessitano ancora di una verifica umana.

Sì, ed è proprio questo il punto della progettazione. Le definizioni risiedono in una cartella condivisa e vengono abbinate in base al testo, non al file, quindi un passaggio di accesso scritto una volta viene riutilizzato da ogni funzionalità che ne ha bisogno. Il riutilizzo è il motivo per cui è vietato duplicare il testo dei passaggi.

Riassumi questo post con: