DEV Community

Cover image for How To Test PDF Files Using Selenium Automation?
Shalini Baskaran for LambdaTest

Posted on • Updated on • Originally published at lambdatest.com

How To Test PDF Files Using Selenium Automation?

PDF documents are small-sized, highly secure files. Almost all businesses use PDFs for processing their files. The reason being a distinguishing feature of maintaining format regardless of the tool used to access PDF files. It’s no surprise that all our invoices, official documents, contractual documents, boarding pass, bank statements, etc. are usually in PDF format.

Even as developers, we come across scenarios when a PDF file needs to be verified or used to locate certain parts of data. You can either do this manually given that you have loads of time to spare or you opt for automation testing. When it comes to handling tricky components of such files using automation, it might seem a bit too tricky. But that’s not the case. Selenium test automation can make it really easy to test PDF file formats.

In this blog post, we will be exploring the knotty topic of Selenium testing PDF files and come up with different solutions to handle a PDF document using automation.

Why Is It Important To Test A PDF File?

In today’s world, PDF file format is used standardly for generating official letters, documents, contracts, and other important files. Primarily because PDF cannot be edited while a Word format can be. Hence storing confidential information in PDF format is considered a good security practice.

Such high-security documents must always be incorporated with accurate details and it has to be ensured that the information provided is verified. A PDF document needs to be generated in such a way that it is readable by humans but not by machines. Validating and verifying the documents could be easy when done manually but it poses a major time-related challenge.

What happens when verification has to be automated?

That’s one of the complexities that automation testers face and this is where Selenium testing PDF files comes in. Let me give you a practical example where testing the PDF documents becomes a basic design requirement.

In banking systems, when we require our account statement for a specific period, the statement would be downloaded in PDF format. This document would contain the basic information of the user and the transactions for the period prescribed.

If this design wasn’t verified with high accuracy before going live, the end-user would face multiple discrepancies in their account statements. Hence the person responsible for testing this requirement has to make sure that all the details printed in the account statement exactly match the information or actions performed by the customer.

I hope this exemplifies the resourcefulness of Selenium testing PDF files. Let’s start this Selenium testing PDF files tutorial by showing you the different operations that can be performed for PDF testing using Selenium.

How To Handle PDF In Selenium Webdriver?

To handle a PDF document in Selenium test automation, we can use a java library called PDFBox. Apache PDFBox is an open-source library that exclusively helps in handling the PDF documents. We can use it to verify the text present in the document, extract a specific section of text or image in the documents, and so on. To use this in Selenium testing PDF files, we need to either add the maven dependency in the pom.xml file or add it as an external jar.

To add as a maven dependency:

  1. Navigate to the below URL

https://mvnrepository.com/artifact/org.apache.pdfbox

  1. Select the latest version and place in the pom.xml file. The maven dependency would look like below
<dependency>
    <groupId>org.apache.pdfbox</groupId>
    <artifactId>pdfbox</artifactId>
    <version>2.0.20</version>
</dependency>
Enter fullscreen mode Exit fullscreen mode

To add as an external jar:

  1. Download the jar file in the below path https://repo1.maven.org/maven2/org/apache/pdfbox/pdfbox/2.0.20/
  2. Go to your project and select configure Build Path and add the external jar file as below.
  3. Once you have added the dependency or jar in your project you are good to go with the coding part.

Note- Video Tracks is a method of specifying and selecting between multiple video tracks. Useful for providing sign language tracks, burnt-in captions or subtitles, alternative camera angles, etc. It works on all the major browsers.

Verify The Content In The PDF

Next in this tutorial about Selenium testing PDF files, we find out how to verify the PDF’s content. To check if a specific text piece is present in a PDF document we use PDFTextStripper which can be imported from org.apache.pdfbox.util.PDFTextStripper.

This is the code we can use for PDF testing using Selenium and verify its content.

package Automation;

import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.MalformedURLException;
import java.net.URL;

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.text.PDFTextStripper;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.testng.Assert;
import org.testng.annotations.AfterTest;
import org.testng.annotations.BeforeTest;
import org.testng.annotations.Test;

public class PdfHandling {

    WebDriver driver = null;

    @BeforeTest
    public void setUp() {
        //specify the location of the driver
        System.setProperty("webdriver.chrome.driver", "C:\\Users\\Shalini\\Downloads\\Driver\\chromedriver.exe");

        //instantiate the driver
        driver = new ChromeDriver();
    }

