脱・独自改造！ GebでWebDriverをもっとシンプルに

1. 1 第2回日本Seleniumユーザコミュニティ勉強会脱・独自改�造！ GGeebbでWWeebbDDrriivveerrをもっとシンプルに株式会社SHIFT 玉川紘子

2. 2 AAGGEENNDDAA n 自己紹介+α n Gebで便利になること n つまずくかもしれないこと n 工夫してみたこと n まとめ

3. 3 自己紹介名前：玉川紘子（たまがわひろこ）所属：株式会社SHIFT　ソフトウェアテスト事業本部　　　技術開発部コミュニティ：STAR（テスト自動化研究会）　　　　　　　日本Jenkinsユーザ会

4. 4 CCII・自動テストなんでも屋さんとして活動中開発言語：Java/PHP/Rubyなど業務でよく使うツール：Jenkins/Selenium メイン業務はCI・自動テストに関するなんでもお手伝い最近はJenkinsに関するセミナーなどもさせて頂いてます n 運用方針の提案 n 実際に稼働するCI環境の構築 n テストの書き方指南 Jenkinsってどうやって使えばいいんだっけ？ Seleniumでテストを書いてみたいんだけど…

5. 5 「実践 SSeelleenniiuumm WWeebbDDrriivveerr」を少しだけお手伝いしました n 翻訳＋付録Bは玉川竜司さん n 私は付録Aとして、Seleniumと Jenkinsの連携について寄稿させて頂きました ※竜司さんとは親戚ではありません今回は書籍の発売記念を兼ねてということで、竜司さんのおまけで声をかけていただきました。

6. 6 …が、

7. 7 Selenium×Jenkins連携の話は前回してしまったので（泣）、今⽇日は別のお話です。 Geb

8. 8 Gebのお話に行く前に WWeebbDDrriivveerr、そのままでは微妙ですよね n ちょっとしたことを書くにも、長い。。。 // テキスト入力 WebElement element = driver.findElement(By.name(“hoge”)); element.clear(); element.sendKeys(); // プルダウンの選択 Select select = new Select(driver.findElement(By.name(“fuga”))); select.selectByValue(“00”); n 大体みんな同じようなラッパーを作っている n と、前回の勉強会に出て思いました。

9. 9 Gebのお話に行く前に「あるある」で共感している場合なのか n みんなで同じものを作るのは勿体ない n OSSで提供されているライブラリも色々 n FluentLenium（Java） n Geb（Groovy） n テスト対象製品に依存しないような改良は、独自に行うのではなく既存ライブラリに頼ってしまおう

10. 10 GGeebbとは Gebで便利になること n 読み方は「じぇぶ」 n http://www.gebish.org/ n Groovyで動くWebDriverのラッパー n jQueryライクでわかりやすいLocator n コード量が少なく、すっきり書ける n テスト自動化研究会で@kyon_mmさんから教えてもらいました

11. 11 Gebで便利になることツールの立ち位置としてはこんな感じクロスブラウザ対応データ駆動テストブラウザ操作 WebDriver Geb テスティングフレームワーク JUnit TestNG Spock 言語 Java Groovy 強力なAssert

12. 12 サンプルコード Gebで便利になること import geb.Browser Browser.drive { go "http://myapp.com/login" assert $("h1").text() == "Please Login" $(“p”, text:”hoge”) $("form.login").with { username = "admin" password = "password" login().click() } assert $("h1").text() == "Admin Section" } 特定のURLを開いて見出しを確認フォームに入力してログイン見出しを確認

13. 13 Gebで便利になることサンプルコードをJJaavvaa&&WWeebbDDrriivveerrで書くと // importは省略 WebDriver driver = new FirefoxDriver(); driver.get(“http://myapp.com/login”); assertThat(driver.findElement(By.tag(“h1”)).getText(), is(“Please Login”)); WebElement form = driver.findElement(By.cssSelector(“form.login”)); WebElement userName = form.findElement(By.name(“username”)); userName.clear(); userName.sendKeys(“admin”); WebElement password = form.findElement(By.name(“password”)); password.clear(); password.sendKeys(“password”); form.findElement(By.name(“login”)).click(); assertThat(driver.findElement(By.tag(“h1”)).getText(), is(“Admin Section”));

