Processing PDF Documents

A comprehensive skill for creating, reading, and manipulating PDF documents programmatically using the Syncfusion JavaScript PDF library. This library provides seamless integration for TypeScript, JavaScript, Angular, React, Vue, ASP.NET Core, and ASP.NET MVC applications.

When to Use This Skill

Use this skill when the user needs to:

Create PDF documents from scratch with text, images, shapes, and other graphical elements
Manipulate existing PDFs by adding content, modifying properties, or extracting data
Add interactive features such as forms, annotations, bookmarks, and hyperlinks
Secure PDFs with digital signatures
Merge or split PDF documents for document management workflows
Extract content including text and images from existing PDFs
Add watermarks (text or image-based) for branding or security
Manage document informations including title, author, subject, keywords, and dates
Work with PDF layers for complex document structures
Implement templates for consistent document generation

Platform Support: TypeScript, JavaScript, Angular, React, Vue, ASP.NET Core, ASP.NET MVC

Library Overview

The Syncfusion JavaScript PDF library (@syncfusion/ej2-pdf) is a powerful, high-performance class library that enables:

Creating PDF documents from scratch without Adobe Acrobat
Loading, editing, and saving existing PDF files
Opening password-protected PDF documents
Adding text, images, shapes, and graphical elements
Interactive components (bookmarks, annotations, form fields)
Document operations (merge, split, flatten)
Content extraction (text, images)
Security features (digital signatures, redaction)

Key Classes:

PdfDocument - Main document object
PdfPage - Individual pages
PdfGraphics - Drawing surface for content
PdfFont, PdfBitmap, PdfBrush - Content elements

Documentation and Navigation Guide

Getting Started

📄 Read: references/getting-started.md

Use this reference when the user needs to:

Install the @syncfusion/ej2-pdf package
Set up the library for TypeScript, JavaScript, Angular, React, Vue, or ASP.NET
Understand dependencies and requirements
Create their first PDF document
Learn basic save and export operations

Document Creation & Settings

📄 Read: references/document-settings.md

Use this reference for:

Creating PdfDocument instances
Configuring page settings (size, orientation, margins, rotation)
Setting document properties (title, author, subject, keywords, creation/modification dates)
Enabling incremental updates
Flattening annotations and form fields

📄 Read: references/pdf-pages.md

Use this reference for:

Adding pages to documents
Page manipulation and navigation
Page sections with different settings
Managing page collections

Content Elements

📄 Read: references/text-rendering.md

Use this reference when adding text:

Drawing text with drawString() method
Font types (Standard, TrueType, CJK fonts)
Font styles, sizes, and formatting
Text layout and wrapping
Graphics state management (save/restore)
Text positioning and bounds

📄 Read: references/images.md

Use this reference for image operations:

Adding JPEG and PNG images
Using PdfBitmap class
Image positioning and sizing
Inserting images into existing documents
Base64 and Uint8Array image formats
Clipping and graphics transformations

📄 Read: references/shapes.md

Use this reference for drawing shapes:

Rectangles, circles, ellipses, lines
Complex paths and curves
Pens and brushes for styling
Fill and stroke operations
Graphics transformations (translate, rotate, scale)

📄 Read: references/lists.md

Use this reference for creating lists:

Ordered and unordered lists
Nested list structures
Custom list markers
List formatting options

📄 Read: references/templates.md

Use this reference for reusable content:

Creating page templates
Dynamic content stamping
Template positioning and layout
Reusing content across pages

Interactive Features

📄 Read: references/annotations.md

Use this reference for annotations:

Annotation types (free text, ink, stamp, etc.)
Adding and configuring annotations
Annotation properties and appearance
Flattening annotations to static content

📄 Read: references/bookmarks.md

Use this reference for navigation:

Creating document bookmarks
Nested bookmark hierarchies
Bookmark navigation and linking
Modifying existing bookmarks

📄 Read: references/form-fields.md

Use this reference for interactive forms:

Form field types (text, checkbox, radio, dropdown, button)
Adding and configuring form fields
Field validation and properties
Filling form data programmatically
Importing/exporting form data
Flattening forms to remove interactivity

📄 Read: references/hyperlinks.md

Use this reference for linking:

Adding web hyperlinks
Document internal navigation links
Link annotations and appearance
Navigation actions

Document Operations

📄 Read: references/merge-documents.md

Use this reference for merging:

Combining multiple PDF files
Importing pages from other documents
Preserving bookmarks during merge
Merging workflows

📄 Read: references/split-documents.md

Use this reference for splitting:

Splitting PDFs by page range
Extracting specific pages
Creating separate documents from pages

📄 Read: references/watermarks.md

Use this reference for watermarks:

Text watermarks
Image watermarks
Watermark positioning and layout
Opacity and rotation settings

📄 Read: references/layers.md

