pdfSignatureField

Typing of a signature field /FT /Sig — ISO 32000-2 §12.7.5.5.

Module pdfSignatureField | Source packages/front/office/pdf/src/form/signature.js | Deps pdfErrors, pdfParser | Worker-safe yes

A signature field carries an opaque signature dict in /V (PKCS#7 / CMS, ByteRange, MDP). The signature payload itself is typed at L3 in src/sig/ — here /V is kept as a raw typed object (ref or inline dict) so the caller decides whether to descend into it. /Lock (post-signature lock) and /SV (seed value) are also preserved. signed is true iff /V is present and well-formed.

Resolve

const sf = runtime.resolve('pdfSignatureField');
// Returns: { typeSignatureField }

API

Shape SignatureField

{
    ft: 'Sig',
    flags:  number,
    v:      object | null,   // signature dict ref|dict (opaque at this level)
    lock:   object | null,   // ref|dict
    sv:     object | null,   // ref|dict — seed value
    t:      Uint8Array | null,
    signed: boolean,
    raw:    object,
    _extras:{ [key]: PdfObject }
}

Examples

Detecting a present signature

const sf = runtime.resolve('pdfSignatureField');
const sig = sf.typeSignatureField(record.node);
if (sig.signed) {
    const sigDict = sig.v.type === 'ref' ? doc._raw.resolve(sig.v) : sig.v;
    // → hand off to the L3 src/sig/ API
}

Lock / seed value

sig.lock;   // /Lock — post-signature restrictions
sig.sv;     // /SV — constraints for the signer

Combining with AcroForm.sigFlags

const af = runtime.resolve('pdfAcroForm').typeAcroForm(...);
const signaturesExist = (af.sigFlags & 1) !== 0;
const appendOnly      = (af.sigFlags & 2) !== 0;

Errors

See also

• pdfAcroForm — /SigFlags.
• pdfFieldTree — discovery.
• pdfAppearance — visual representation.
• pdfButtonField, pdfTextField, pdfChoiceField.