【Node.js】Seleniumでテスト自動化ツール用ライブラリを作った

Code

はじまり

135ml
135ml

ぐぬう・・・、

リサちゃん
リサちゃん

おーい、夕飯できたぞい。

135ml
135ml

あー、ちょっと待ってくれえ。これが終わったら行くから。

リサちゃん
リサちゃん

はいよ。

30分後・・・

135ml
135ml

ぐぬぬぬう・・・、

リサちゃん
リサちゃん

おーい、夕飯冷めちまうぞお。

135ml
135ml

あー、ちょっと待ってくれえ。これが終わったら行くから。

リサちゃん
リサちゃん

はいよー。

1時間後・・・

135ml
135ml

ぐぬぬぬんんう・・・、

リサちゃん
リサちゃん

おーい! いつまでやってんだあ!?

135ml
135ml

あー、いくいく、いきますいきます。

タタタタタ・・・

リサちゃん
リサちゃん

だいぶ遅くなったね。一体何してるんだい?

135ml
135ml

仕事でやっているテスト作業が終わらんくてなあ。夕飯の前には片付けるつもりだったんだが、なかなか厄介でややこしくてなあ・・・。

リサちゃん
リサちゃん

あー、システムの動作確認ねえ。インターンでやったけど、本当あれめんどくさいよねえ。

135ml
135ml

うむ、OutSystemsで作ったシステムだから、打鍵しないと確認できなくてなあ・・・。せっかく、製造で工数を減らしているのに、テストコードを書けないのはネックだよな。

一体どうすりゃこんな膨大な手作業を無くせるんだあ・・・。

リサちゃん
リサちゃん

もー、しょうがないなあ・・・。

135ml
135ml

へ・・・?

リサちゃん
リサちゃん

テッテレ〜! Selenium〜!

135ml
135ml

あれ? まるで、ド◯えもんのような容姿になった? 声も変わった?

リサちゃん
リサちゃん

容姿が変わったのは錯覚だね。それから声も変わってないね。ヘリウムじゃなくてセレニウムだね。

なんか、いろんな言語で使えるテスト自動化モジュールっぽいよ。

135ml
135ml

おー! じゃあ、今回はそれを使ってみるか!

Seleniumについて

Seleniumとは、テスト自動化ツールであり、主にJava、Ruby、Python、Javascriptで使用できます。今回は、Javascript(Node.js)上で動くテスト自動化ツールを作っていきました。利用したOSはWindows 10で、ブラウザはChromeです。

Seleniumを使える環境を作る

まずは環境構築です。最初にNode.jsをインストールします。こんなPowershellの画像が出てきたらインストール完了です。

次に、npm installします。

npm install selenium-webdriver --save
npm install mocha --save

そしたら、最後にchromedriverを入手します。僕はこのページから入手しました。

そして、入手したchromedriverを実行したいフォルダの中に置いたら、Seleniumを実行する環境は完成です!

最小構成

EXECUTION DIRECTORY
│  chromedriver.exe
│  index.js
│  package.json

このフォルダの状態で以下のコマンドを実行すると、テストが開始されます。

npx mocha index.js --timeout 0

Package.jsonの中身

Package.jsonはそのフォルダ内に適用されるコンフィグの意味合いを持つファイルです。

そして、Package.jsonを編集すると、実行するスクリプトを短く出来ます。例えば以下のように設定するとこのように入力するとテストを開始できます。

Package.json

{
    "scripts": {
        "psl": "npx mocha kouhochi-ichiran.js --timeout 0"
    }
}

シェル

npm run psl

ツールを作るためのライブラリ

今回、テスト自動化ツールを作るためのライブラリを作りました。ソースは以下のリポジトリのディレクトリにあります。

Build software better, together
GitHub is where people build software. More than 100 million people use GitHub to discover, fork, and contribute to over...

主なものを紹介していきます。

lib-variables.js📖

このファイルにはクラスだけが入っています。そして、それらのクラスは、変数として使用してもらうための属性値を持っています。例えば、個々の画面の各々の要素のXPathが入っていたりします。

lib-methods.js🦾

関数とクラスが入っているファイルです。テストをするためによく使う処理をまとめました。

OperatorやInspectorは、基本的にとある属性(もしくは要素)からどの属性(もしくは要素)を取得したりクリックするかが記述されたメソッドを持っているクラスになります。こんなイメージです。

Functions 🔧

sleep

レンダリングが終わるであろう時間だけ処理を待ちます。

assertEqual_and_log

アサーションを行って、同時にログも出力します。

outputLog

ログを出力します。

getStrRepeatedToMark

引数の文字列を繰り返して出力します。主にログの部分を見やすくするために使います。

Classes 👨‍👨‍👧‍👦

Operator 🖱

画面をスクロールしたり、クリックしたりする係です。クリックする際に同時に画面をスクロールするように実装しているつもりです。openAppViaO365()についてはこの記事で紹介しています。

Inspector 🔍

画面の要素から属性値を取得したりする係です。getPseudoElementsContentsByClassName()についてはこの記事で紹介しています。

Photographer 📸

画面をスクショする係です。

Gofer 🧹

雑用です。 今のところ、配列をエクセルに貼り付けやすい形で出力したり、数字を0埋めします。

getXpathByElement.js🧗

こちらは、ブラウザ上で入力するスクリプトが記載されているファイルになります。詳細は以下のページで紹介しているので割愛します。

【Node.js、Javascript】Seleniumで要素のXPathを一気に取得する。 - Qiita
はじまり一般的にDOMから要素のXPathを取得する方法は、ブラウザの開発者ツールからとされています。しかし、Seleniumで要素にアクセスするためにいちいちDOMを右クリックしてXPathを…

おしまい

135ml
135ml

おし、なんとかテスト自動化の土台ができたな・・・

リサちゃん
リサちゃん

お〜、どんなふうに動いているんだい?

135ml
135ml

実際に顧客が使っているシステムだから、画面キャプチャができないんだよな・・・。その画面を貼れないことが残念だわ・・・。

リサちゃん
リサちゃん

そっか残念。まあ、これでOutSystemsを始めとした、ローコードやノーコードで作られたシステムの開発工数を下げられたらいいね。

以上になります!

コメント

タイトルとURLをコピーしました