📗 🐏 🏥 सेलेनियम वेबड्राइवर 2.x पर आधारित स्वचालित परीक्षणों का विकास 💭 👨🏽‍✈️ 🌿

हैलो, प्रिय Habrosociety! मैं सी # प्रोग्रामिंग भाषा में सेलेनियम वेबड्राइवर 2.x पर आधारित स्वचालित परीक्षण लिखने के विकास और आयोजन के अपने तरीके को साझा करना चाहता हूं।
मुझे तुरंत कहना होगा कि कई शोध, सिद्धांतों और विकास विधियों का आविष्कार मेरे द्वारा नहीं किया गया था (और, शायद, मेरे शिक्षकों द्वारा नहीं)।
शायद यह पोस्ट उन लोगों की मदद करेगी जो अभी वेब अनुप्रयोगों के स्वचालित परीक्षण में संलग्न होना शुरू कर रहे हैं।

ट्रेनिंग

सेलेनियम का उपयोग करके स्वचालित परीक्षण विकसित करने के लिए, हमें निम्नलिखित घटकों की आवश्यकता है:
विकास का माहौल, हमारे मामले में, विजुअल स्टूडियो;
स्वचालित रूप से लिखित परीक्षण चलाने के लिए NUnit कार्यक्रम (यहाँ डाउनलोड करें: www.nunit.org/index.php?p=download );
इसके लिए स्थापित दो प्लगइन्स के साथ मोज़िला फ़ायरफ़ॉक्स ब्राउज़र: फायरबग और फायरपैथ (इस आलेख में उपयोग नहीं किया गया है)।

विकास का माहौल बनाना

स्वचालित परीक्षणों को लिखने के लिए, आपको एक नया प्रोजेक्ट बनाना होगा जैसे क्लास लाइब्रेरी (आप कंसोल एप्लीकेशन बना सकते हैं, लेकिन हमारे मामले में नहीं)। यह एक नाम देना उचित है जो परीक्षण किए गए प्रोजेक्ट के नाम के साथ जुड़ा हुआ है। इसके अलावा, परीक्षण परियोजना के साथ समाधान में एक परीक्षण परियोजना बनाना उचित है।
एक परीक्षण परियोजना बनाने के बाद, आपको इसके लिए परीक्षणों के लिए 3 विशेष पुस्तकालयों को जोड़ने की आवश्यकता है:
NUnit (nunit.framework) - सीधे स्वचालित परीक्षण चलाने के लिए एक पुस्तकालय (न केवल सेलेनियम के लिए);
WebDriver + WebDriver.Support - सीधे सेलेनियम की लाइब्रेरी।
आप NuGet के माध्यम से या मैन्युअल रूप से code.google.com/p/selenium/downloads/list से नवीनतम संस्करण डाउनलोड करके पुस्तकालयों को परीक्षण परियोजना से जोड़ सकते हैं।

एक परीक्षण परियोजना वास्तुकला का निर्माण

आधार वर्ग

स्वचालित परीक्षणों को स्वयं लिखने से पहले, हमें सबसे पहले सहायक कक्षाएं बनाने की आवश्यकता है।
परीक्षण परियोजना में, एक नया वर्ग जोड़ें और इसे सेलेनियमटेस्टबेस (कॉल यह एक और तरीका हो सकता है) कहें। हम इस वर्ग को सार्वजनिक सार के रूप में घोषित करते हैं, क्योंकि यह इस वर्ग से है कि भविष्य में सभी परीक्षण कक्षाएं विरासत में मिलेंगी। आपको क्लास में [TestFixture] एट्रिब्यूट भी जोड़ना होगा, जो क्लास को टेस्ट क्लास के रूप में नामित करता है। इस वर्ग में, उन क्षेत्रों और विधियों को घोषित किया जाता है जो किसी भी परीक्षा को पास करने के लिए आवश्यक होते हैं।
इस वर्ग में, हमें एक क्षेत्र घोषित करना चाहिए:
संरक्षित IWebDriver ड्राइवर ; - यह ब्राउजर ड्राइवर का एक उदाहरण है जो टेस्ट (एस) को चलाने से पहले बनाया जाता है। 4 प्रकार के ड्राइवर (+ कई अंडर डेवलपमेंट) हैं: फ़ायरफ़ॉक्सडाइवर, इंटरनेटएक्सप्लॉरड्रीवर, क्रोमड्राइवर, एचटीएमएलयूनीटड्राइवर (बिना ग्राफ़िकल कंपोनेंट के क्रॉस-प्लेटफॉर्म वर्चुअल ब्राउज़र)।

