meteor
Test di accettazione (con Nightwatch)

Osservazioni

Area della superficie dell'app

Al suo livello più elementare, il test di accettazione è essenzialmente un test black-box, che è fondamentalmente interessato a testare gli input e gli output di un sistema chiuso. Come tale, ci sono tre caratteristiche essenziali per il test di accettazione: localizzazione di una risorsa, lettura di dati e scrittura di dati. Quando si tratta di browser e webapp, queste tre funzionalità si riducono sostanzialmente a quanto segue:

1. Carica una pagina Web o una vista applicazione
2. Ispezionare gli elementi dell'interfaccia utente (es. DOM)
3. Attiva un evento / simula un'interazione dell'utente

Chiamiamo questa la superficie dell'applicazione. L'area di superficie è tutto ciò che un utente vede o sperimenta. È l'esterno di un sistema blackbox. E dal momento che gli utenti interagiscono con le moderne applicazioni Web su schermi video che utilizzano browser web, la nostra copertura di superficie è definita da Universal resource locator (URL) e viewport. E così il nostro primo walkthrough inizia con qualcosa di simile al seguente:

module.exports = {
  "Hello World" : function (client) {
    client
      // the location of our Meteor app
      .url("http://localhost:3000")

      // the size of the viewport 
      .resizeWindow(1024, 768)

      // test app output
      .verify.elementPresent('h1')
      .verify.containsText('h1', "Welcome to Meteor!")
      .verify.containsText('p', "You've pressed the button 0 times")
      .verify.elementPresent('button')

      // simulate user input
      .click('button').pause(500)

      // test app output again, to make sure input worked
      .verify.containsText('p', "button 1 times")

      // saving a copy of our viewport pixel grid
      .saveScreenshot('tests/nightwatch/screenshots/homepage.png')
      .end();
  }
};

Comandi personalizzati

Nightwatch supporta la creazione di comandi personalizzati in grado di simulare sequenze di tasti, clic del mouse e altri input. Un comando personalizzato può essere incatenato con altri comandi di Nightwatch, in questo modo:

module.exports = {
  "Login App" : function (client) {
    client
      .url("http://localhost:3000")
      .login("[email protected]", "janedoe123")
      .end();
  }
};

Per abilitarlo, definire un comando in ./tests/nightwatch/commands/login in ./tests/nightwatch/commands/login modo:

exports.command = function(username, password) {

  this
    .verify.elementPresent('#login')

      // we clear the input in case there's any data remaining from previous visits
      .clearValue("#emailInput")
      .clearValue("#passwordInput")

      // we simulate key presses
      .setValue("#emailInput", username)
      .setValue("#passwordInput", password)

    // and we simulate a mouse click
    .click("#signInToAppButton").pause(1000)

  return this; // allows the command to be chained.
};

Per far sì che tutto funzioni, dovrai aggiungere gli attributi id alla tua pagina di accesso. A un certo livello, avrà bisogno di approssimativamente qualcosa di simile al seguente:

<template name="login">
  <div id="login">
    <input id="emailInput" name="email" type="email" />
    <input id="passwordInput" name="password" type="password" />
    <button id="#signInToAppButton">Sign In</button>
  </div>
</template>

Ispezione degli oggetti Meteor sul client

Poiché Nightwatch ha accesso alla console del browser, è possibile ispezionare gli oggetti lato client utilizzando l'API .execute() . Nel seguente esempio, stiamo controllando l'oggetto Session per una particolare variabile di sessione. Innanzitutto, iniziamo creando il file ./tests/nightwatch/api/meteor/checkSession , dove manterremo il seguente comando:

// syncrhonous version; only works for checking javascript objects on client
exports.command = function(sessionVarName, expectedValue) {
  var client = this;
  this
    .execute(function(data){
      return Session.get(data);
    }, [sessionVarName], function(result){
      client.assert.ok(result.value);
      if(expectedValue){
        client.assert.equal(result.value, expectedValue);
      }
    })
    return this;
};

Possiamo quindi concatenarlo in questo modo:

module.exports = {
  "Check Client Session" : function (client) {
    client
      .url("http://localhost:3000")
      .checkSession("currentUser", "Jane Doe")
      .end();
  }
};

Forme e tipi di input

Per caricare un file, devi prima creare una directory / data e aggiungere il file che desideri caricare.

tests/nightwatch/data/IM-0001-1001.dcm

Il tuo modulo avrà bisogno di un input con tipo di file. Ad alcune persone non piacciono le opzioni di stile fornite da questo input, e un modello comune consiste nel rendere questo input nascosto e per fare in modo che un altro pulsante nella pagina faccia clic su di esso per conto dell'utente.

