[小北De編程手記] : Lesson 07 - Selenium For C# 之 窗口處理

　　在實際的自動化測試過程中，我們會遇見許多需要對窗口進行處理的情況。比如，點擊刪除某條信息的時候系統會顯示一個Alert框。或者點擊某個超鏈接時會在瀏覽器中打開一個新的頁面。這一篇，來和大家分享一下Selenium WebDriver窗口處理相關的API。那么，還是照例先看一下本文主要涉及到的話題：

• 窗口處理接口：ITargetLocator
• 瀏覽器彈出窗口的處理（新頁面）
• JavaScript彈出框的處理：Alert, Confirm, Prompt
• 內嵌框架的處理：Frame , iFrame

（一）窗口處理接口：ITargetLocator

　　Selenium WebDriver處理窗口能力主要是由WebDriver對象的SwitchTo()方法返回的對象提供的。該對象實現了ITargetLocator接口，也基本涵蓋了本文所有描述的所有情況（即對彈出窗口，JS模態窗口，內嵌框架的處理）。我們可以通過以下代碼獲取當前驅動的ITargetLocator對象：

        /// <summary>
        /// demo1 : 獲取目標定位對象
        /// </summary>
        [Fact(DisplayName = "Cnblogs.WindowProcess.Demo1", Skip = "Just Demo")]
        public void WindowProcess_Demo1()
        {
            // 1. 獲取窗口定位對象
            IWebDriver driver = new FirefoxDriver();
            //省略部分代碼... ...
            ITargetLocator locator = driver.SwitchTo();
            //后續操作... ...
            driver.Close();
        }

　　ITargetLocator接口的定義如下所示，這里我先簡要的介紹一下這些方法的作用（本文后面會逐個介紹）：

• ActiveElement：獲取當前焦點所在的元素，如果沒有持有焦點的元素將返回Body元素（這個方法與窗口處理無關）。
• Alert：切換到JS彈出的模態窗口。
• DefaultContent：獲取第一個頁面上的Frame，當有iFrames的時候將獲取主頁面的Document。
• Frame：此方法有三個重載的實現，用來切換到到Frame。
• ParentFrame：選中獲取當前頁面的父輩Frame。
• Window：切換窗口。

    // Summary:
    //     Defines the interface through which the user can locate a given frame or
    //     window.
    public interface ITargetLocator
    {
        IWebElement ActiveElement();
        IAlert Alert();
        IWebDriver DefaultContent();
        IWebDriver Frame(int frameIndex);
        IWebDriver Frame(IWebElement frameElement);
        IWebDriver Frame(string frameName);
        IWebDriver ParentFrame();
        IWebDriver Window(string windowName);
    }

 

（二）瀏覽器彈出窗口的處理（新頁面）

　　如上一小節所述，Selenium WebDriver對彈出窗口的處理主要是通過ITargetLocator.Window方法。下面我就來向大家介紹一下Selenium WebDriver中常用的窗口定位方式：

• 用窗口名稱定位
• 結合標題和窗口句柄定位頁面

@用窗口名稱定位

　　參照ITargetLocator.Window方法的定義，該方法接受一個窗口的名稱。因此我們可以通過窗口的名稱切換到該窗口（前提是開發人員定義了這個窗口的名字）：

            // 1. 獲取窗口定位對象
            IWebDriver driver = new FirefoxDriver();
            //省略部分代碼... ...
            ITargetLocator locator = driver.SwitchTo();
            driver = locator.Window("windowName"); 6             //后續操作... ...
            driver.Quit();

　　我們可以通過上面的代碼切換窗口，但是問題來了，我們怎么獲取到窗口的名字呢？所有的瀏覽器都有執行JS腳本的命令行工具，我們只需要輸入“window.name”便可以看見當前窗口的名字了，下圖是我在Firebug中的操作：

@結合標題和窗口句柄定位頁面

　　很多情況下，開發人員是不會為每一個彈出的窗口定義名稱的（實際上也沒有這個必要）。那么，我們就需要用其他的方式來定位我們的目標窗口了，下面的代碼使用了窗口句柄和標題定位需要訪問的窗口，我們可以通過WebDriver對象的WindowHandles屬性獲取當前瀏覽器打開的所有句柄，在根據頁面的特定條件（這里是用的標題）來判斷哪一個句柄是需要操作的界面句柄。一般的情況下，我們需要保存當前的頁面句柄，這樣可以方便后操作完成之后能准確的返回當前頁面。Demo的最后驗證了操作頁面的標題是否正確，代碼如下：

        /// <summary>
        /// demo2 : 根據標題定位元素
        /// </summary>
        [Fact(DisplayName = "Cnblogs.WindowProcess.Demo2")]
        public void WindowProcess_Demo2()
        {
            var articleName = "[小北De編程手記] : Lesson 02 - Selenium For C# 之 核心對象";

            _output.WriteLine("Step 01 : 啟動瀏覽器並打開Lesson 01 - Selenium For C#");
            IWebDriver driver = new FirefoxDriver();
            driver.Url = "http://www.cnblogs.com/NorthAlan/p/5155915.html";

            _output.WriteLine("Step 02 : 點擊鏈接打開新頁面。");
            var lnkArticle02 = driver.FindElement(By.LinkText(articleName));
            lnkArticle02.Click();

            _output.WriteLine("Step 03 : 根據標題獲取新頁面的句柄。");
            var oldWinHandle = driver.CurrentWindowHandle;
            foreach (var winHandle in driver.WindowHandles)
            {
                driver.SwitchTo().Window(winHandle);
                if (driver.Title.Contains(articleName)) 23                 {
                   break;
                }
            }

            _output.WriteLine("Step 04 : 驗證新頁面標題是否正確。");
            var articleTitle = driver.FindElement(By.Id("cb_post_title_url"));
            Assert.Equal<string>(articleName, articleTitle.Text);

            _output.WriteLine("Step 05 : 關閉瀏覽器。");
            driver.Quit();
        }