हम कक्षा में 4 विधियाँ भी घोषित करेंगे (हालाँकि कुछ खाली हो सकती हैं या \ _ और परिभाषित नहीं होंगी):
सार्वजनिक शून्य TestInitialize () [TestFixtureSetUp] विशेषता के साथ - इस विशेषता के साथ विधि को किसी भी परीक्षण वर्ग से परीक्षण चलाने से पहले एक बार बुलाया जाएगा (यदि कई वर्ग हैं, तो पहली कक्षा से परीक्षण से पहले विधि को बुलाया जाएगा, फिर दूसरी कक्षा के तरीकों से पहले और इसी तरह से आदि)। इस वर्ग में, ड्राइवर चर के लिए एक विशिष्ट मान निर्दिष्ट करना वांछनीय है, उदाहरण के लिए:
Driver = new FirefoxDriver();

सार्वजनिक शून्य TestCleanup () [TestFixtureTearDown] विशेषता के साथ - पिछली पद्धति के अनुसार ऑपरेशन का सिद्धांत, लेकिन केवल परीक्षण वर्ग चलाने के बाद। इस वर्ग में, ब्राउज़र ड्राइवर को बंद करना वांछनीय है, क्योंकि जब आप अगली परीक्षण कक्षा चलाते हैं, तो ब्राउज़र ड्राइवर का एक नया उदाहरण बनाया जाएगा (परिणामस्वरूप, ब्राउज़र ड्राइवर के कई उदाहरण खुले रह सकते हैं, और रैम रबड़ नहीं है):
Driver.Quit();

सार्वजनिक शून्य OneTearDown () [TearDown] विशेषता के साथ - विधि प्रत्येक व्यक्तिगत परीक्षण को चलाने के बाद कहा जाता है। इस विधि में, उदाहरण के लिए, आप प्रत्येक नए परीक्षण से पहले ब्राउज़र कुकीज़ साफ़ कर सकते हैं:
Driver.Manage().Cookies.DeleteAllCookies();

सार्वजनिक शून्य OneSetUp () [सेटअप] विशेषता के साथ - विधि प्रत्येक व्यक्तिगत परीक्षण चलाने से पहले कहा जाता है। उदाहरण के लिए, आप परीक्षण चलाते समय ब्राउज़र विंडो को पूर्ण स्क्रीन पर विस्तारित कर सकते हैं (HtmlUnitDriver के लिए प्रासंगिक नहीं):
Driver.Manage().Window.Maxmize();

आवरण

अलग-अलग टेस्ट (अलग-अलग कक्षाओं में भी) लिखते समय, कोड डुप्लिकेट संभव है (अधिक सटीक रूप से, यह निश्चित रूप से होगा)। परीक्षण कक्षाओं में अव्यवस्था से बचने के लिए, एक सहायक क्लास स्टेटिक क्लास रैपर बनाना उपयोगी है, जिसमें हम अलग-अलग तरीकों से कोड की नकल करते हैं।
अधिकांश परीक्षण कोड की एक ही पंक्ति से शुरू होंगे:
Driver.Navigate().GoToUrl(<>);
इसलिए, रैपर क्लास में एक निजी स्टैटिक स्ट्रिंग _domain फ़ील्ड को परिभाषित करना तर्कसंगत है, जिसमें हम उस URL को लिखेंगे जिसकी हमें आवश्यकता है, साथ ही इस URL को प्राप्त करने के लिए एक विधि:

