modern-pdf-lib

---

modern-pdf-lib / PdfSignatureField

Class: PdfSignatureField

Defined in: src/form/fields/signatureField.ts:29

A PDF signature form field (/FT /Sig).

The /V entry is a signature dictionary containing the cryptographic signature data. This class provides read access to check whether the field is signed, but does not implement signing (see Phase 6).

Extends

• PdfField

Constructors

Constructor

new PdfSignatureField(name, dict, widgetDict, parentNames?): PdfSignatureField

Defined in: src/form/pdfField.ts:175

Parameters

name

string

dict

PdfDict

widgetDict

PdfDict

parentNames?

string[] = []

Returns

PdfSignatureField

Inherited from

PdfField.constructor

Properties

dict

protected readonly dict: PdfDict

Defined in: src/form/pdfField.ts:164

The underlying field dictionary (may contain both field and widget entries for simple one-widget fields).

Inherited from

PdfField.dict

---

fieldType

readonly fieldType: FieldType = 'signature'

Defined in: src/form/fields/signatureField.ts:30

Discriminator for the concrete field type.

Overrides

PdfField.fieldType

---

name

readonly name: string

Defined in: src/form/pdfField.ts:158

The fully-qualified field name.

Inherited from

PdfField.name

---

parentNames

protected readonly parentNames: string[]

Defined in: src/form/pdfField.ts:173

Parent field dictionary chain for building full names.

Inherited from

PdfField.parentNames

---

widgetDict

protected readonly widgetDict: PdfDict

Defined in: src/form/pdfField.ts:170

The widget annotation dictionary. For merged field+widget dicts, this is the same object as dict.

Inherited from

PdfField.widgetDict

Methods

addToPage()

addToPage(page): void

Defined in: src/form/pdfField.ts:309

Add this field's widget annotation to a page.

Ensures the widget dict has /Type /Annot and /Subtype /Widget, then adds it to the page's annotation list so it appears in the rendered PDF.

Parameters

page

WidgetAnnotationHost

A page that implements WidgetAnnotationHost.

Returns

void

Inherited from

PdfField.addToPage

---

disableExporting()

disableExporting(): void

Defined in: src/form/pdfField.ts:271

Disable exporting this field (set the NoExport flag).

Returns

void

Inherited from

PdfField.disableExporting

---

enableExporting()

enableExporting(): void

Defined in: src/form/pdfField.ts:266

Enable exporting this field (clear the NoExport flag).

Returns

void

Inherited from

PdfField.enableExporting

---

generateAppearance()

generateAppearance(): PdfStream

Defined in: src/form/fields/signatureField.ts:76

Generate the appearance stream for this signature field.

Returns

PdfStream

Overrides

PdfField.generateAppearance

---

getFieldFlags()

protected getFieldFlags(): number

Defined in: src/form/pdfField.ts:211

Get the raw /Ff (field flags) integer value.

Returns

number

Inherited from

PdfField.getFieldFlags

---

getFullName()

getFullName(): string

Defined in: src/form/pdfField.ts:201

Get the fully qualified field name (Parent.Child.Name format). Per PDF spec SS12.7.3.2, the full name is formed by concatenating ancestor /T values with periods.

Returns

string

Inherited from

PdfField.getFullName

---

getName()

getName(): string

Defined in: src/form/pdfField.ts:192

Get the partial field name (/T entry).

Returns

string

Inherited from

PdfField.getName

---

getRect()

getRect(): [number, number, number, number]

Defined in: src/form/pdfField.ts:283

Get the field's widget rectangle as [x1, y1, x2, y2]. The /Rect entry comes from the widget annotation dictionary.

Returns

[number, number, number, number]

Inherited from

PdfField.getRect

---

getSignatureValue()

getSignatureValue(): PdfDict | undefined

Defined in: src/form/fields/signatureField.ts:49

Get the signature dictionary, if signed. Returns undefined if the field has not been signed.

Returns

PdfDict | undefined

---

getValue()

getValue(): string

Defined in: src/form/fields/signatureField.ts:62

Get value: returns "signed" or "unsigned".

Returns

string

Overrides

PdfField.getValue

---

hasFlag()

protected hasFlag(flag): boolean

Defined in: src/form/pdfField.ts:221

Check if a specific flag bit is set.

Parameters

flag

number

Returns

boolean

Inherited from

PdfField.hasFlag

---

isExported()

isExported(): boolean

Defined in: src/form/pdfField.ts:261

Whether the field is exported (inverse of NoExport flag).

Returns

boolean

Inherited from

PdfField.isExported

---

isNoExport()

isNoExport(): boolean

Defined in: src/form/pdfField.ts:256

Whether the field should not be exported.

Returns

boolean

Inherited from

PdfField.isNoExport

---

isReadOnly()

isReadOnly(): boolean

Defined in: src/form/pdfField.ts:236

Whether the field is read-only.

Returns

boolean

Inherited from

PdfField.isReadOnly

---

isRequired()

isRequired(): boolean

Defined in: src/form/pdfField.ts:246

Whether the field is required.

Returns

boolean

Inherited from

PdfField.isRequired

---

isSigned()

isSigned(): boolean

Defined in: src/form/fields/signatureField.ts:40

Whether this signature field has been signed. A signed field has a /V entry that is a dictionary.

Returns

boolean

---

setFieldFlags()

protected setFieldFlags(flags): void

Defined in: src/form/pdfField.ts:216

Set the raw /Ff (field flags) integer value.

Parameters

flags

number

Returns

void

Inherited from

PdfField.setFieldFlags

---

setFlag()

protected setFlag(flag, on): void

Defined in: src/form/pdfField.ts:226

Set or clear a specific flag bit.

Parameters

flag

number

on

boolean

Returns

void

Inherited from

PdfField.setFlag

---

setReadOnly()

setReadOnly(readOnly): void

Defined in: src/form/pdfField.ts:241

Set the read-only flag.

Parameters

readOnly

boolean

Returns

void

Inherited from

PdfField.setReadOnly

---

setRequired()

setRequired(required): void

Defined in: src/form/pdfField.ts:251

Set the required flag.

Parameters

required

boolean

Returns

void

Inherited from

PdfField.setRequired

---

setValue()

setValue(_value): void

Defined in: src/form/fields/signatureField.ts:67

Signature fields cannot be set via setValue.

Parameters

_value

string | boolean | string[]

Returns

void

Overrides

PdfField.setValue