    @Test
    public void verifyContentInPDf() {
        //specify the url of the pdf file
        String url ="http://www.pdf995.com/samples/pdf.pdf";
        driver.get(url);
        try {
            String pdfContent = readPdfContent(url);
            Assert.assertTrue(pdfContent.contains("The Pdf995 Suite offers the following features"));
        } catch (MalformedURLException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    @AfterTest
    public void tearDown() {
        driver.quit();
    }


    public static  String readPdfContent(String url) throws IOException {

        URL pdfUrl = new URL(url);
        InputStream in = pdfUrl.openStream();
        BufferedInputStream bf = new BufferedInputStream(in);
        PDDocument doc = PDDocument.load(bf);
        int numberOfPages = getPageCount(doc);
        System.out.println("The total number of pages "+numberOfPages);
        String content = new PDFTextStripper().getText(doc);
        doc.close();

    return content;
}

    public static int getPageCount(PDDocument doc) {
        //get the total number of pages in the pdf document
        int pageCount = doc.getNumberOfPages();
        return pageCount;

    }

}

Enter fullscreen mode Exit fullscreen mode
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
<suite name="PDF Handling">
  <test name="Verify Pdf content">
      <classes>
      <class name="Automation.PdfHandling"/>
      </classes>
  </test> 
 </suite>
Enter fullscreen mode Exit fullscreen mode

To run the test, click on the class -> Run As -> TestNG Test.

The output console would be showing the default test report indicating the success and failure cases.

pdf testing in selenium

TestNG console

Handling_PDF_In_Selenium

Download PDF file

Sometimes before starting off with Selenium testing PDF files, we need to download them. To download the PDF file from a webpage, we need to specify the locator to identify the link to download. We also need to disable the popup window which asks us to specify the path in which the downloaded file has to be placed.

This is the code that can be used for downloading PDFs before we start Selenium testing PDF files.

package Automation;

import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.TimeUnit;

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.chrome.ChromeOptions;
import org.testng.annotations.AfterTest;
import org.testng.annotations.BeforeTest;
import org.testng.annotations.Test;

public class DownloadPdf {

    WebDriver driver = null;
    @BeforeTest
    public void setUp() {
        System.setProperty("webdriver.chrome.driver", "C:\\Users\\Shalini\\Downloads\\Driver\\chromedriver.exe");

        ChromeOptions options = new ChromeOptions();
        Map<String, Object> prefs = new HashMap<String, Object>();
        prefs.put("download.prompt_for_download", false);
        options.setExperimentalOption("prefs", prefs);
        driver = new ChromeDriver(options);
    }


    @Test
    public void downloadPdf() {
    driver.manage().timeouts().implicitlyWait(30, TimeUnit.SECONDS);
    driver.manage().window().maximize();
    driver.get("https://www.learningcontainer.com/sample-pdf-files-for-testing");

    //locator to click the pdf download link
    driver.findElement(By.xpath("//*[@id=\"bfd-single-download-810\"]/div/div[2]/a/p[1]/strong")).click();
    }

    @AfterTest
    public void tearDown() {
        driver.quit();

    }

}

Enter fullscreen mode Exit fullscreen mode

Console output

Console output

TestNG output console

TestNG output console

Note- Add to home screen (A2HS) is a A web app installed in a browser tab can feel like an installed native app. By serving it with a valid manifest and loading it through a service worker, web apps can better adapt to different browsers and provide enhanced interactions.

Set The Start Of The PDF Document

Verifying a small PDF file would be an easy task with Selenium testing PDF files. But what will you do for larger sized files? The solution is simple. You can set the starting page of the PDF and proceed with your validation of PDF testing using Selenium.

If you look at the sample PDF link that I have mentioned in this article, it contains 5 pages and the introduction starts on page 2. If the startpage is set as 2 in the code and the text is printed, you may see the content which has been printed from the second page. As said earlier, if the file size is large, you may set the start of the document, extract the content, and just validate the content.

Below is the simple code to set the start of the document for Selenium testing PDF files.

package Automation;

import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.MalformedURLException;
import java.net.URL;

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.text.PDFTextStripper;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.testng.Assert;
import org.testng.annotations.AfterTest;
import org.testng.annotations.BeforeTest;
import org.testng.annotations.Test;

public class ExtractContent {

    WebDriver driver = null;

    @BeforeTest
    public void setUp() {
        //specify the location of the driver
        System.setProperty("webdriver.chrome.driver", "C:\\Users\\Shalini\\Downloads\\Driver\\chromedriver.exe");

        //instantiate the driver
        driver = new ChromeDriver();
    }

    @Test
    public void verifyContentInPDf() {
        //specify the url of the pdf file
        String url ="http://www.pdf995.com/samples/pdf.pdf";
        driver.get(url);
        try {
            String pdfContent = readPdfContent(url);
            System.out.println(pdfContent);
            Assert.assertTrue(pdfContent.contains("Introduction"));
        } catch (MalformedURLException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    @AfterTest
    public void tearDown() {
        driver.quit();
    }


    public static  String readPdfContent(String url) throws IOException {

        URL pdfUrl = new URL(url);
        InputStream in = pdfUrl.openStream();
        BufferedInputStream bf = new BufferedInputStream(in);
        PDDocument doc = PDDocument.load(bf);
        PDFTextStripper pdfStrip = new PDFTextStripper();
        pdfStrip.setStartPage(2);
        String content = pdfStrip.getText(doc);
        doc.close();

    return content;
}

    public static int getPageCount(PDDocument doc) {
        //get the total number of pages in the pdf document
        int pageCount = doc.getNumberOfPages();
        return pageCount;

    }

}

Enter fullscreen mode Exit fullscreen mode

Console output

The console shows the content starting from the second page.

selenium automation testing

As we have discussed earlier in this tutorial for Selenium testing PDF files- When the file size is large, you can set the start page of the document and extract the content and proceed with your validation.

But what if you have to print the entire content of a specific page?

If we set only the start page and print the content, then all the contents starting from the specified page will be printed till the end of the document. In case if the file size is large that’s not a good option. Instead, we can set the end page of the document too!

Wouldn’t that make Selenium testing PDF files easier?

If we wish to print the contents starting from page 2 to page 3 we can set the below option in our code.

pdfStrip.setStartPage(2);
pdfStrip.setEndPage(3);
Enter fullscreen mode Exit fullscreen mode

If we want to print the entire content of a single page, we can mention the same page number as the start as well as the end page.

pdfStrip.setStartPage(2);
pdfStrip.setEndPage(2);
Enter fullscreen mode Exit fullscreen mode

In the next section of this Selenium testing PDF files tutorial, we will take a look at PDF testing using Selenium Grid on a cloud-based platform.

Note- Audio element is used on a web page, it allows you to play audio in a lightweight and easy-to-implement manner. It supports the currentSrc, currentTime, paused, playRate, buffered, duration, played, seekable, ended, autoplay, loop, controls, volume & muted MediaPropTypes.

PDF Testing Using Selenium LambdaTest Grid

All the operations for PDF testing using Selenium that we performed above can also be executed on an online Selenium grid. LambdaTest grid provides a great option to automate the tests in the cloud. We can carry out tests in multiple environments or browsers which helps us to determine the behavior of the web pages.

Using LambdaTest, you can perform Selenium testing PDF files on 2000+ browsers, devices, and operating systems. Now in this Selenium testing PDF files tutorial, we will see how to implement the same PDF operations that were handled above in the LambdaTest grid.

To do Selenium testing PDF files in the LambdaTest grid, we need to create an account. You can sign up here for free.

Once signed in, you will be provided with a Username and an Access Key which can be viewed by clicking the key icon as highlighted below.

online Selenium grid

The Username and the Access Key has to be replaced in the code given below.

package Automation;

import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.MalformedURLException;
import java.net.URL;

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.text.PDFTextStripper;
import org.openqa.selenium.remote.DesiredCapabilities;
import org.openqa.selenium.remote.RemoteWebDriver;
import org.testng.Assert;
import org.testng.annotations.AfterTest;
import org.testng.annotations.BeforeTest;
import org.testng.annotations.Test;

public class PdfHandlingInGrid {


    String username = "Your username";      //Enter your username 
    String accesskey = "Your access Key";       //Enter your accesskey
    static RemoteWebDriver driver = null;
    String gridURL = "@hub.lambdatest.com/wd/hub";

    boolean status = false;

    @BeforeTest
    public void setUp()throws MalformedURLException  
    {           

        DesiredCapabilities capabilities = new DesiredCapabilities();
        capabilities.setCapability("browserName", "chrome");      //To specify the browser
        capabilities.setCapability("version", "70.0");            //To specify the browser version
        capabilities.setCapability("platform", "win10");          // To specify the OS
        capabilities.setCapability("build", "PdfTestLambdaTest"); //To identify the test 
        capabilities.setCapability("name", "PDFHandling");
        capabilities.setCapability("network", true);        //To enable network logs
        capabilities.setCapability("visual", true);                   // To enable step by step screenshot
        capabilities.setCapability("video", true);          // To enable video recording
        capabilities.setCapability("console", true);            // To capture console logs
        try {
            driver = new RemoteWebDriver(new URL("https://" + username + ":" + accesskey + gridURL), capabilities);
        } catch (MalformedURLException e) {
            System.out.println("Invalid grid URL");
        } catch (Exception e) {
            System.out.println(e.getMessage());
        }

}


        @Test
        public void pdfHandle() {
            String url ="http://www.pdf995.com/samples/pdf.pdf";
            driver.get(url);
            try {
                String pdfContent = readPdfContent(url);
                System.out.println(pdfContent);
                Assert.assertTrue(pdfContent.contains("Introduction"));
            } catch (MalformedURLException e) {
                e.printStackTrace();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }

     @AfterTest
     public void tearDown() {
        driver.quit();
}    

     public static  String readPdfContent(String url) throws IOException {

         URL pdfUrl = new URL(url);
        InputStream in = pdfUrl.openStream();
        BufferedInputStream bf = new BufferedInputStream(in);
        PDDocument doc = PDDocument.load(bf);
        PDFTextStripper pdfStrip = new PDFTextStripper();
        pdfStrip.setStartPage(2);
        pdfStrip.setEndPage(2);

        String content = pdfStrip.getText(doc);
        doc.close();
        return content;
    }

    public static int getPageCount(PDDocument doc) {
        int pageCount = doc.getNumberOfPages();
        return pageCount;

    }
}
Enter fullscreen mode Exit fullscreen mode

TestNG.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
<suite name="PDF Handling">
  <test name="Verify Pdf content">
      <classes>
      <class name="Automation.PdfHandlingInGrid"/>
      </classes>
  </test> 
 </suite>
Enter fullscreen mode Exit fullscreen mode

Console output

The console output shows the content of the PDF document only in the second page as both the start as well end page is given the same.

handling pdf in selenium

The next major step in Selenium testing PDF files is to view the test results and verify them. Once you’ve executed the test cases successfully, navigate to the LambdaTest dashboard page. This page shows a brief description on the tests that have been run.

LambdaTest Dashboard

To get detailed information about each and every test, navigate to the Automation tab.

Automation tab

The tests that are run in the LambdaTest grid would be placed in a directory that was provided in the source code. In the code, we have set the path name as PdfTestLambdaTest which would help us locate our tests in the dashboard.

capabilities.setCapability("build", "PdfTestLambdaTest"); //To identify the test 
Enter fullscreen mode Exit fullscreen mode

LambdaTest also provides various filters to identify the tests run. The tests could be filtered based on the day of execution, build a name, and also the status of the build. By clicking the build we will be navigated to the detailed tests page where all the tests that were run in the specific build would be listed.

Information about the browser, its version, the status of the tests would be listed out and the tests are recorded while running in the grid and any failure during test execution could be easily tracked and fixed with help of the video recording feature. This takes Selenium testing PDF files to a whole another level.

Below is the screenshot of the test results that have been run in the LambdaTest grid.

selenium automation testing

Wrapping Up!

So far, I have explained the need for PDF testing using selenium. This post about Selenium testing PDF files explained everything about using Apache PDFBox, using PDFTextStripper, and using TestNG asserts. From extracting content from a specific page to validating its content, you can perform all those operations in LambdaTest.

Handling PDF and validating it in Selenium test automation could be quite tricky. I hope you all have got sound knowledge on Selenium testing PDF files. Share your experience below if you have faced any other challenges in handling a PDF file. We’d love to get feedback about this article on Selenium testing PDF files. Please do share this article with your peers and colleagues as it might be helpful to them. Stay tuned until then Happy testing..!!!

Top comments (0)