कोड का टुकड़ा

 public static string GetUrl() { _domain = "http:\\www.yandex.ru"; return _domain; }

Wrapper.cs और SeleniumTestBase.cs के बीच का अंतर यह है कि पहले में, तरीकों को परीक्षणों के अंदर (और यहां तक कि सेलेनियमटेस्टबेस के अंदर) घोषित किया जाता है, और दूसरे में, परीक्षण के पहले या बाद में बुलाया जाने वाले तरीके।
सहायक परीक्षण बनाने के बाद, हम पहले से ही सामान्य परीक्षण कक्षाएं बनाते हैं।

इस प्रकार, परीक्षण परियोजना की वास्तुकला इस तरह दिखती है:

परीक्षण लेखन उदाहरण

एक नया परीक्षण वर्ग बनाएं और उसे TestClass1.cs पर कॉल करें। पहले हम एक सरल परीक्षण कोड लिखते हैं, फिर हम समझाते हैं कि कोड की कौन सी पंक्ति क्या करती है।

गोटो यैंडेक्स

 [Test, Timeout(10000)] public void Test1() { Driver.Navigate().GoToUrl(Wrapper.GetUrl()); Assert.IsTrue(Driver.Title == ""); }

[परीक्षण] - एक विशेषता जो यह निर्धारित करती है कि यह विधि एक परीक्षण है।
टाइमोट (int millSec) - केवल टेस्ट विशेषता के साथ काम करता है - टेस्ट पास करने के लिए मिलीसेकंड की अधिकतम स्वीकार्य संख्या को इंगित करता है। यदि टाइमआउट पार हो जाता है, तो परीक्षण तुरंत (यहां तक कि रनटाइम पर) क्रैश हो जाता है और विफल माना जाता है।
सार्वजनिक शून्य - परीक्षण में केवल इस तरह का एक पहुंच संशोधक होना चाहिए और सही ढंग से काम करने के लिए परीक्षण के लिए किसी भी मूल्य को वापस नहीं करना चाहिए।
Driver.Navigate ()। GoToUrl (Wrapper.GetUrl ()) - ब्राउज़र ड्राइवर हमारे लिए यैंडेक्स पेज खोलेगा।
Assert.IsTrue (Driver.Title == "Yandex") - एक प्रत्यक्ष जांच, इस मामले में परीक्षण यह जाँचता है कि पृष्ठ का शीर्षक "Yandex" है, इस मामले में परीक्षण पारित माना जाता है, अन्यथा परीक्षण विफल हो जाता है।

परीक्षण चल रहा है

हमारे परीक्षणों को चलाने के लिए, हमें इसके लिए एक विशेष रूप से बनाए गए कार्यक्रम की आवश्यकता है - NUnit (दस्तावेज़ की शुरुआत में डाउनलोड करने के लिए लिंक)।
हम अपने परीक्षण परियोजना को संकलित करते हैं। आउटपुट पर, हमारे पास .dll प्रकार की एक फ़ाइल है
NUnit चलाएं। इसके बाद फाइल-ओपन प्रोजेक्ट पर क्लिक करें। एक विंडो दिखाई देगी जिसमें हमें बस संकलित पुस्तकालय को खोजने और चयन करने की आवश्यकता है।
पुस्तकालय को कार्यक्रम में लोड करने के बाद, बाईं ओर हम अपने परीक्षणों के साथ परीक्षण कक्षाओं का एक पेड़ देखेंगे। इस पेड़ में, आप एक परीक्षण, वर्ग या सभी परीक्षण कक्षाएं चुन सकते हैं, फिर रन बटन पर क्लिक करें और परीक्षण चलना शुरू हो जाएंगे। स्टॉप बटन को दबाकर आप किसी भी समय रन रोक सकते हैं।
परीक्षणों को पारित करने के बाद, उनका रंग पेड़ में बदल जाएगा: हरा - परीक्षण पारित, लाल - परीक्षण गिर गया, पीला - परीक्षण किसी कारण से विफल हो जाता है (गिरावट नहीं), ग्रे - परीक्षण अभी तक शुरू नहीं हुआ है। बटन के नीचे एक खिड़की है जिसमें परीक्षण गिरा दिया गया है, जिसके द्वारा आप पता लगा सकते हैं कि कोई विशेष परीक्षण क्यों गिर गया।

