Quelle est la meilleure façon d'utiliser le modèle de conception Selenium PageObject
Je crée des tests en utilisant Selenium 2 Web Driver avec C # .Net. Après avoir lu une grande partie de la documentation de Selenium, je ne suis toujours pas sûr de savoir comment procéder à l'aide des modèles de conception de PageObject.
De nombreux exemples Selenium ne sont présentés que dans Java et les liaisons API pour .Net ne sont pas toujours aussi similaires qu'on pourrait le penser en raison des limitations et des normes définies par certains langages.
Quelle est la meilleure façon d'utiliser le modèle de conception PageObject avec PageFactory dans .Net Selenium Web Driver?
Finalement, je veux que mes PageObjects gèrent plus de fonctionnalités, plutôt que mes tests NUnit en utilisant les PageObject IWebElements.
Vous trouverez ci-dessous un exemple de la façon dont je vais actuellement créer mes tests à l'avenir.
public class LoginPage
{
private IWebDriver webDriver;
[FindsBy(How = How.Id, Using = "ctl00_ctl00_ctl00_insideForm_insideForm_content_txtPassword")]
public IWebElement Password { get; set; }
[FindsBy(How = How.Id, Using = "ctl00_ctl00_ctl00_insideForm_insideForm_content_cmdSubmit")]
public IWebElement SubmitButton { get; set; }
[FindsBy(How = How.Id, Using = "ctl00_ctl00_ctl00_insideForm_insideForm_content_txtUserName")]
public IWebElement UserName { get; set; }
public LoginPage() { }
public LoginPage(IWebDriver webDriver)
{
this.webDriver = webDriver;
if(!webDriver.Url.Contains("Login.aspx"))
{
throw new StaleElementReferenceException("This is not the login page");
}
PageFactory.InitElements(webDriver, this);
}
public HomePage signIn(string username, string password)
{
UserName.SendKeys(username);
Password.SendKeys(password);
SubmitButton.Submit();
// Even if i create a NUnit test for this
// Issue with page loading still occures when I try and return new object
HomePage homePage = new HomePage(webDriver);
PageFactory.InitElements(webDriver, homePage);
return homePage;
}
}
En ce moment, c'est ce que je fais actuellement avec NUnit:
[TestFixture]
public class LoginPageTest : TestBase
{
private IWebDriver driver;
private LoginPage loginPage;
private HomePage homePage;
[SetUp]
[Description("Sets up the test fixture page objects and navigates to the login page.")]
public void SetUp()
{
driver = StartDriver();
Log.Info("Driver started");
driver.Navigate().GoToUrl("http://" + Environment + ");
loginPage = new LoginPage();
PageFactory.InitElements(driver, loginPage);
//driver.Navigate().Refresh();
}
[Test]
[Description("Enters invalid credentials and asserts that a correct error message is displayed.")]
public void SubmitFormInvalidCredentials()
{
loginPage.UserName.SendKeys("invalid");
loginPage.Password.SendKeys("invalid");
loginPage.SubmitButton.Click();
IWebElement invalidCredentials = driver.FindElement(By.Id("ctl00_ctl00_ctl00_insideForm_insideForm_ctl02_title"));
Assert.AreEqual("Invalid user name or password", invalidCredentials.Text);
}
[Test]
[Description("Enters valid credentials and asserts that the user is taken to the home page.")]
public void SubmitFormValidCredentials()
{
loginPage.UserName.SendKeys("valid");
loginPage.Password.SendKeys("valid");
loginPage.SubmitButton.Click();
homePage = new HomePage();
PageFactory.InitElements(driver, homePage);
Assert.AreEqual("pattest", homePage.Username.Text);
}
}
La plupart des articles et des articles de blog que je trouve pour les modèles de conception de sélecteurs Web Selenium dégagent des contradictions par rapport aux articles précédents que je trouve.
Alors, quelle est la bonne façon?
Pour couronner le tout, j'ai même essayé le modèle de conception PageObject.
[Test]
[Description("Login using PageObject Design Pattern")]
public void Login()
{
loginPage = new LoginPage(driver);
HomePage signIn = loginPage.SignIn("pattest", "pattest");
}
Dans ma page de connexion
public LoginPage(IWebDriver driver)
{
this.driver = driver;
if (!driver.Url.Contains("Login.aspx"))
{
throw new ElementNotFoundException("This is not the login page");
}
PageFactory.InitElements(driver, this);
}
public HomePage SignIn(string username, string password)
{
UserName.SendKeys(username);
Password.SendKeys(password);
SubmitButton.Click();
return new HomePage(driver);
}
Et, bien sûr, pour montrer comment ma HomePage doit être lancée avec son constructeur:
public HomePage(IWebDriver d)
{
webDriver = d;
// I need to use this as its not freaking waiting for my Page to load when I pass the webdriver in the consturctor.
var wait = new WebDriverWait(webDriver, TimeSpan.FromSeconds(60));
try
{
wait.Until(driver => driver.FindElement(By.Id("ctl00_ctl00_ctl00_insideForm_insideForm_loginStatus")));
}
catch(Exception e)
{
throw new ElementNotFoundException("This is not the home page.");
}
PageFactory.InitElements(webDriver, this);
}
Comment utiliser efficacement le modèle de conception WebDriver PageObject avec les tests. Je ne peux pas comprendre ça.
Utilisez PageFactory.InitElements(_driver, this); sur le constructeur de votre classe de page de base:
public class Page
{
public IWebDriver _driver;
public Page(IWebDriver driver)
{
this._driver = driver;
PageFactory.InitElements(_driver, this);
}
}
Veuillez consulter la documentation de PageFactory
Créez une classe Browser pour créer un pilote et des fonctions similaires telles que GoTo () pour la navigation et Teardown () pour fermer le navigateur. "
public class Browser
{
static IWebDriver webDriver = new FirefoxDriver();
//static IWebDriver webDriver = new ChromeDriver();
//InternetExplorerOptions options = new InternetExplorerOptions();
//static IWebDriver webDriver = new InternetExplorerDriver(@"C:\Program Files\Selenium\");
public static void GoTo(string url)
{
//webDriver.Manage().Timeouts().ImplicitlyWait(new TimeSpan(0, 0, 5));
webDriver.Url = url;
}
public static ISearchContext Driver
{
get { return webDriver; }
}
public static void Teardown()
{
webDriver.Quit();
}
public static void MaximizeWindow()
{
webDriver.Manage().Window.Maximize();
}
Créez des classes individuelles pour les pages et utilisez PageFactory pour initialiser les éléments.
public class Admin
{
public static AdminPage AdminPage
{
get
{
var adminpage = new AdminPage();
PageFactory.InitElements(Browser.Driver, adminpage);
return adminpage;
}
}
}
public class AdminPage
{
string Url = "http://172.18.12.225:4444/admin/admin.aspx";
string Title = "Login";
string Text = "Admin";
public void GoTo()
{
Browser.GoTo(Url);
}
public bool IsAt()
{
return Browser.Title == Title;
}
public bool Is_At()
{
return Browser.Title == Text;
}
[FindsBy(How = How.Id, Using = "ctl16_lblUdpSageMesageCustom")]
public IWebElement UpdateMessage { get; set; }
[FindsBy(How = How.Id, Using = "hypPreview")]
public IWebElement BackHomeLink { get; set; }
//Login
// [FindsBy(How = How.Id, Using = "ctl14_UserName")]
// public IWebElement UserNameLink { get; set; }
[FindsBy(How = How.Id, Using = "ctl14_Password")][CacheLookup]
public IWebElement PasswordLink { get; set; }
[FindsBy(How = How.Id, Using = "ctl14_LoginButton")][CacheLookup]
public IWebElement LoginLink { get; set; }
//Forgot Password
[FindsBy(How = How.Id, Using = "ctl14_hypForgotPassword")][CacheLookup]
public IWebElement FPWLink { get; set; }
[FindsBy(How = How.Id, Using = "ctl14_wzdForgotPassword_txtUsername")][CacheLookup]
public IWebElement FPWUserNameLink { get; set; }
[FindsBy(How = How.Id, Using = "ctl14_wzdForgotPassword_CaptchaValue")][CacheLookup]
public IWebElement FPWCaptchaLink { get; set; }
[FindsBy(How = How.Id, Using = "ctl14_wzdForgotPassword_StartNavigationTemplateContainerID_StartNextButton")][CacheLookup]
public IWebElement FPWNextLink { get; set; }
[FindsBy(How = How.Id, Using = "ctl14_wzdForgotPassword_StartNavigationTemplateContainerID_CancelButton")][CacheLookup]
public IWebElement FPWCancelLink { get; set; }
[FindsBy(How = How.Id, Using = "sfToppane")][CacheLookup]
public IWebElement TopPane { get; set; }
[FindsBy(How = How.Id, Using = "sidebar")][CacheLookup]
public IWebElement sidebar { get; set; }
//Role
//[FindsBy(How = How.Id, Using = "ctl19_rptDashBoard_ctl01_hypPageURL")]
//public IWebElement Role { get; set; }
//User
//[FindsBy(How = How.Id, Using = "ctl19_rptDashBoard_ctl02_hypPageURL")]
//public IWebElement User { get; set; }
public void LogIn(string Username, string Password)
{
Browser.MaximizeWindow();
IWebElement UserNameLink = Browser.WaitForElement(By.Id("ctl14_UserName"), 15);
UserNameLink.Click();
UserNameLink.Clear();
UserNameLink.SendKeys(Username);
PasswordLink.Click();
PasswordLink.Clear();
PasswordLink.SendKeys(Password);
LoginLink.Click();
}
}
Il s'agit d'un petit exemple avec une fonctionnalité de connexion. J'espère que cela pourrait aider même si une réponse tardive.
Je voudrais éviter les assertions dans les tests et m'en tenir à la méthode LoginPage.signIn, qui lèvera une exception en cas de connexion infructueuse. Je ne connais pas NUnit, mais je suppose qu'il prend en charge le comportement "prévu pour échouer".
Il est préférable de conserver votre logique dépendante de la page en un seul endroit (la classe de page).
Je suppose que vous devrez beaucoup modifier les tests de l'interface utilisateur Web à mesure que l'application principale évoluera de toute façon.