PDFFileElement: verify() method

Syntax

verify()
verify(options)

Parameters

options Optional

An object with one property:

force Optional

A boolean value: true checks again even though nothing changed. The default is false.

Return value

A Promise that resolves to an Array of rows, newest signature first: see Signature verification results for their fields. An unsigned file resolves to an empty array.

Exceptions

None.

Usage notes

• Nothing is trusted by default: without trust anchors, signatures verify as untrusted.
• Revocation is checked online only for trusted signers, through the built-in proxy; revocation data embedded in the PDF is always used. break=revocation keeps checks offline, and break=verify turns verification off (then verify() resolves to []).
• Signature checks need a secure context (HTTPS). Elsewhere every signature verifies as unknown, with the code WEBCRYPTO_UNAVAILABLE.

Examples

Verifying a signed file

<pdf-file id=s src=//new.webpdf.pro/signed.pdf trust:src=//new.webpdf.pro/demo-root.pem></pdf-file>

const rows = await document.querySelector("#s").verify();
for (const { name, status, certificate } of rows) console.log(name, status, certificate?.subjectCN);

Specifications

Not part of any specification. <pdf-file> and <pdf-page> are autonomous custom elements defined by WebPDF.pro. It implements:

Browser compatibility

See also

• verify
• PDFFileElement.signed
• PDFFileElement.trust
• Signature verification results