अतिरिक्त जानकारी

सबसे तेज़ ब्राउज़र ड्राइवर को ChromeDriver माना जाता है। सबसे धीमे अनुमान लगाओ।

ChromeDriver और InternetExplorerDriver के लिए, आपको एक अतिरिक्त ड्राइवर एप्लिकेशन डाउनलोड करना होगा और इसे प्रोजेक्ट डायरेक्टरी में डालना होगा।

इसके अलावा परीक्षणों में विशेषताओं का उपयोग किया जाता है:
[TestCase (var v1, ..., var vOver9000)] - यदि संभव हो तो परीक्षण कई संभावित इनपुट डेटा पर पुनरावृति करना चाहिए। परीक्षण से पहले, आप कितने भी परीक्षण मामलों को लिख सकते हैं। सही संचालन के लिए, परीक्षण विधि को कई मापदंडों के रूप में पारित करना होगा क्योंकि परीक्षण मामले में पंजीकृत चर की संख्या। रचना में परीक्षण के मामले समान होने चाहिए (1 चर के साथ परीक्षण के मामले लिखना असंभव है, और फिर परीक्षण से पहले 2 के साथ)। एक उदाहरण:

टेस्टकेस ()

 [Test, Timeout(10000)] [TestCase("", 1)] [TestCase("", 2)] [TestCase("", 3)] [TestCase("", 4)] [TestCase("", 5)] public void Test2(string str, int days) { /*    5       10 */}

परीक्षण के मामलों का एक विकल्प विशेषता [रेंज ()] और [मूल्य ()] हैं । लेकिन परीक्षण मामलों के विपरीत, इन विशेषताओं को पारित तर्कों के साथ लिखा जाता है। रेंज का उपयोग एन्यूमरेटेड वैल्यूज़ के लिए किया जाता है, गैर-एन्यूमेरेटेड वैल्यूज़ के लिए वैल्यूज़ । साथ ही, चलाए जाने वाले परीक्षणों की संख्या चर के सभी संयोजनों की संख्या के बराबर होगी। एक उदाहरण:

श्रेणी + मान

 [Test] public void Test3([Range(0,3)]int a, [Values(“0”, “1”, “2”, “3”)]string b) { Assert.IsTrue(a.ToString() == b); }

16 परीक्षण हैं और उनमें से केवल 4 ही पास होंगे।

टिप्स

स्वचालित परीक्षण लिखते समय, आपको एएए की अवधारणा का पालन करना चाहिए - व्यवस्था-अधिनियम-अभिकारक :
व्यवस्था - परीक्षण से पहले आवश्यक सेटिंग्स और क्रियाएं;
अधिनियम - सीधे परीक्षण;
जोर - "अपेक्षित परिणाम == वर्तमान परिणाम" प्रकार की स्थितियों की जांच के लिए एक ब्लॉक।
ऊपर का उदाहरण लें, इसे थोड़ा पुनर्लेखन करें:

एएए शुरू

 [Test, Timeout(10000)] public void Test1() { Driver.Navigate().GoToUrl(Wrapper.GetUrl()); var title = Driver.Title; Assert.IsTrue(title == ""); }

