How To Verify Text In Pdf File Using Selenium Webdriver
PDF documents are pocket-sized-sized, highly secure files. Almost all businesses utilise PDFs for processing their files. The reason being a distinguishing characteristic of maintaining format regardless of the tool used to admission PDF files. It's no surprise that all our invoices, official documents, contractual documents, boarding laissez passer, bank statements, etc. are normally 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 tin can either do this manually given that you have loads of time to spare or you opt for automation testing. When information technology comes to handling tricky components of such files using automation, it might seem a bit too catchy. But that's not the example. Selenium exam automation tin make information technology really easy to exam PDF file formats.
In this weblog 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.
If you lot're new to Selenium and wondering what it is then we recommend checking out our guide – What is Selenium?
TABLE OF CONTENT
- Why Is It Important To Test A PDF File?
- How To Handle PDF In Selenium Webdriver?
- Verify The Content In The PDF
- Download PDF file
- Set The Start Of The PDF Certificate
- PDF Testing Using Selenium LambdaTest Filigree
- How To View Our Tests In LambdaTest Dashboard?
Why Is It Of import To Exam A PDF File?
In today's world, PDF file format is used standardly for generating official letters, documents, contracts, and other important files. Primarily considering PDF cannot exist edited while a Word format tin can be. Hence storing confidential data in PDF format is considered a practiced security practise.
Such loftier-security documents must ever be incorporated with authentic details and it has to exist ensured that the information provided is verified. A PDF document needs to be generated in such a way that it is readable by humans only not by machines. Validating and verifying the documents could be easy when done manually simply it poses a major time-related claiming.
What happens when verification has to be automated?
That's i of the complexities that automation testers face and this is where Selenium testing PDF files comes in. Permit me give you a practical case where testing the PDF documents becomes a basic design requirement.
In banking systems, when we crave our business relationship statement for a specific menstruation, the statement would be downloaded in PDF format. This document would contain the bones information of the user and the transactions for the catamenia prescribed.
If this design wasn't verified with loftier accuracy before going live, the end-user would face up multiple discrepancies in their account statements. Hence the person responsible for testing this requirement has to brand certain that all the details printed in the account statement exactly friction match the information or actions performed past the customer.
I promise this exemplifies the resourcefulness of Selenium testing PDF files. Permit's start this Selenium testing PDF files tutorial by showing you the unlike operations that can exist performed for PDF testing using Selenium.
Why Selenium Automation Testing Is Pivotal For Your Next Release?
How To Handle PDF In Selenium Webdriver?
To handle a PDF document in Selenium examination automation, nosotros can utilize a java library called PDFBox. Apache PDFBox is an open-source library that exclusively helps in treatment the PDF documents. We can use information technology to verify the text nowadays 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 together the maven dependency in the pom.xml file or add it as an external jar.
To add together equally a maven dependency:
- Navigate to the below URL
https://mvnrepository.com/artifact/org.apache.pdfbox
- Select the latest version and identify 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 >
To add every bit an external jar:
- Download the jar file in the below path
https://repo1.maven.org/maven2/org/apache/pdfbox/pdfbox/2.0.20/
- Become to your projection and select configure Build Path and add the external jar file as below.
- Once you lot have added the dependency or jar in your project you are skillful to go with the coding part.
Verify The Content In The PDF
Adjacent in this tutorial about Selenium testing PDF files, we find out how to verify the PDF's content. To bank check if a specific text piece is nowadays in a PDF certificate we use PDFTextStripper which can exist imported from org.apache.pdfbox.util.PDFTextStripper.
This is the code nosotros can employ for PDF testing using Selenium and verify its content.
To run the test, click on the class -> Run As -> TestNG Test.
The output console would be showing the default exam report indicating the success and failure cases.
TestNG console
Practice yous know how to upload and download a file in Selenium? Watch this video to learn how to upload and download files in Selenium WebDriver using different techniques.
Download PDF file
Sometimes before starting off with Selenium testing PDF files, nosotros need to download them. To download the PDF file from a webpage, nosotros need to specify the Selenium locator to place 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 tin be used for downloading PDFs earlier we showtime Selenium testing PDF files.
Console output
TestNG output console
Set The Start Of The PDF Document
Verifying a small PDF file would be an easy task with Selenium testing PDF files. Just what will yous do for larger sized files? The solution is unproblematic. You can set the starting page of the PDF and continue with your validation of PDF testing using Selenium.
If yous await at the sample PDF link that I have mentioned in this article, it contains 5 pages and the introduction starts on page ii. If the startpage is prepare as ii in the code and the text is printed, y'all may see the content which has been printed from the second page. As said earlier, if the file size is big, you may ready the offset of the document, extract the content, and just validate the content.
Below is the elementary code to fix the get-go of the certificate for Selenium testing PDF files.
Console output
The console shows the content starting from the second page.
Equally we accept discussed earlier in this tutorial for Selenium testing PDF files- When the file size is large, yous tin can set the first folio of the document and excerpt the content and proceed with your validation.
Only what if yous have to print the unabridged content of a specific folio?
If we set simply the offset page and print the content, then all the contents starting from the specified folio will be printed till the end of the document. In instance if the file size is large that's non a good option. Instead, we can gear up the cease page of the document likewise!
Wouldn't that make Selenium testing PDF files easier?
If nosotros wish to print the contents starting from page 2 to page 3 we can set up the below option in our code.
| pdfStrip . setStartPage ( 2 ) ; pdfStrip . setEndPage ( 3 ) ; |
If we want to print the entire content of a single page, we can mention the same page number every bit the start equally well as the cease folio.
| pdfStrip . setStartPage ( 2 ) ; pdfStrip . setEndPage ( 2 ) ; |
In the adjacent section of this Selenium testing PDF files tutorial, we volition take a await at PDF testing using Selenium Grid on a cloud-based platform.
PDF Testing Using Selenium LambdaTest Grid
All the operations for PDF testing using Selenium that nosotros performed above can also be executed on an online Selenium grid. LambdaTest filigree provides a bang-up pick to automate the tests in the cloud. We tin carry out tests in multiple environments or browsers which helps the states to determine the behavior of the spider web pages.
Using LambdaTest, you tin can perform Selenium testing PDF files on 3000+ browsers, devices, and operating systems. Now in this Selenium testing PDF files tutorial, we will come across 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 lot can sign upward here for costless.
One time signed in, you will exist provided with a Username and an Access Central which tin be viewed by clicking the fundamental icon equally highlighted below.
The Username and the Access Central has to exist replaced in the lawmaking given below.
TestNG.xml
| <? xml version = "ane.0" encoding = "UTF-viii" ?> < ! DOCTYPE suite SYSTEM "http://testng.org/testng-one.0.dtd" > < suite name = "PDF Handling" > < exam name = "Verify Pdf content" > < classes > < form name = "Automation.PdfHandlingInGrid" / > < / classes > < / examination > < / suite > |
Panel output
The console output shows the content of the PDF document only in the 2d page every bit both the showtime likewise end folio is given the same.
How To View Your Tests In LambdaTest Dashboard?
The next major footstep 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 cursory description on the tests that take been run.
To go detailed data most each and every test, navigate to the 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, nosotros have set the path name as PdfTestLambdaTest which would help us locate our tests in the dashboard.
| capabilities . setCapability ( "build" , "PdfTestLambdaTest" ) ; //To identify the exam |
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 exist navigated to the detailed tests folio where all the tests that were run in the specific build would exist listed.
Information about the browser, its version, the status of the tests would exist listed out and the tests are recorded while running in the grid and any failure during test execution could exist easily tracked and fixed with help of the video recording feature. This takes Selenium testing PDF files to a whole some other level.
Below is the screenshot of the test results that have been run in the LambdaTest grid.
Wrapping Upwards!
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 exam automation could be quite catchy. I hope you lot all have got sound knowledge on Selenium testing PDF files. Share your feel below if you have faced whatsoever other challenges in treatment a PDF file. We'd beloved to get feedback about this article on Selenium testing PDF files. Delight do share this commodity with your peers and colleagues as it might be helpful to them. Stay tuned until and so Happy testing..!!!
How To Verify Text In Pdf File Using Selenium Webdriver,
Source: https://www.lambdatest.com/blog/selenium-testing-pdf-files/
Posted by: johnsoncrivair.blogspot.com
0 Response to "How To Verify Text In Pdf File Using Selenium Webdriver"
Post a Comment