SWD.Starter：C＃+ Selenium WebDriver + PageObjectsのUIテストのクイックスタートオートメーション

この記事では、Selenium WebDriverおよびPageObjectsパターンとともに、C＃自動ユーザーインターフェイステストフレームワークのセットアップ方法を説明します。



オープンソースのスターターキット-SWD.Starter-は、10分で最初のテストを記述して実行するのに役立ちます。 さらに、優れたテスト自動化プラクティスに基づいたフレームワークアーキテクチャを提供します。

すべてのSWD.Starterコードは、ニーズに合わせて完全にカスタマイズできます。

SWD.Starterとは何ですか？

SWD.Starterは、テスト自動化フレームワークのスターターキットです。 すべてのソースコードはGitHubで入手できます： dzhariy / SWD.Starter 。プロジェクトライセンス（ライセンスなし）を使用すると、ソースコードを好きなように使用でき、少なくとも販売できます。



SWD.Starterは、Selenium WebDriverを介してユーザーインターフェイステストの作成と実行を開始するために必要なすべてのインフラストラクチャコードを含む既に構成されたプロジェクトです。



SWD.Starterは、PageObjectsパターンの使用を強くお勧めします。 また、このパターンを使用する場合、美しいアーキテクチャとコードの可読性を維持しながら、新しい自動テストコードを非常に高速に作成できます。

始めるために必要なもの

プロジェクトを開始するには、次のソフトウェアが必要です。

1. Visual Studio Express 2013 Desktop Edition（理論的には、VS2010とVS2012もサポートされています）
2. GithubからプロジェクトをポンピングするためのGit
3. プロジェクトの公式ページからダウンロードできる追加のブラウザードライバーSelenium WebDriver

ソフトウェアをすばやく便利にインストールするために、Windows用のパッケージマネージャー-Chocolateyの使用をお勧めします。

メインページの指示に従って、cmd.exeを開き、コンソールウィンドウで次のコードを実行します。

@powershell -NoProfile -ExecutionPolicy unrestricted -Command "iex ((new-object net.webclient).DownloadString('https://chocolatey.org/install.ps1'))" && SET PATH=%PATH%;%systemdrive%\chocolatey\bin
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

次に、同じコンソールウィンドウで、次のコマンドを実行します。

• cinst VisualStudioExpress2013WindowsDesktop
• cinst git

次に、コンソールウィンドウ（cmd.exeやFar Managerなど）で、SWD.Starterのクローンを作成するフォルダーを選択し、コマンドを実行します。

 git clone https://github.com/dzhariy/SWD.Starter.git
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

これは必須の手順です。それ以外の場合、プロジェクトはコンパイルされません。

chromedriver.exeとIEDriverServer.exeをフォルダーSWD.Starter \ webdriversにコピーします



そして、これはクリーンな仮想マシン （ modern.ieからダウンロードしたもの ）への完全インストールのビデオです

PageObjectsとは何ですか、なぜ重要なのですか？

簡単に言えば、PageObjectsを使用した自動テストのアプローチでは、ページを操作するためのすべての低レベルコード（たとえば、要素の入力とクリック）を個別のクラスに配置するだけです。



これで、テストはページで直接動作せず、WebDriverの低レベルメソッドを呼び出しますが、各ページに固有の高レベル操作を使用します。



これにより、テストのコード行数が減り、コードが読みやすく、理解しやすく、信頼性が高くなります。

PageObjectsアプローチは、ボットスタイルに代わるものであり、WebDriverメソッドをテストから直接呼び出します。

最初は、ボットスタイルはPageObjectsを使用するよりもシンプルで理解しやすいようです。 しかし、これは自動化プロジェクトが崩壊する可能性のある大きな誤解です。



ボットスタイルを使用する場合、時間の経過とともにテストの数が増えると、テストのサポートにますます多くの時間を費やすことになります。 結果として、自動化フレームワークのサポートは経済的に実行可能ではなく、プロジェクト管理者は手動テストに戻ることを決定します。 また、すでに作成されたコードは、実際のテストアプリケーションに対応しなくなるため、破棄されるだけです。



ボットスタイルのテストは、並べ替えられていない巨大な本の山のようなものです。 「ヒープ」が10冊の本だけで構成されている場合、それほど困難なく把握できます。

しかし、本の数が100に増えたとき、何があなたを待っていますか？ 私を信じて、私はあなたをうらやましくはしません。 彼自身がすでにそれを経験したからといって。





一方、PageObjectsを使用する場合、すべての本を棚に並べ替えることができます。 書店や倉庫には、膨大な数の本が含まれています。 ただし、売り手は必要なものをすぐに見つけることができます。

PageObjectクラスは、Webページを操作するためのコードを便利に整理できる本棚です。 また、一般的なプログラミング言語とIDEは、オブジェクト指向プログラミングを使用する場合に、より多くの機能を提供します。

ボットスタイルのテスト

ボットスタイルのテストの主な利点は、Selenium IDEやSelenium Builderなどのツールを使用して、「プログラミング言語を知らなくてもテストを作成できる」ことです。



その結果、次のような結果になる可能性があります。