यहां अरल यूरेल के माध्यम से पारित होता है, एक्ट शीर्षक पृष्ठ की गणना है, एस्टर "अपेक्षित परिणाम == वर्तमान परिणाम" स्थिति की जांच है।
पठनीयता के लिए, परीक्षण को निम्नानुसार फिर से लिखा जा सकता है:

एएए पूरा

 [Test, Timeout(10000)] public void Test1() { //Note : Arrange Driver.Navigate().GoToUrl("http:\\www.yandex.ru"); //Note : Act var title = Driver.Title; //Note : Assert Assert.IsTrue(title == ""); }

आदत में ले लो: एक परीक्षण - एक जोर। यह सलाह दी जाती है कि सभी मामलों में या चरम मामलों में उल्लंघन न करें (परीक्षण में बड़ी संख्या में चेक के साथ, कोड की पठनीयता कम हो जाती है)।

कोड में कई चयनकर्ताओं को कई बार दोहराया जा सकता है। उन्हें अलग-अलग स्ट्रिंग स्थिरांक में रखना बेहतर है, क्योंकि साइट का लेआउट लगातार बदल सकता है, और इसके साथ चयनकर्ता। फिर, चयनकर्ता को बदलते समय, इसे केवल एक स्थान पर बदलना होगा, और पूरे प्रोजेक्ट में 20 स्थानों पर नहीं।

कभी-कभी परीक्षण का पहला लॉन्च टाइमआउट से गिर सकता है, पहली बार जब ब्राउज़र ड्राइवर लॉन्च किया जाता है, तो पेज को लोड होने में लंबा समय लग सकता है। इसे कुछ टेस्ट टाइमआउट में बढ़ाया जाना चाहिए।

गुणवत्ता मानकों के अनुसार, ब्राउज़र में पेज लोड करने का समय 10 सेकंड है। पृष्ठ पर 11 सेकंड (अधिकतम 12) में एक तत्व खोजने के लिए समय सीमा निर्धारित करें।

पेज पर कुछ तत्वों को सेलेनियम + सी # का उपयोग करके इंटरैक्ट नहीं किया जा सकता है। इस मामले में, आपको ऐसे पृष्ठ तत्वों तक पहुंचने के लिए जावास्क्रिप्ट + JQuery का उपयोग करना चाहिए। एक उदाहरण:

जावास्क्रिप्ट + jQuery

 protected IJavaScriptExecutor _jsExecutor; var script = @"var c = $('table>tbody:visible').last();" + "c = c.find(\"tr:nth-child(2)\");" + "c.find(\"td:nth-child(1)\").click();"; _jsExecutor = (IJavaScriptExecutor)Driver; _jsExecutor.ExecuteScript(script);

सुविधा के लिए, रनिंग टेस्ट (NUnit सबसे सुविधाजनक चीज नहीं है), आप वैकल्पिक रूप से Visual Studio में ReSharper प्लगइन स्थापित कर सकते हैं, जिससे आप आसानी से परीक्षण चला सकते हैं और रन के परिणाम भी देख सकते हैं। लेकिन NUnit के विपरीत, ReSharper एक पेड ऐड-ऑन है।

निष्कर्ष

दुर्भाग्य से, इस लेख को सेलेनियम परीक्षणों को लिखने के लिए एक मार्गदर्शक नहीं माना जा सकता है, क्योंकि वेब अनुप्रयोगों के परीक्षण के तरीकों और विधियों का वर्णन यहां नहीं किया गया है। विशेष रूप से, एक वेब पेज पर तत्वों को खोजने के लिए परिस्थितियों और सेलेनियम विधियों की जाँच के लिए एसेर वर्ग। एक और लेख इसके लिए समर्पित होगा।
मुझे आशा है कि मेरे दृष्टिकोण का उपयोग कोई व्यक्ति अपने स्वचालित परीक्षणों को लिखने के लिए करेगा।
आपका ध्यान के लिए धन्यवाद!

सेलेनियम वेबड्राइवर 2.x पर आधारित स्वचालित परीक्षणों का विकास