14. 14 Gebで便利になることメリット①　記述量の少なさ n コードが短くなるポイントがいくつもある import geb.Browser Browser.drive { go "http://myapp.com/login" assert $("h1").text() == "Please Login" $("form.login").with { username = "admin" password = "password" login().click() } assert $("h1").text() == "Admin Section" } いちいちdriver.**と書かなくてもOK jQueryライクなセレクタ form内の要素はさらに簡単に記述 (name属性を使う)

15. 15 Gebで便利になることメリット②　「あるある」が解決済み n WebDriverの「あるある」独自改造が既に出来ている n テキスト入力のシンプル化 n WebDriverインスタンスの生成処理の外出し n 要素を見つけるときの待ち時間の変更 n テスト環境のURL

16. 16 Gebで便利になることメリット②　「あるある」が解決済み n テキスト入力のシンプル化 // Javaの場合、テキスト入力が長くなって面倒なので WebElement element = driver.findElement(By.id(“hoge”)); element.clear(); element.sendKeys(“fuga”); // 1行で出来るようにする MyDriver.setText(By.id(“hoge”), “fuga”); // Gebの場合、そもそも１行で書ける $(“#hoge”).value(“fuga”) n 割愛しますがプルダウンなども同様

17. 17 Gebで便利になることメリット②　「あるある」が解決済み n 設定系はGebConfig.groovyに集約 n クラスパス直下にこのファイル名で配置すると自動的に読み込まれる // WebDriverインスタンスの生成 driver = { new FirefoxDriver() } // 要素を見つけるときの待ち時間 waiting { timeout = 10 retryInterval = 0.5 } // テスト環境のURL baseUrl = ‘http://localhost:8000/example/’