Use this reference for layer management:

Creating PDF layers (Optional Content Groups)
Layer visibility control
Adding content to layers
Removing or flattening layers

Data Extraction

📄 Read: references/text-extraction.md

Use this reference for extracting text:

Extracting text from PDF pages
Text extraction layouts
Text bounds and positioning
Extracting from specific regions

📄 Read: references/image-extraction.md

Use this reference for extracting images:

Extracting images from PDF documents
Image data formats
Saving extracted images
Required package: @syncfusion/ej2-pdf-data-extract

Security & Protection

📄 Read: references/digital-signatures.md

Use this reference for security:

Adding digital signatures
Certificate-based signing
Signature appearance customization
Validation and verification
Timestamp servers

📄 Read: references/redaction.md

Use this reference for content removal:

Redacting sensitive text
Shape redaction
Redaction annotations
Permanent content removal

Quick Start Example

import { PdfDocument, PdfPage, PdfGraphics, PdfFont, PdfFontFamily, PdfFontStyle, PdfBrush } from '@syncfusion/ej2-pdf';

// Create a new PDF document
let document: PdfDocument = new PdfDocument();

// Add a page
let page: PdfPage = document.addPage();

// Get graphics from the page
let graphics: PdfGraphics = page.graphics;

// Set font
let font: PdfFont = document.embedFont(PdfFontFamily.helvetica, 20, PdfFontStyle.regular);

// Create a brush
let brush = new PdfBrush({r: 0, g: 0, b: 0});

// Draw text
graphics.drawString('Hello World!', font, {x: 20, y: 20, width: 200, height: 50}, brush);

// Save the document
document.save('output.pdf');

// Clean up
document.destroy();

Common Workflows

Create Invoice or Report

Create document with custom page settings
Add company logo (image)
Add header text with formatting
Create tables with borders (shapes + text)
Add totals and footer
Save and download

Start with: references/getting-started.md, then references/text-rendering.md and references/images.md

Fill and Flatten PDF Form

Load existing PDF document with form fields
Fill form fields programmatically
Flatten form to make it non-editable
Save modified document

Start with: references/form-fields.md

Extract Data from PDF

Load existing PDF document
Extract text from specific pages
Extract images if needed
Parse and process extracted data

Start with: references/text-extraction.md and references/image-extraction.md

Merge Multiple PDFs

Create main document
Import pages from source documents
Optionally add bookmarks for sections
Save combined document

Start with: references/merge-documents.md

Add Digital Signature

Load document or create new one
Configure digital signature with certificate
Set signature appearance and position
Save signed document

Start with: references/digital-signatures.md

Platform-Specific Considerations

TypeScript/JavaScript

Direct import from @syncfusion/ej2-pdf
Browser or Node.js environment
File saving via browser download or Node.js fs

Angular/React/Vue

Component-based integration
Handle file downloads in component lifecycle
State management for document generation

ASP.NET Core/MVC

Server-side PDF generation
Return PDF as file result
Memory stream handling

For platform-specific setup details, see references/getting-started.md

Key Props and Methods

PdfDocument

addPage(settings?) - Add new page
getPage(index) - Access existing page
save(filename) - Save document
destroy() - Clean up resources
embedFont() - Load font for use

PdfGraphics

drawString(text, font, bounds, brush) - Draw text
drawImage(image, bounds) - Draw image
drawRectangle(pen, bounds) - Draw rectangle
save() - Save graphics state
restore(state) - Restore graphics state

PdfPage

graphics - Get drawing surface
size - Get page dimensions
rotation - Get/set rotation

For complete API details, refer to the specific reference files.

Common Use Cases

Automated Report Generation - Create branded reports with charts, tables, and formatted text
Invoice Creation - Generate professional invoices with line items and totals
Certificate Generation - Create certificates with templates and custom text
Form Filling - Programmatically fill PDF forms for bulk processing
Document Assembly - Merge multiple PDFs into consolidated documents
Data Extraction - Extract text and images from PDFs for processing
Digital Signing - Apply digital signatures for document authentication
Watermarking - Add branding or security watermarks to documents
Redaction - Remove sensitive information before sharing
Archive Creation - Convert documents to PDF/A format for long-term storage

Troubleshooting Tips

Missing fonts: Ensure font is embedded before use with document.embedFont()
Image not displaying: Verify image format (JPEG/PNG) and data (base64/Uint8Array)
Large files: Use incremental updates or split operations
Memory issues: Call document.destroy() after saving
Extract features not working: Install @syncfusion/ej2-pdf-data-extract package

Related Resources

Package: @syncfusion/ej2-pdf
Add-on: @syncfusion/ej2-pdf-data-extract (for extraction features)
Dependencies: @syncfusion/ej2-compression, @syncfusion/ej2-base

syncfusion-javascript-pdf