　　 值得說明的是，第22行代碼使用了Title的內容做為判斷是否是新開的頁面的條件，這里你也可以根據實際的需要使用Url或是頁面內容... ...等其他條件進行判斷。

（三）JavaScript彈出框的處理

　　稍有Web編程經驗的人都應該知道JavaScript可以彈出模態對話框。在介紹處理這些彈出的窗體之前我們先回顧一下瀏覽器內置的彈出框都有哪些類型：

• Alert：只有文字和一條提示信息以及一個確認按鈕（用於提示用戶）。
• Confirm：較Alert多了一個取消按鈕（用於向用戶確認信息）。
• Prompt：較Confirm多了一個文本輸入框（向用戶確認信息的同時可以獲取用戶輸入）
• AuthenticationCredentials：用於輸入用戶名和密碼的窗口（下圖中沒有給出）。

　　好了，現在我們開始介紹如何處理這些彈出框。上面我們提到過ITargetLocator.Alert方法可以用來處理模態窗口。該方法的返回對象實現了IAlert接口：

    // Summary:
    //     Defines the interface through which the user can manipulate JavaScript alerts.
    public interface IAlert
    {
        string Text { get; }
        void Accept();
        void Dismiss();
        void SendKeys( string keysToSend);
        void SetAuthenticationCredentials( string userName, string password);
    }

　　在此，需要澄清一下，之前介紹的四種彈出窗口都是用實現了IAlert接口的對象描述的（也就是說Confirm，Prompt，AuthenticationCredentials都可以用實現了IAlert接口的對象進行處理）：

• Text：獲取彈出框文本信息（適用於所有模態窗口）　　
• Accept：點擊確定按鈕（適用於所有模態窗口）
• Dismiss：點擊取消按鈕（適用於Confirm，Prompt，AuthenticationCredentials）
• SendKeys：輸入文本信息（適用於Prompt）
• SetAuthenticationCredentials：設置用戶名和密碼（適用於AuthenticationCredentials）

　　是不是 so... ... easy? 下面還是照例看一下具體的使用代碼：

      IAlert alert = driver.SwitchTo().Alert();   //轉到彈出框
      alert.Accept();                             //確定：Alert , Confirm, Prompt
      alert.Dismiss();                            //取消：Confirm, Prompt
      var text = alert.Text;                      //獲取提示內容：Alert , Confirm, Prompt
      alert.SendKeys("input text.");              //輸入提示文本：Prompt

（四）內嵌框架的處理

　　本文的最后，我來介紹一下關於網頁內嵌框架的處理。早期的一些B/S系統會用iFrame和Frame進行布局和頁面的嵌套。之前也有利用iFrame構建全局彈出框的設計方式。因此，如果你們的產品已經有多年的歷史。那么，你可能會需要處理這部分的內容。其實Frame和iFrame的處理和窗口很類似，這里我簡單的給出一個Demo：

　　　　ITargetLocator tagetLocator = driver.SwitchTo();
　　　　tagetLocator.Frame(1);  //frame index.
　　　　tagetLocator.Frame("frameName");  //frame frame name.

　　　　IWebElement frame = driver.FindElement(By .Id("frameId or iframeId" ));
　　　　tagetLocator.Frame(frame);
　　　　tagetLocator.DefaultContent();

　　從上面的代碼中可以看到，可以使用index，frame name，或者frame對象把Driver切換到Frame上。

 

總結：本文主要介紹如何利用Selenium WebDriver核心的ITargetLocator接口處理各種窗口。

• 窗口處理接口：ITargetLocator
• 瀏覽器彈出窗口的處理（新頁面）
• JavaScript彈出框的處理：Alert, Confirm, Prompt
• 內嵌框架的處理：Frame , iFrame

《Selenium For C#》的相關文章：Click here.

• [小北De編程手記] : Lesson 01 - Selenium For C# 之 環境搭建
• [小北De編程手記] : Lesson 02 - Selenium For C# 之 核心對象
• [小北De編程手記] : Lesson 03 - Selenium For C# 之 元素定位
• [小北De編程手記] : Lesson 04 - Selenium For C# 之 API 上
• [小北De編程手記] : Lesson 05 - Selenium For C# 之 API 下
• [小北De編程手記] : Lesson 06 - Selenium For C# 之 流程控制
• [小北De編程手記] : Lesson 07 - Selenium For C# 之 窗口處理
• [小北De編程手記] : Lesson 08 - Selenium For C# 之 PageFactory & 團隊構建

說明：Demo地址：https://github.com/DemoCnblogs/Selenium

 

如果您認為這篇文章還不錯或者有所收獲，可以點擊右下角的 【推薦】按鈕，因為你的支持是我繼續寫作，分享的最大動力！

作者：小北@North

來源：http://www.cnblogs.com/NorthAlan

聲明：本博客原創文字只代表本人工作中在某一時間內總結的觀點或結論，與本人所在單位沒有直接利益關系。非商業，未授權，貼子請以現狀保留，轉載時必須保留此段聲明，且在文章頁面明顯位置給出原文連接。