3.20. Seitenzahlen als Testziel

Überblick

Es ist manchmal sinnvoll, zu prüfen, ob ein erzeugtes PDF-Dokument genau eine Seite hat. Oder Sie müssen sicherstellen, dass das Dokument weniger als 6 Seiten umfasst, weil sonst ein höheres Porto anfällt. PDFUnit bietet deshalb Tags an, um die Anzahl der Seiten zu überprüfen:

<!-- Tags to verify page numbers: -->

<hasNumberOfPages />
<hasLessPages than=".."  (required)
/>
<hasMorePages than=".."  (required)
/>

Beispiele

Eine konkrete Seitenanzahl wird folgendermaßen überprüft:

<testcase name="hasNumberOfPages">
  <assertThat testDocument="format/format_Letter-Portrait.pdf">
    <hasNumberOfPages>1</hasNumberOfPages>
  </assertThat>
</testcase>

Es sind aber auch Tests mit minimaler oder maximaler Seitenzahl möglich:

<testcase name="hasNumberOfPagesLessThan">
  <assertThat testDocument="format/format_multiple-formats-on-individual-pages.pdf">
    <hasLessPages than="6" /> <!-- The document has 5 pages. -->
  </assertThat>
</testcase>
<testcase name="hasMorePagesThan">
  <assertThat testDocument="format/format_multiple-formats-on-individual-pages.pdf">
    <hasMorePages than="2" /> <!-- The document has 5 pages. -->
  </assertThat>
</testcase>

Die Werte für Ober- und Untergrenze gelten exklusiv.

Auf beide Grenzen kann gleichzeitig getestet werden:

<!-- 
  Validating that a document has a number of pages in a allowed range.
-->
<testcase name="hasNumberOfPages_InRange">
  <assertThat testDocument="format/format_multiple-formats-on-individual-pages.pdf">
    <hasMorePages than="2" />
    <hasLessPages than="8" />
  </assertThat>
</testcase>

Verzichten Sie nicht auf Tests mit Seitenzahlen weil Sie denken, sie seien zu einfach. Erfahrungsgemäß finden Sie im Umfeld eines einfachen Tests Dinge, die Sie ohne den Test nicht gefunden hätten.