parseCertificatePemOrThrow

parseCertificatePemOrThrow

Decode a PEM-encoded X.509 certificate into a ParsedCertificate.

Expects a single -----BEGIN CERTIFICATE----- block. For bundles containing multiple certificates, use parseCertificateChainPem.

function parseCertificatePemOrThrow<TMap extends ExtensionDecoderMap>(
	pem: string,
	options?: ParseOptions<TMap>,
): ParsedCertificate<TMap>

Parameters

• pem: string — PEM string with a CERTIFICATE block.
• options?: ParseOptions<TMap> — Custom extension decoders to apply during parsing.

Examples

Throws on malformed input. For a typed failure instead, use the Result-returning {@linkcode parseCertificatePem}.

const certificate = parseCertificatePemOrThrow(pemString); // throws if malformed
console.log(certificate.issuer.values.organization); // "Let's Encrypt"