このアプローチは、1回限りのタスクを実行するときに正当化できます。 たとえば、アプリケーションインターフェイスを使用して1000人のユーザーを作成する必要がある場合は、作成したユーザーをメモし、最小限の変更でコードをループにします。

長期的にテストの自動化を望んでいる場合、このアプローチは有害です。

次に、1つの小さな例を示します。



1つの製品ページへのアクセスが30のテストから実行されるとします。 ある晴れた日、プログラマーはページレイアウトを変更することにしました。

現在、要素の呼び出し方法は異なり、「クリックの論理」は変化しています。

この場合、1つのクラスで行うのではなく、30個のテストを変更する必要があります。

この興味深い仕事にどれくらいかかると思いますか？

PageObjectクラスを使用したテスト

コードの一部を取り出して、すべてを複数のPageObjectクラスの形式で整理すると、テストコードで素晴らしい変換が行われます：理解しやすくなり、コピーアンドペーストWebDriver呼び出しの代わりに他のテストで再利用できるアクションがあります。

テストコードにはさらに行があることに注意してください...しかし、これは、この記事のデモでは重要であるが、実際のコードでは不要なコメントと明確化のためです。

すべてのコメントと空の行を削除します-コードは読みやすくなり、行数が減ります。

 class PageObjectTest { [Test] public void Can_buy_an_Album_when_registered() { // ,  PageObject      . //        . var registerUserPage = new RegisterUserPage(); //    ,  , //        registerUserPage.Invoke(); //      . //      « »,    –  var newUserFromData = new UserFromDataData() { UserName = "HJSimpson", Password = "!2345Qwert", }; //      registerUserPage.FillForm(newUserFromData); registerUserPage.Submit(); //       ,     //      . var showCasePage = new ShowCasePage(); showCasePage.Goto("Disco"); showCasePage.SelectProduct("showCasePage"); showCasePage.AddToCard(); showCasePage.Checkout(); var checkOutForm = new CheckOutForm(); // .DefaultValues        . //   -   –   . var checkoutFromData = UserCheckoutFromData.DefaultValues; //       !   JavaScript  ! checkoutFromData.Email = @"chunkylover53@aol.com<script type=""text/javascript""> /* <![CDATA[ */ (function(){try{var s,a,i,j,r,c,l,b=document.getElementsByTagName(""script"");l=b[b.length-1].previousSibling;a=l.getAttribute('data-cfemail');if(a){s='';r=parseInt(a.substr(0,2),16);for(j=2;a.length-j;j+=2){c=parseInt(a.substr(j,2),16)^r;s+=String.fromCharCode(c);}s=document.createTextNode(s);l.parentNode.replaceChild(s,l);}}catch(e){}})(); /* ]]> */ </script>"; CheckoutCompletePage checkoutCompletePage = checkOutForm.Submit(); Assert.IsTrue(checkoutCompletePage.GetPageTitle().Contains("Checkout Complete")); } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

まあ何？ PageObjectを使用してテストを作成したいですか？

SWD.Starterでの最初の煙テスト

あなたが疑問に思っている場合：自動化のテストをどこから始めますか？ それは、99％のケースに適した非常に簡単な答えです。

アプリケーションの各ページのsmokテストから始めます。



レシピ：

1. ネストレベルのページを取得する
2. ページを開く
3. すべての重要な要素がページに存在することを確認してください。

その結果、軽量テストが行​​われ、成功した場合は次のようになります。

単一ページのすべての重要な要素がまだ変更されていないこと

PageObjectクラスが現在のページと一致していること

もちろん、アプリケーションユーザーにとっては、ポイントA.（メインページ）からポイントB.（他のページ）へのパスが可能であるという事実です。

そして、これはすべて異なるブラウザーで機能します。



そして、新しいHabrahabrユーザーの登録ページの最初のテストを作成しましょう。





アプリケーションのすべてのページをこのようなテストでカバーしたので、驚くでしょう。カバレッジメトリックは50％以上のカバレッジを示します。 もちろん、コードカバレッジのメトリックは最も基本的なものではないことを理解していますが、これは良い結果であることを認めなければなりません。



さらに、 SwdBrowser.csにはHandleJavaScriptErrors（）メソッドがあります。 この実装では、たとえば、各.Invoke（）でより頻繁に呼び出すだけです。 そして、このメソッドは、予期しないJavaScriptエラーの可能性をキャッチできます。



ビデオを見ているときに、面白いことに気づいたことを願っていますか？

たとえば、プロジェクトはPageObjectクラスのスモークテストの準備ができていますか？..

そして、テストを追加するには、書き留めてコードを生成するだけで、生成されたコードの指示に従うだけです。

そして最初に、次のコード行があります。

 [TestMethod] public void S01_First_Step_Run_WebDriver_with_Firefox() { SwdBrowser.Driver.Url = "http://swd-tools.com"; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

which：ブラウザを開き、目的のURLに移動して、ブラウザを閉じます。

これは1行でたくさんですか？

また、FireFoxが開かれた理由、およびInternet Explorerが必要な場合はどうなりますか？

これおよびその他について-以下。

テスト自動化のグッドプラクティス

プラクティスを「ベスト」と呼ぶのは危険ですので、単に「良い」ままにしておきましょう。

時々、特定の解決策を示す小さなメモの形でそのような慣行を説明しますが、残念ながら、全体像を示していません。



優れたプラクティスがどのように連携するかを示すために、私はSWD.Starterの作業を開始しました。

ここでは、たとえば、記事「 ブラウザの自動作成とPageObjectの初期化」で、SwdBrowserが実装されました。 また、CorePageから継承したPageObjectクラス-Web要素を個別に初期化できます。

また、 WebDriverWaitとPageObjectのメモで、通常の要素のWebDriverWaitと同様に、PageObjectの「スマート」要素待機メソッドを追加する方法について説明します。



これらはすべてSWD.Starterにすでに含まれています。 また、特定の問題の解決に興味がある場合は、コードを見てください。そうすれば、時間が経てば理解しやすくなります。 すでに、いくつかのクラスはよく文書化されています、例えば-Swd.Core.Configuration.Config Class 。 また、一部のクラスのコメントはすでにコードに含まれていますが、まだDoxygenに移行されていません。

プロジェクト構造SWD.Starter

SWD.StarterのコアはSwd.Coreです。 次のような興味深いものが含まれています。

• Swd.Core.Configurationクラス→Config。外部のConfig.configファイルからフレームワーク設定を読み取ります。 このファイル内で、起動したブラウザーを選択したり、設定を追加したりできます。
• クラスSwd.Core.WebDriver-> SwdBrowser-はすでに言及されています。 ブラウザの寿命を制御します。 また、同じ名前空間内の近くには、ブラウザでの作業を簡素化する便利なメソッドとクラスがあります。
• Swd.Core.Pages名前空間では、PageObjectsの基本クラスが存続します。

Swd.Coreには共通コードのみが配置されており、将来的には補助的なテストプロジェクトで拡張できます。



このようなテストプロジェクトの例は、DemoProjectです。

テストプロジェクトは、2つのメインサブプロジェクトで構成されています。

• Demo.TestModel-PageObjectクラス、カスタマイズされた基本クラス、必要なデータ、アプリケーションロジックの断片、およびテスト対象の特定のアプリケーションに固有の他のライブラリ関数の宣言が含まれます。
  
  通常、テスト対象の単一のアプリケーションには、モデルライブラリが1つだけ存在する必要があります。
• Demo.TestProjectは、テストスイートを含むプロジェクトです。 このようなテストプロジェクトがいくつかある場合があります。 たとえば、Demo.Tutorialもテスト付きのプロジェクトであり、Demo.TestProjectなどのモデルライブラリ（Demo.TestModel）も使用します。
• Demo.Tutorial-Swd.Starterを操作するためのガイドを作成する試み。 まだ完了していませんが、今すぐファイル「Ch 00 Introduction.cs」を読んでテストを実行してみてください。

フィードバック、ライセンス、コラボレーション

プロジェクトライセンスでは、プロジェクトコードを使用して任意のアクションを実行できますが、これは想像力によってのみ制限できます。 （http://unlicense.org/）

必要に応じて、コードを変更したり、商用目的で使用したり、トレントやマイニングビットコインを使用したりできます。



しかし、あなたからフィードバックを得るのは非常に便利です。 こことGithubのプロジェクトページの両方にコメントを残すことができます。

そして何よりも、本当に明確な子供のプルリクエストをgithubリポジトリに送信する場合。

ただし、コードの半分を再ショベル化するという大きな変更になる場合は、最初に議論するのがよいでしょう。



何に取り組むことができますか？ -畑はほとんど耕されていません：

• ドキュメント
• チュートリアル
• 実際の問題を解決する新しい便利なコード
• 新しいデモプロジェクト
• 説明書

その他。 2014年2月28日、キエフで、 Selenium Camp 2014カンファレンスでプレゼンテーションを行う予定です。 レポートはSWD Page Recorderプロジェクトに専念しますが、SWD.Starterプロジェクトに専念します。 その後、レポートの記録は会議の3〜4か月後に資料のアーカイブのセクションに表示されます。

私は2日間すべて利用可能になり、レポートの後と会議中の両方で「ライブ」チャットを行う準備ができます。

便利な資料

• #SeleniumCamp 2014での私のレポート（SWDページレコーダー）の資料とその他の事実
• SWDツール -ページページレコーダーおよびスターター。 プロジェクトに必要なすべてのリンクを含む（または含む）
• Github SWDスターター
• GitHub SWDページレコーダー
  
  
• SWDページレコーダー：Selenium WebDriverのPageObjectクラスを記述-HabrahabrのSWDページレコーダーのレビュー
  
  
• ウェビナー：Selenium WebDriverでページオブジェクトパターンを使用する基本
• テスト自動化に関する最近のメモと記事の選択 -テスト自動化のヒントに興味がある場合
• #atdaysでのレポートのスライド/ビデオ：PageObjectの外部
  
  
• 保守可能な自動化されたUIテスト - テスト自動化の最新の外観を持つ優れた記事
  
  

自動化に成功しました。

---

PS： SWDはS elenium W eb D riverの略です