<form id="myform">
    <input type="file" id="fileUpload">
    <input type="text" name="first_name">
    <input type="text" name="last_name">

    <input type="date" name="dob_month">
    <input type="date" name="dob_day">
    <input type="date" name="dob_year">

    <input type="radio" name="gender" value="M">
    <input type="radio" name="gender" value="F">
    <input type="radio" name="gender" value="O">

    <input type="select" name="hs_graduation_year">
    <input type="text" name="city">
    <input type="select" name="state">

    <input type="submit" name="submit" value="Submit">
</form>

I test dovranno quindi utilizzare setValue () e risolvere il percorso della risorsa file locale.

module.exports = {
  "Upload Study" : function (client) {
    console.log(require('path').resolve(__dirname +  '/../data' ));

    var stringArray = "Chicago";

    client
      .url(client.globals.url)
      .verify.elementPresent("form#myform")

      // input[type="file"]
      .verify.elementPresent("input#fileUpload")
      .setValue('input#fileUpload', require('path').resolve(__dirname + '/../data/IM-0001-1001.dcm'))

      // input[type="text"]
      .setValue('input[name="first_name"]', 'First')
      .setValue('input[name="last_name"]', 'Last')

      // input[type="date"]
      .click('select[name="dob_month"] option[value="3"]')
      .click('select[name="dob_day"] option[value="18"]')
      .click('select[name="dob_year"] option[value="1987"]')

      // input[type="radio"]
      .click('input[name="gender"][value="M"]')

      // input[type="number"]
      .click('select[name="hs_graduation_year"] option[value="2002"]')

      // input[type="text"]
      // sometimes Nightwatch will send text faster than the browser can handle
      // which will cause skipping of letters.  In such cases, we need to slow
      // Nightwatch down; which we do by splitting our input into an array
      // and adding short 50ms pauses between each letter
      for(var i=0; i < userIdArray.length; i++) {
        client.setValue('input[name="city"]', stringArray[i]).pause(50)
      }

      // input[type="select"]
      // after an array input above, we need to resume our method chain...
      client.click('select[name="state"] option[value="CA"]')

      // input[type="number"]
      .setValue('input[name="zip"]', '01234')

      //input [ type="submit" ]
      .click('button[type="submit"]')
      .end();
  }
};

Ringraziamo Daniel Rinehart per aver ignorato questo esempio.

Componenti e oggetti della pagina

Gli oggetti Page sono simili ai comandi personalizzati; tranne che sono raccolte di comandi personalizzati associati a un componente dell'interfaccia utente specifico. Questo funziona molto bene con il moderno design basato sui componenti, come in React.

module.exports = {
  url: 'http://localhost:3000/login',
  commands: [{
  login: function(email, password) {
    return this
      .clearValue('input[name="emailAddress"]')
      .clearValue('input[name="password"]')

      .setValue('input[name="emailAddress"]', email)
      .setValue('input[name="password"]', password)

      .verify.elementPresent('#loginButton')
      .click("#loginButton");
  },
  clear: function() {
    return this
      .waitForElementVisible('@emailInput')
      .clearValue('@emailInput')
      .clearValue('@passInput')
      .waitForElementVisible('@loginButton')
      .click('@loginButton')
  },
  checkElementsRendered: function(){
    return this
      .verify.elementPresent("#loginPage")
      .verify.elementPresent('input[name="emailAddress"]')
      .verify.elementPresent('input[name="password"]')
  },
  pause: function(time, client) {
    client.pause(time);
    return this;
  },
  saveScreenshot: function(path, client){
    client.saveScreenshot(path);
    return this;
  }
}],
  elements: {
    emailInput: {
      selector: 'input[name=email]'
    },
    passInput: {
      selector: 'input[name=password]'
    },
    loginButton: {
      selector: 'button[type=submit]'
    }
  }
};

L'unica avvertenza con l'utilizzo del pattern PageObject nei componenti di test è che l'implementazione interrompe il metodo che concatena il flusso verify.elementPresent nativo Nightwatch verify.elementPresent . Invece, dovrai assegnare l'oggetto pagina a una variabile e creare un'istanza per una nuova catena di metodi per ogni pagina. Un prezzo ragionevole da pagare per un modello coerente e affidabile per testare il riutilizzo del codice.

module.exports = {
  tags: ['accounts', 'passwords', 'users', 'entry'],
  'User can sign up.': function (client) {

    const signupPage = client.page.signupPage();
    const indexPage = client.page.indexPage();

    client.page.signupPage()
      .navigate()
      .checkElementsRendered()
      .signup('Alice', 'Doe', '[email protected]', 'alicedoe')
      .pause(1500, client);

    indexPage.expect.element('#indexPage').to.be.present;
    indexPage.expect.element('#authenticatedUsername').text.to.contain('Alice Doe');
  },
}