18. 18 Gebで便利になることメリット③　もちろんPPaaggeeOObbjjeeccttもサポート class ExamplePage extends Page { // browser.toに対応 static url = “http://www.example.com/” // browser.atに対応 static at = { title = “Example Page” } // 操作したい各要素のlocatorを定義 static content = { textUserName { $(“input[name=user_name]”) } textMailAddress { $(“input[name=mail_address]”) } } } Browser.drive { to ExamplePage // ←urlで指定したURLへ遷移 /** 略 */ at ExamplePage // ←atの条件でassert }

19. Gebで便利になることメリット④　GGrroooovvyy//SSppoocckkの嬉しい機能が使える 19 n ブロックが使える n データ駆動テストがシンプルに書ける n モジュールが使える

20. Gebで便利になることメリット④　GGrroooovvyy//SSppoocckkの嬉しい機能が使える 20 n ブロックを使ってテストのフェーズを表現できる // テストの準備と後片付けの部分を明示 class LoginSpec extends GebSpec { def “IDとPWの組み合わせが正しい場合にログインできる” { setup: to “http://www.example.com/login/” when: $(“#loginId”).value(“user01”) $(“#password”).value(“pass01”) $(“#login”).click() then: at http://www.example.com/home/ cleanup: // } }

21. Gebで便利になることメリット④　GGrroooovvyy//SSppoocckkの嬉しい機能が使える 21 n データ駆動テストがシンプルに書ける // 異なるID/PWでログイン結果を検証 class LoginSpec extends GebSpec { def “IDとPWの組み合わせが正しくない場合ログインに失敗する” { when: $(“#loginId”).value(loginId) $(“#password”).value(password) $(“#login”).click() then: $(“#error”).text() == errorMessage where: loginId | password || errorMessage “” | “pass01” || “ログインIDを入力してください” “user01” | “” || “パスワードを入力してください” “hoge” | “fuga” || “IDとパスワードの組み合わせが正しくありません” } } ↑入力と期待値の間は「||」で分ける

22. Gebで便利になることメリット④　GGrroooovvyy//SSppoocckkの嬉しい機能が使える 22 n モジュールが使える n サイト内の共通メニュー、ECサイトのカートなど複数のページに共通する部品を表現するのに便利 // 普通のPageObjectのような感覚でModuleを実装 class CommonMenuModule extends Module { static content = { linkHome { $(“#home”) } linkLogout { $(“#logout”) } } } // PageObject内でフィールドとして扱う class ExamplePage extends Page { static content = { commonMenu { module CommonMenu } } }

23. 23 Gebで便利になることメリット⑤　JJaavvaaの資産が使える n GroovyはJavaの上位互換 n Javaのクラスをそのままインポート可能 n 原則、Javaの構文そのままでも記述できる n 日付処理や一意性確保等のために作ったユーティリティは引き続き使うことができる

24. 24 つまずくかもしれないこと SSyynnttaaxxの省略に注意 n 省略は便利だが、場合によってはミスを招くこともある n IDE上での補完に頼りたければ、多少長くなっても型を明記 // 省略あり to InputPage userName = “山田太郎” mailAddress = “taro.yamada@example.com” // 省略なし InputPage page = browser.to InputPage page.userName = “山田太郎” page.mailAddress = “taro.yamada@example.com” InputPageクラスのフィールド・メソッドが補完される

25. 25 つまずくかもしれないこと SSyynnttaaxxの省略に注意 n Implicit Assertionの使い方に注意 // assertを省略しても大丈夫なケース $(“p#message”).text() == “MESSAGE” waitFor { $(“p#message”).text() == “MESSAGE” } // assertを省略できないケース if (/** 条件 */) { assert $(“p#message”).text() == “MESSAGE” } n そもそも下の書き方（ケース内で分岐）は微妙 n どうしても避けられないなら全部にassertを入れる

26. 26 つまずくかもしれないこと PPaaggeeOObbjjeeccttの作り方に注意 n getter/setterを作らなくても動かせるので、ついつい生の処理を書いてしまいがち n PageObjectの意味がなくなってしまう // 悪い例【PageObject】 static content = { textLoginId { $(“#login_id”) } textPassword { $(“#password”) } buttonLogin { $(“#login”) } } 【TestCase】 loginPage.textLoginId = “user01” loginPage.textPassword = “pass01” buttonLogin.click()

27. 27 つまずくかもしれないこと PPaaggeeOObbjjeeccttの作り方に注意 n 保守性を意識してメソッドを切り分ける // 良い例【PageObject】 static content = { /** 略 */ } void login(String loginId, String password) { textLoginId = loginId textPassword = password buttonLogin.click() } 【TestCase】 loginPage.login(“user01”, “pass01”)

28. 28 ①失敗時のスクリーンショット取得 +αの工夫 n 前回も話題にした、個人的なこだわり n Spockのリスナ機能を使って実装 // テスト開始時・終了時・失敗時等のフックを定義できる class MyListener extends AbstractRunListener { def void error(ErrorInfo error) { // スクリーンショットを撮って保存 } } // 作成したリスナを登録する class GlobalSpecException implements IGlobalExtension { @Override void visitSpec(SpecInfo specInfo) { specInfo.addListener(new MyListener()) } }

29. 29 ②TTeessttSSuuiitteeの動的生成 +αの工夫 n 自動テストを作り始めの不安定な頃は「Jenkinsで実行したときだけテストが失敗する」みたいな事象もある n 失敗したケースだけを修正前後にサクッと実行できたら便利 // TestSuiteのテンプレート @RunWith(Suite) @SuiteClasses([%TEST_CLASS%]) class AllSpecifications {} n Jenkinsのパラメタで%TEST_CLASS%を置換

30. 30 まとめ n Gebを使うとWebDriverのコードがシンプルになる n 独自改造も減らすことができる n Javaの人もそうでない人も n Gebを使ってみましょう！

31. 31 最後になりますが、 SHIFTでは⾃自動化エンジニアを（これから始めたい⼈人も含めて）⼤大募集しております！！

32. 32 ご清聴ありがとうございました。

http://gihyo.jp	228
http://a-kura.hatenablog.jp	160
https://twitter.com	121
http://softwaretest.jp	112
http://rfp.hatenablog.com	77
http://www.crossl.net	72
http://nihonbuson.hatenadiary.jp	46
http://blog.hatena.ne.jp	30
https://confluence.gree-office.net	20
https://www.crossl.net	10
http://everyday-learning.hatenablog.com	1
http://activethreadintheworld.hatenablog.com	1
http://49.212.34.189	1

SlideShare for iOS

脱・独自改造！ GebでWebDriverをもっとシンプルに

by Hiroko Tamagawa , Working at 株式会社SHIFT

on Oct 18, 2014

Statistics

Views

Actions

13 Embeds 877

Accessibility

Categories

Upload Details

Usage Rights

Report content

脱・独自改造！ GebでWebDriverをもっとシンプルに Presentation Transcript