meteor
Testy akceptacyjne (z Nightwatch)

Uwagi

Obszar aplikacji

Na najbardziej podstawowym poziomie testowanie akceptacyjne to w zasadzie testowanie czarnej skrzynki, które zasadniczo dotyczy testowania wejść i wyjść systemu zamkniętego. W związku z tym istnieją trzy podstawowe cechy testowania akceptacji: lokalizacja zasobu, odczyt danych i zapis danych. Jeśli chodzi o przeglądarki i aplikacje internetowe, te trzy funkcje sprowadzają się zasadniczo do:

1. Załaduj stronę internetową lub widok aplikacji
2. Sprawdź elementy interfejsu użytkownika (tj. DOM)
3. Uruchom zdarzenie / symuluj interakcję użytkownika

Nazywamy to powierzchnią aplikacji. Obszar powierzchni to wszystko, co użytkownik widzi lub doświadcza. To zewnętrzna część systemu Blackbox. A ponieważ użytkownicy wchodzą w interakcję z nowoczesnymi aplikacjami internetowymi na ekranach wideo za pomocą przeglądarek internetowych, nasz zasięg powierzchni określają uniwersalne lokalizatory zasobów (adresy URL) i rzutnie. I tak, nasz pierwszy przewodnik zaczyna wyglądać mniej więcej tak:

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();
  }
};

Polecenia niestandardowe

Nightwatch obsługuje tworzenie niestandardowych poleceń, które mogą symulować naciśnięcia klawiszy, kliknięcia myszą i inne dane wejściowe. Niestandardowe polecenie można połączyć z innymi poleceniami Nightwatch, takimi jak:

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

Aby to włączyć, zdefiniuj polecenie w ./tests/nightwatch/commands/login w ./tests/nightwatch/commands/login sposób:

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.
};

Aby wszystko działało, musisz dodać atrybuty id do strony logowania. Na pewnym poziomie będzie musiał z grubsza wyglądać mniej więcej tak:

<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>

Sprawdzanie obiektów meteorologicznych na kliencie

Ponieważ Nightwatch ma dostęp do konsoli przeglądarki, możliwe jest sprawdzanie obiektów po stronie klienta za pomocą interfejsu API .execute() . W poniższym przykładzie sprawdzamy obiekt Session pod kątem określonej zmiennej sesji. Najpierw zaczynamy od utworzenia pliku ./tests/nightwatch/api/meteor/checkSession , w którym będziemy przechowywać następujące polecenie:

// 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;
};

Następnie możemy to połączyć w następujący sposób:

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

Formularze i typy wprowadzania

Aby przesłać plik, musisz najpierw utworzyć katalog / data i dodać plik, który chcesz przesłać.

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

Twój formularz będzie wymagał danych wejściowych z typem pliku. (Niektórym nie podoba się opcja stylizacji zapewniana przez te dane wejściowe; powszechnym wzorem jest ukrywanie tych danych wejściowych; aby inny przycisk na stronie był klikany w imieniu użytkownika).

<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>

Twoje testy będą wtedy musiały użyć setValue () i rozwiązać ścieżkę do lokalnego zasobu pliku.

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();
  }
};

Podziękowania dla Daniela Rineharta za zainspirowanie tego przykładu.

Komponenty i obiekty strony

Obiekty strony są podobne do poleceń niestandardowych; z wyjątkiem tego, że są to zbiory niestandardowych poleceń powiązanych z określonym składnikiem interfejsu użytkownika. Działa to wyjątkowo dobrze w przypadku nowoczesnego projektowania opartego na komponentach, takiego jak w 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]'
    }
  }
};

Jedynym zastrzeżeniem związanym z użyciem wzorca PageObject w testowaniu komponentów jest to, że implementacja przerywa verify.elementPresent łączenia metod, który zapewnia natywna verify.elementPresent Nightwatch. verify.elementPresent . Zamiast tego musisz przypisać obiekt strony do zmiennej i utworzyć nowy łańcuch metod dla każdej strony. Rozsądna cena za spójny i niezawodny wzorzec testowania ponownego użycia kodu.

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');
  },
}