• WebAiiCheatSheet

WebAii (http://www.artoftest.com/) is a free, though not open source test framework for testing web applications. Like Watir/Watin/Watij, it works by driving the browser, either IE or Firefox. Like Watin, it allows writing your tests in C#. It can be run under NUnit, Visual Studio Team Test, or your own application.

TableOfContents

In this description, I'm using Windows XP Pro, Microsoft Visual C# 2008 version 9.0.20706.1 Beta2 Express Edition, NUnit version 2.4.4, WebAii version 1.0 RC2.

Installation & Hello Worl^H^H^H^H^H Google

1. Set things up similarly to that described in VisualStudioCheatSheet.

2. Add the ArtOfTest WebAii .dlls to the project references.

3. Copy ArtOfTest.WebAii.NUnitExtension.dll from C:\Program Files\ArtOfTest\WebAii 1.0 (RC2) to C:\Program Files\NUnit 2.4.4\bin\addins

   • In NUnit, under Tools -> Addins..., you should see WebAiiTestCaseBuilder

     • ??? The [http://www.artoftest.com/Resources/WebAii/Documentation/topicsindex.aspx?topic=usingnunit docs] show WebAiiTestFixtureBuilder, also. I don't see this addin.

4. Extend BaseNUnitTest for your test fixture. This gives you some convenience methods.

   • Oops! According to [http://www.artoftest.com/Resources/WebAii/Documentation/topicsindex.aspx?topic=usingnunit the docs] a template should be installed to do this for you. I didn't find that to be true--perhaps it's because I'm running the 'Express' edition of Visual Studio.

   1. Call Initialize() at the start of your test or in the SetUp method. This is part of BaseNUnitTest and does all the work of initializing the Manager.

   2. Call Manager.LaunchNewBrowser() to prepare a browser that your test will use to execute your tests.

      • This wasn't working for me. It launched the browser, but never "connected." I'm not sure if this is connecting the test runner to the browser instance, or something else. It waited for 60 seconds (the default timeout) before reporting the error.

        I posted a [http://artoftest.com/CommunitySite/forums/p/59/670.aspx#670 query] on the ArtOfTest User Forums. Apparently I was missing the [http://www.artoftest.com/Downloads/Support/vs_piaredist.exe Primary Interop Assemblies]. Installing that gave me a working test. I noted that the PIA installation (I think--I hadn't noticed this change before.) also installed new versions of the following:

        c:\WINDOWS\system32\kernel32.dll
        c:\WINDOWS\system32\user32.dll
        c:\WINDOWS\system32\shell32.dll
        c:\WINDOWS\system32\ntoskrnl.exe

   3. Use the ActiveBrowser to navigate to the desired page

   4. Assert things about the page that's returned.

   5. Call this.CleanUp() at the end of your test or in the TearDown method. This is part of BaseNUnitTest and releases all of the resources allocated during Initialize().

At this point, my test class is

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

using ArtOfTest.WebAii.Core;
using ArtOfTest.WebAii.ObjectModel;
using ArtOfTest.WebAii.TestTemplates;
using ArtOfTest.WebAii.TestAttributes;
using ArtOfTest.WebAii.Controls.HtmlControls;

using NUnit.Framework;


namespace WebAiiDemo
{
    [TestFixture]
    public class GoogleTests : BaseNUnitTest
    {
        [Test]
        public void TestNavigateToPage()
        {
            Initialize();

            // Launch an instance of the browser
            Manager.LaunchNewBrowser();

            // Navigate to google.com
            ActiveBrowser.NavigateTo("http://www.google.com");

            // verify the title is actually google.
            Assert.AreEqual("Google", ActiveBrowser.Find.ByTagIndex("title", 0).InnerText);
            this.CleanUp();
        }
    }
}

SetUp and TearDown

Let's extract the common stuff in preparation for other expectations on this page:

namespace WebAiiDemo
{
    [TestFixture]
    public class GoogleTests : BaseNUnitTest
    {
        [Test]
        public void TestNavigateToPage()
        {
            // verify the title is actually google.
            Assert.AreEqual("Google", ActiveBrowser.Find.ByTagIndex("title", 0).InnerText);
        }

        [SetUp]
        public void SetUp()
        {
            Initialize();
            // Launch an instance of the browser
            Manager.LaunchNewBrowser();
            // Navigate to google.com
            ActiveBrowser.NavigateTo("http://www.google.com");
        }

        [TearDown]
        public void TearDown()
        {
            this.CleanUp();
        }
    }
}

This allows us to easily create new tests for the page:

        [Test]
        public void VerifyTitleByTagIndex()
        {
            Assert.AreEqual("Google", ActiveBrowser.Find.ByTagIndex("title", 0).InnerText);
        }

        [Test]
        public void VerifyTitleByXpath()
        {
            Assert.AreEqual("Google", ActiveBrowser.Find.ByXPath("//title").InnerText);
        }

ToBeWritten ...

CategoryCheatSheet