勉強日記

チラ裏

PHPUnit自作アサーション/HTMLを解析するテスト

PHPUnit 開発環境 OSS活動

github.com

f:id:wand_ta:20191116014204p:plain

モチベーション

  • '19/11/16時点で、フロントエンドで高度なことをせず、サーバが返したHTMLをそのまま返すような古き良きアプリケーションの開発に携わっている
    • AjaxでJSONに色を付けたりしない
  • 下記のような表示系テストを、わざわざブラウザで行いたくない
    • データは所定の件数表示される
    • データ表示内容が所定の値である
    • 情報aは権限Aを持つユーザにのみ表示される
  • アプリケーションサーバがPHPなのでPHPUnitでテストしたい
  • Constraintとしてプロジェクト横断的に再利用できるようにしたい

作ったもの

  • 下記Constraint
    • CSSセレクタで特定されるHTML要素の個数のアサート
    • CSSセレクタで特定される最初のHTML要素の、innerTextの内容一致アサート
  • ConstrantのラッパAssertion
    • traitにまとめた

依存

  • SymfonyにHTML解析ライブラリがあったんですね

qiita.com

つかいかた

<?php

    /**
     * @test
     */
    public function assertHtmlNodeCount_works()
    {
        $this->assertHtmlNodeCount(
            'div',
            3,
            <<<EOL
<html>
  <body>
    <div class="item">1</div>
    <div class="item">2</div>
    <div class="item">3</div>
  </body>
</html>
EOL
        );
    }

    /**
     * @test
     */
    public function assertHtmlNodeInnerText_works()
    {
        $this->assertHtmlNodeInnerText(
            'div.item:nth-of-type(2)',
            '2',
            <<<EOL
<html>
  <body>
    <div class="item">1</div>
    <div class="item">2</div>
    <div class="item">3</div>
  </body>
</html>
EOL
        );
    }

future work

  • Constraint/Assertionを増やす
    • 属性
    • innerHTML
  • 「内容一致」の判定の汎用化
    • 部分一致
    • regex
    • 述語関数を渡せるようにする
  • Symfonyコンポーネントに直接依存しているのをやめる
    • nodejsでパースできたほうがなんとなく安心じゃないですか