node-poppler 6.2.6 → 7.0.0

package/src/index.js

@@ -1,9 +1,10 @@
 "use strict";
 
+const { execFile, spawn } = require("node:child_process");
+const { promisify } = require("node:util");
 const camelCase = require("camelcase");
-const path = require("upath");
-const { execFile, spawn } = require("child_process");
-const { promisify } = require("util");
+const { lt } = require("semver");
+const { joinSafe, normalizeTrim } = require("upath");
 
 const execFileAsync = promisify(execFile);
 
@@ -15,6 +16,7 @@ const errorMessages = {
 	4: "Error related to ICC profile",
 	99: "Other error",
 	3221226505: "Internal process error",
+	unk: "Unknown error",
 };
 
 /**
@@ -22,24 +24,28 @@ const errorMessages = {
  * @description Checks each option provided is valid, of the correct type, and can be used by specified
  * version of binary.
  * @ignore
- * @param {object} acceptedOptions - Object containing options that a binary accepts.
+ * @param {object} acceptedOptions - Object containing accepted options.
  * @param {object} options - Object containing options to pass to binary.
- * @param {string=} version - Version of binary.
- * @returns {Array<string>} Array of CLI arguments.
+ * @param {string} [version] - Version of binary.
+ * @returns {string[]} Array of CLI arguments.
  * @throws If invalid arguments provided.
  */
 function parseOptions(acceptedOptions, options, version) {
+	/** @type {string[]} */
 	const args = [];
+	/** @type {string[]} */
 	const invalidArgs = [];
 	Object.keys(options).forEach((key) => {
-		if (Object.prototype.hasOwnProperty.call(acceptedOptions, key)) {
+		if (Object.hasOwn(acceptedOptions, key)) {
 			// eslint-disable-next-line valid-typeof
 			if (typeof options[key] === acceptedOptions[key].type) {
 				// Skip boolean options if false
+
 				if (acceptedOptions[key].type === "boolean" && !options[key]) {
 					return;
 				}
 				// Arg will be empty for some non-standard options
+
 				if (acceptedOptions[key].arg !== "") {
 					args.push(acceptedOptions[key].arg);
 				}
@@ -58,7 +64,8 @@ function parseOptions(acceptedOptions, options, version) {
 			if (
 				acceptedOptions[key].minVersion &&
 				version &&
-				version < acceptedOptions[key].minVersion
+				// @ts-ignore: type checking is done above
+				lt(version, acceptedOptions[key].minVersion, { loose: true })
 			) {
 				invalidArgs.push(
 					`Invalid option provided for the current version of the binary used. '${key}' was introduced in v${acceptedOptions[key].minVersion}, but received v${version}`
@@ -75,14 +82,12 @@ function parseOptions(acceptedOptions, options, version) {
 }
 
 class Poppler {
-	/**
-	 * @param {string=} binPath - Path of poppler-utils binaries.
-	 */
+	/** @param {string} [binPath] - Path of poppler-utils binaries. */
 	constructor(binPath) {
 		if (binPath) {
-			this.popplerPath = path.normalizeTrim(binPath);
+			this.popplerPath = normalizeTrim(binPath);
 		} else if (process.platform === "win32") {
-			this.popplerPath = path.joinSafe(
+			this.popplerPath = joinSafe(
 				__dirname,
 				"lib",
 				"win32",
@@ -103,9 +108,9 @@ class Poppler {
 	 * @param {string} file - Filepath of the PDF file to read.
 	 * @param {string} fileToAttach - Filepath of the attachment to be embedded into the PDF file.
 	 * @param {string} outputFile - Filepath of the file to output the results to.
-	 * @param {object=} options - Object containing options to pass to binary.
-	 * @param {boolean=} options.printVersionInfo - Print copyright and version info.
-	 * @param {boolean=} options.replace - Replace embedded file with same name (if it exists).
+	 * @param {object} [options] - Object containing options to pass to binary.
+	 * @param {boolean} [options.printVersionInfo] - Print copyright and version info.
+	 * @param {boolean} [options.replace] - Replace embedded file with same name (if it exists).
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfAttach(file, fileToAttach, outputFile, options = {}) {
@@ -121,7 +126,7 @@ class Poppler {
 			args.push(outputFile);
 
 			const { stdout } = await execFileAsync(
-				path.joinSafe(this.popplerPath, "pdfattach"),
+				joinSafe(this.popplerPath, "pdfattach"),
 				args
 			);
 			return Promise.resolve(stdout);
@@ -134,26 +139,26 @@ class Poppler {
 	 * @author Frazer Smith
 	 * @description Lists or extracts embedded files (attachments) from a PDF file.
 	 * @param {string} file - Filepath of the PDF file to read.
-	 * @param {object=} options - Object containing options to pass to binary.
-	 * @param {boolean=} options.listEmbedded - List all of the embedded files in the PDF file.
+	 * @param {object} [options] - Object containing options to pass to binary.
+	 * @param {boolean} [options.listEmbedded] - List all of the embedded files in the PDF file.
 	 * File names are converted to the text encoding specified by `options.outputEncoding`.
-	 * @param {string=} options.ownerPassword - Owner password (for encrypted files).
-	 * @param {string=} options.outputEncoding - Sets the encoding to use for text output.
+	 * @param {string} [options.ownerPassword] - Owner password (for encrypted files).
+	 * @param {string} [options.outputEncoding] - Sets the encoding to use for text output.
 	 * This defaults to `UTF-8`.
-	 * @param {string=} options.outputPath - Set the file name used when saving an embedded file with
+	 * @param {string} [options.outputPath] - Set the file name used when saving an embedded file with
 	 * the save option enabled, or the directory if `options.saveall` is used.
-	 * @param {boolean=} options.printVersionInfo - Print copyright and version info.
-	 * @param {boolean=} options.saveAllFiles - Save all of the embedded files. This uses the file
+	 * @param {boolean} [options.printVersionInfo] - Print copyright and version info.
+	 * @param {boolean} [options.saveAllFiles] - Save all of the embedded files. This uses the file
 	 * names associated with the embedded files (as printed by `options.listEmbedded`).
 	 * By default, the files are saved in the current directory; this can be changed
 	 * with `options.outputPath`.
-	 * @param {string=} options.saveFile - Save the specified embedded file.
+	 * @param {string} [options.saveFile] - Save the specified embedded file.
 	 * By default, this uses the file name associated with the embedded file (as printed by
 	 * `options.listEmbedded`); the file name can be changed with `options.outputPath`.
-	 * @param {number=} options.saveSpecificFile - Save the specified embedded file.
+	 * @param {number} [options.saveSpecificFile] - Save the specified embedded file.
 	 * By default, this uses the file name associated with the embedded file (as printed by
 	 * `options.listEmbedded`); the file name can be changed with `options.outputPath`.
-	 * @param {string=} options.userPassword - User password (for encrypted files).
+	 * @param {string} [options.userPassword] - User password (for encrypted files).
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfDetach(file, options = {}) {
@@ -178,7 +183,7 @@ class Poppler {
 			args.push(file);
 
 			const { stdout } = await execFileAsync(
-				path.joinSafe(this.popplerPath, "pdfdetach"),
+				joinSafe(this.popplerPath, "pdfdetach"),
 				args
 			);
 			return Promise.resolve(stdout);
@@ -190,15 +195,15 @@ class Poppler {
 	/**
 	 * @author Frazer Smith
 	 * @description Lists the fonts used in a PDF file along with various information for each font.
-	 * @param {Buffer| string} file - PDF file as Buffer, or filepath of the PDF file to read.
-	 * @param {object=} options - Object containing options to pass to binary.
-	 * @param {number=} options.firstPageToExamine - Specifies the first page to examine.
-	 * @param {number=} options.lastPageToExamine - Specifies the last page to examine.
-	 * @param {boolean=} options.listSubstitutes - List the substitute fonts that poppler
+	 * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+	 * @param {object} [options] - Object containing options to pass to binary.
+	 * @param {number} [options.firstPageToExamine] - Specifies the first page to examine.
+	 * @param {number} [options.lastPageToExamine] - Specifies the last page to examine.
+	 * @param {boolean} [options.listSubstitutes] - List the substitute fonts that poppler
 	 * will use for non-embedded fonts.
-	 * @param {string=} options.ownerPassword - Owner password (for encrypted files).
-	 * @param {boolean=} options.printVersionInfo - Print copyright and version info.
-	 * @param {string=} options.userPassword - User password (for encrypted files).	 *
+	 * @param {string} [options.ownerPassword] - Owner password (for encrypted files).
+	 * @param {boolean} [options.printVersionInfo] - Print copyright and version info.
+	 * @param {string} [options.userPassword] - User password (for encrypted files).	 *
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfFonts(file, options = {}) {
@@ -213,10 +218,11 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				path.joinSafe(this.popplerPath, "pdffonts"),
+				joinSafe(this.popplerPath, "pdffonts"),
 				["-v"]
 			);
 
+			// @ts-ignore: parseOptions checks if falsy
 			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
@@ -229,7 +235,7 @@ class Poppler {
 				}
 
 				const child = spawn(
-					path.joinSafe(this.popplerPath, "pdffonts"),
+					joinSafe(this.popplerPath, "pdffonts"),
 					args
 				);
 
@@ -265,25 +271,25 @@ class Poppler {
 	/**
 	 * @author Frazer Smith
 	 * @description Saves images from a PDF file as PPM, PBM, PNG, TIFF, JPEG, JPEG2000, or JBIG2 files.
-	 * @param {Buffer| string} file - PDF file as Buffer, or filepath of the PDF file to read.
-	 * @param {string=} outputPrefix - Filename prefix of output files.
-	 * @param {object=} options - Object containing options to pass to binary.
-	 * @param {boolean=} options.allFiles - Write JPEG, JPEG2000, JBIG2, and CCITT images in their native format.
+	 * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+	 * @param {string} [outputPrefix] - Filename prefix of output files.
+	 * @param {object} [options] - Object containing options to pass to binary.
+	 * @param {boolean} [options.allFiles] - Write JPEG, JPEG2000, JBIG2, and CCITT images in their native format.
 	 * CMYK files are written as TIFF files. All other images are written as PNG files.
-	 * @param {boolean=} options.ccittFile - Generate CCITT images as CCITT files.
-	 * @param {number=} options.firstPageToConvert - Specifies the first page to convert.
-	 * @param {number=} options.lastPageToConvert - Specifies the last page to convert.
-	 * @param {boolean=} options.list - Instead of writing the images, list the
+	 * @param {boolean} [options.ccittFile] - Generate CCITT images as CCITT files.
+	 * @param {number} [options.firstPageToConvert] - Specifies the first page to convert.
+	 * @param {number} [options.lastPageToConvert] - Specifies the last page to convert.
+	 * @param {boolean} [options.list] - Instead of writing the images, list the
 	 * images along with various information for each image.
 	 * NOTE: Do not specify the outputPrefix with this option.
-	 * @param {boolean=} options.jbig2File - Generate JBIG2 images as JBIG2 files.
-	 * @param {boolean=} options.jpeg2000File - Generate JPEG2000 images at JP2 files.
-	 * @param {boolean=} options.jpegFile - Generate JPEG images as JPEG files.
-	 * @param {string=} options.ownerPassword - Owner password (for encrypted files).
-	 * @param {boolean=} options.pngFile - Change the default output format to PNG.
-	 * @param {boolean=} options.printVersionInfo - Print copyright and version info.
-	 * @param {boolean=} options.tiffFile - Change the default output format to TIFF.
-	 * @param {string=} options.userPassword - Specify the user password for the PDF file.
+	 * @param {boolean} [options.jbig2File] - Generate JBIG2 images as JBIG2 files.
+	 * @param {boolean} [options.jpeg2000File] - Generate JPEG2000 images at JP2 files.
+	 * @param {boolean} [options.jpegFile] - Generate JPEG images as JPEG files.
+	 * @param {string} [options.ownerPassword] - Owner password (for encrypted files).
+	 * @param {boolean} [options.pngFile] - Change the default output format to PNG.
+	 * @param {boolean} [options.printVersionInfo] - Print copyright and version info.
+	 * @param {boolean} [options.tiffFile] - Change the default output format to TIFF.
+	 * @param {string} [options.userPassword] - Specify the user password for the PDF file.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfImages(file, outputPrefix, options = {}) {
@@ -305,10 +311,11 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				path.joinSafe(this.popplerPath, "pdfimages"),
+				joinSafe(this.popplerPath, "pdfimages"),
 				["-v"]
 			);
 
+			// @ts-ignore: parseOptions checks if falsy
 			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
@@ -325,7 +332,7 @@ class Poppler {
 				}
 
 				const child = spawn(
-					path.joinSafe(this.popplerPath, "pdfimages"),
+					joinSafe(this.popplerPath, "pdfimages"),
 					args
 				);
 
@@ -346,6 +353,7 @@ class Poppler {
 				});
 
 				child.on("close", (code) => {
+					/* istanbul ignore else */
 					if (stdOut !== "") {
 						resolve(stdOut.trim());
 					} else if (code === 0) {
@@ -353,8 +361,11 @@ class Poppler {
 					} else if (stdErr !== "") {
 						reject(new Error(stdErr.trim()));
 					} else {
-						/* istanbul ignore next */
-						reject(new Error(errorMessages[code]));
+						reject(
+							new Error(
+								code ? errorMessages[code] : errorMessages.unk
+							)
+						);
 					}
 				});
 			});
@@ -366,36 +377,37 @@ class Poppler {
 	/**
 	 * @author Frazer Smith
 	 * @description Prints the contents of the `Info` dictionary from a PDF file.
-	 * @param {Buffer| string} file - PDF file as Buffer, or filepath of the PDF file to read.
-	 * @param {object=} options - Object containing options to pass to binary.
-	 * @param {number=} options.firstPageToConvert - First page to print.
-	 * @param {number=} options.lastPageToConvert - Last page to print.
-	 * @param {boolean=} options.listEncodingOptions - List the available encodings.
-	 * @param {string=} options.outputEncoding - Sets the encoding to use for text output.
+	 * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+	 * @param {object} [options] - Object containing options to pass to binary.
+	 * @param {number} [options.firstPageToConvert] - First page to print.
+	 * @param {number} [options.lastPageToConvert] - Last page to print.
+	 * @param {boolean} [options.listEncodingOptions] - List the available encodings.
+	 * @param {string} [options.outputEncoding] - Sets the encoding to use for text output.
 	 * This defaults to `UTF-8`.
-	 * @param {string=} options.ownerPassword - Owner password (for encrypted files).
-	 * @param {boolean=} options.printAsJson - Print result as a JSON object.
-	 * @param {boolean=} options.printBoundingBoxes - Prints the page box bounding boxes:
+	 * @param {string} [options.ownerPassword] - Owner password (for encrypted files).
+	 * @param {boolean} [options.printAsJson] - Print result as a JSON object.
+	 * @param {boolean} [options.printBoundingBoxes] - Prints the page box bounding boxes:
 	 * MediaBox, CropBox, BleedBox, TrimBox, and ArtBox.
-	 * @param {boolean=} options.printDocStruct - Prints the logical document structure
+	 * @param {boolean} [options.printDocStruct] - Prints the logical document structure
 	 * of a Tagged-PDF file.
-	 * @param {boolean=} options.printDocStructText - Print the textual content along with the
+	 * @param {boolean} [options.printDocStructText] - Print the textual content along with the
 	 * document structure of a Tagged-PDF file. Note that extracting text this way might be slow
 	 *
 	 * for big PDF files.
-	 * @param {boolean=} options.printIsoDates - Prints dates in ISO-8601 format (including the time zone).
-	 * @param {boolean=} options.printJS - Prints all JavaScript in the PDF file.
-	 * @param {boolean=} options.printMetadata - Prints document-level metadata. (This is the `Metadata`
+	 * @param {boolean} [options.printIsoDates] - Prints dates in ISO-8601 format (including the time zone).
+	 * @param {boolean} [options.printJS] - Prints all JavaScript in the PDF file.
+	 * @param {boolean} [options.printMetadata] - Prints document-level metadata. (This is the `Metadata`
 	 * stream from the PDF file's Catalog object).
-	 * @param {boolean=} options.printNamedDests - Print a list of all named destinations. If a page range
+	 * @param {boolean} [options.printNamedDests] - Print a list of all named destinations. If a page range
 	 * is specified using the `options.firstPageToConvert` and `options.lastPageToConvert` options, only destinations
 	 * in the page range are listed.
-	 * @param {boolean=} options.printRawDates - Prints the raw (undecoded) date strings, directly from the PDF file.
-	 * @param {boolean=} options.printUrls - Print all URLs in the PDF; only URLs referenced by PDF objects
+	 * @param {boolean} [options.printRawDates] - Prints the raw (undecoded) date strings, directly from the PDF file.
+	 * @param {boolean} [options.printUrls] - Print all URLs in the PDF; only URLs referenced by PDF objects
 	 * such as Link Annotations are listed, not URL strings in the text content.
-	 * @param {boolean=} options.printVersionInfo - Print copyright and version info.
-	 * @param {string=} options.userPassword - User password (for encrypted files).
-	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
+	 * @param {boolean} [options.printVersionInfo] - Print copyright and version info.
+	 * @param {string} [options.userPassword] - User password (for encrypted files).
+	 * @returns {Promise<object|string>} A promise that resolves with a stdout string or JSON object if
+	 * `options.printAsJson` is `true`, or rejects with an `Error` object.
 	 */
 	async pdfInfo(file, options = {}) {
 		const acceptedOptions = {
@@ -420,10 +432,11 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				path.joinSafe(this.popplerPath, "pdfinfo"),
+				joinSafe(this.popplerPath, "pdfinfo"),
 				["-v"]
 			);
 
+			// @ts-ignore: parseOptions checks if falsy
 			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
@@ -432,6 +445,7 @@ class Poppler {
 			 * Poppler does not set the "File size" metadata value if passed
 			 * a Buffer via stdin, so need to retrieve it from the Buffer
 			 */
+			/** @type {number} */
 			let fileSize;
 
 			return new Promise((resolve, reject) => {
@@ -442,8 +456,8 @@ class Poppler {
 					args.push(file);
 				}
 
-				const child = execFile(
-					path.joinSafe(this.popplerPath, "pdfinfo"),
+				const child = spawn(
+					joinSafe(this.popplerPath, "pdfinfo"),
 					args
 				);
 
@@ -472,15 +486,16 @@ class Poppler {
 							);
 						}
 
+						/**
+						 * Convert output to JSON.
+						 * @see {@link https://github.com/Fdawgs/node-poppler/issues/248#issuecomment-845948080 | Node-Poppler Issue #248}
+						 */
 						if (options.printAsJson === true) {
-							/**
-							 * Thanks to @sainf for this solution
-							 * https://github.com/Fdawgs/node-poppler/issues/248#issuecomment-845948080
-							 */
 							const info = {};
 							stdOut.split("\n").forEach((line) => {
 								const lines = line.split(": ");
 								if (lines.length > 1) {
+									// @ts-ignore: creating dynamic object keys
 									info[camelCase(lines[0])] = lines[1].trim();
 								}
 							});
@@ -507,12 +522,12 @@ class Poppler {
 	 * @param {string} outputPattern - Should contain %d (or any variant respecting printf format),
 	 * since %d is replaced by the page number.
 	 * As an example, `sample-%d.pdf` will produce `sample-1.pdf` for a single page document.
-	 * @param {object=} options - Object containing options to pass to binary.
-	 * @param {number=} options.firstPageToExtract - Specifies the first page to extract.
+	 * @param {object} [options] - Object containing options to pass to binary.
+	 * @param {number} [options.firstPageToExtract] - Specifies the first page to extract.
 	 * This defaults to page 1.
-	 * @param {number=} options.lastPageToExtract - Specifies the last page to extract.
+	 * @param {number} [options.lastPageToExtract] - Specifies the last page to extract.
 	 * This defaults to the last page of the PDF file.
-	 * @param {boolean=} options.printVersionInfo - Print copyright and version info.
+	 * @param {boolean} [options.printVersionInfo] - Print copyright and version info.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfSeparate(file, outputPattern, options = {}) {
@@ -524,10 +539,11 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				path.joinSafe(this.popplerPath, "pdfseparate"),
+				joinSafe(this.popplerPath, "pdfseparate"),
 				["-v"]
 			);
 
+			// @ts-ignore: parseOptions checks if falsy
 			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
@@ -535,7 +551,7 @@ class Poppler {
 			args.push(outputPattern);
 
 			const { stdout } = await execFileAsync(
-				path.joinSafe(this.popplerPath, "pdfseparate"),
+				joinSafe(this.popplerPath, "pdfseparate"),
 				args
 			);
 			return Promise.resolve(stdout);
@@ -547,45 +563,45 @@ class Poppler {
 	/**
 	 * @author Frazer Smith
 	 * @description Converts a PDF file to EPS/JPEG/PDF/PNG/PS/SVG/TIFF.
-	 * @param {Buffer| string} file - PDF file as Buffer, or filepath of the PDF file to read.
-	 * @param {string=} outputFile - Filepath of the file to output the results to.
+	 * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+	 * @param {string} [outputFile] - Filepath of the file to output the results to.
 	 *
 	 * If `undefined` then will write output to stdout. Using stdout is not valid with image formats
 	 * (jpeg, png, and tiff) unless `options.singleFile` is set to `true`.
 	 * Encoding is set to `binary` if used with `options.singleFile` or `options.pdfFile`.
 	 *
 	 * If not set then the output filename will be derived from the PDF file name.
-	 * @param {object=} options - Object containing options to pass to binary.
-	 * @param {('default'|'none'|'gray'|'subpixel'|'fast'|'good'|'best')=} options.antialias - Set the cairo
+	 * @param {object} [options] - Object containing options to pass to binary.
+	 * @param {('best'|'default'|'fast'|'good'|'gray'|'none'|'subpixel')} [options.antialias] - Set the cairo
 	 * antialias option used for text and drawing in image files (or rasterized regions in vector output).
-	 * @param {boolean=} options.cropBox - Uses the crop box rather than media box when
+	 * @param {boolean} [options.cropBox] - Uses the crop box rather than media box when
 	 * generating the files (PNG/JPEG/TIFF only).
-	 * @param {number=} options.cropHeight - Specifies the height of crop area in pixels
+	 * @param {number} [options.cropHeight] - Specifies the height of crop area in pixels
 	 * (image output) or points (vector output).
-	 * @param {number=} options.cropSize - Specifies the size of crop square in pixels
+	 * @param {number} [options.cropSize] - Specifies the size of crop square in pixels
 	 * (image output) or points (vector output).
-	 * @param {number=} options.cropWidth - Specifies the width of crop area in pixels
+	 * @param {number} [options.cropWidth] - Specifies the width of crop area in pixels
 	 * (image output) or points (vector output).
-	 * @param {number=} options.cropXAxis - Specifies the x-coordinate of the crop area top left
+	 * @param {number} [options.cropXAxis] - Specifies the x-coordinate of the crop area top left
 	 * corner in pixels (image output) or points (vector output).
-	 * @param {number=} options.cropYAxis - Specifies the y-coordinate of the crop area top left
+	 * @param {number} [options.cropYAxis] - Specifies the y-coordinate of the crop area top left
 	 * corner in pixels (image output) or points (vector output).
-	 * @param {boolean=} options.duplex - Adds the %%IncludeFeature: *Duplex DuplexNoTumble DSC
+	 * @param {boolean} [options.duplex] - Adds the %%IncludeFeature: *Duplex DuplexNoTumble DSC
 	 * comment to the PostScript file (PS only). This tells the print manager to enable duplexing.
-	 * @param {boolean=} options.epsFile - Generate an EPS file. An EPS file contains a single image,
+	 * @param {boolean} [options.epsFile] - Generate an EPS file. An EPS file contains a single image,
 	 * so if you use this option with a multi-page PDF file, you must use `options.firstPageToConvert` and
 	 * `options.lastPageToConvert` to specify a single page.
 	 * The page size options (originalPageSizes, paperSize, paperWidth, paperHeight) can not be used
 	 * with this option.
-	 * @param {boolean=} options.evenPagesOnly - Generates only the even numbered pages.
-	 * @param {boolean=} options.fillPage - Expand PDF pages smaller than the paper to fill the
+	 * @param {boolean} [options.evenPagesOnly] - Generates only the even numbered pages.
+	 * @param {boolean} [options.fillPage] - Expand PDF pages smaller than the paper to fill the
 	 * paper (PS,PDF,SVG only). By default, these pages are not scaled.
-	 * @param {number=} options.firstPageToConvert - Specifies the first page to convert.
-	 * @param {boolean=} options.grayscaleFile - Generate grayscale file (PNG, JPEG, and TIFF only).
-	 * @param {string=} options.iccFile - Use the specified ICC file as the output profile
+	 * @param {number} [options.firstPageToConvert] - Specifies the first page to convert.
+	 * @param {boolean} [options.grayscaleFile] - Generate grayscale file (PNG, JPEG, and TIFF only).
+	 * @param {string} [options.iccFile] - Use the specified ICC file as the output profile
 	 * (PNG only). The profile will be embedded in the PNG file.
-	 * @param {boolean=} options.jpegFile - Generate JPEG file(s).
-	 * @param {string=} options.jpegOptions - When used with `options.jpegFile`, this option can
+	 * @param {boolean} [options.jpegFile] - Generate JPEG file(s).
+	 * @param {string} [options.jpegOptions] - When used with `options.jpegFile`, this option can
 	 * be used to control the JPEG compression parameters. It takes a string of the form
 	 * `"<opt>=<val>[,<opt>=<val>]"`. Currently available options are:
 	 * - `quality` Selects the JPEG quality value. The value must be an integer between 0 and 100.
@@ -596,57 +612,57 @@ class Poppler {
 	 * with "y" performing optimization, otherwise the default Huffman tables are used.
 	 *
 	 * Example: `"quality=95,optimize=y"`.
-	 * @param {number=} options.lastPageToConvert - Specifies the last page to convert.
-	 * @param {boolean=} options.monochromeFile - Generate monochrome file (PNG and TIFF only).
-	 * @param {boolean=} options.noCenter - By default, PDF pages smaller than the paper
+	 * @param {number} [options.lastPageToConvert] - Specifies the last page to convert.
+	 * @param {boolean} [options.monochromeFile] - Generate monochrome file (PNG and TIFF only).
+	 * @param {boolean} [options.noCenter] - By default, PDF pages smaller than the paper
 	 * (after any scaling) are centered on the paper. This option causes them to be aligned to
 	 * the lower-left corner of the paper instead (PS,PDF,SVG only).
-	 * @param {boolean=} options.noCrop - By default, printing output is cropped to the CropBox
+	 * @param {boolean} [options.noCrop] - By default, printing output is cropped to the CropBox
 	 * specified in the PDF file. This option disables cropping (PS, PDF, SVG only).
-	 * @param {boolean=} options.noShrink - Do not scale PDF pages which are larger than the paper
+	 * @param {boolean} [options.noShrink] - Do not scale PDF pages which are larger than the paper
 	 * (PS,PDF,SVG only). By default, pages larger than the paper are shrunk to fit.
-	 * @param {boolean=} options.oddPagesOnly - Generates only the odd numbered pages.
-	 * @param {boolean=} options.originalPageSizes - Set the paper size of each page to match
+	 * @param {boolean} [options.oddPagesOnly] - Generates only the odd numbered pages.
+	 * @param {boolean} [options.originalPageSizes] - Set the paper size of each page to match
 	 * the size specified in the PDF file.
-	 * @param {string=} options.ownerPassword - Specify the owner password for the PDF file.
+	 * @param {string} [options.ownerPassword] - Specify the owner password for the PDF file.
 	 * Providing this will bypass all security restrictions.
-	 * @param {number=} options.paperHeight - Set the paper height, in points (PS, PDF, SVG only).
-	 * @param {('letter'|'legal'|'A4'|'A3'|'match')=} options.paperSize - Set the paper size to one of `letter`, `legal`, `A4`,
-	 * or `A3` (PS,PDF,SVG only). This can also be set to `match`, which will set the paper size
+	 * @param {number} [options.paperHeight] - Set the paper height, in points (PS, PDF, SVG only).
+	 * @param {('A3'|'A4'|'legal'|'letter'|'match')} [options.paperSize] - Set the paper size to one of `A3`, `A4`,
+	 * `legal`, or `letter` (PS,PDF,SVG only). This can also be set to `match`, which will set the paper size
 	 * of each page to match the size specified in the PDF file. If none of the paperSize,
 	 * paperWidth, or paperHeight options are specified the default is to match the paper size.
-	 * @param {number=} options.paperWidth - Set the paper width, in points (PS,PDF,SVG only).
-	 * @param {boolean=} options.pdfFile - Generate PDF file.
-	 * @param {boolean=} options.pngFile - Generate PNG file(s).
-	 * @param {boolean=} options.printVersionInfo - Print copyright and version information.
-	 * @param {boolean=} options.psFile - Generate PS file.
-	 * @param {boolean=} options.psLevel2 - Generate Level 2 PostScript (PS only).
-	 * @param {boolean=} options.psLevel3 - Generate Level 3 PostScript (PS only). This enables all
+	 * @param {number} [options.paperWidth] - Set the paper width, in points (PS,PDF,SVG only).
+	 * @param {boolean} [options.pdfFile] - Generate PDF file.
+	 * @param {boolean} [options.pngFile] - Generate PNG file(s).
+	 * @param {boolean} [options.printVersionInfo] - Print copyright and version information.
+	 * @param {boolean} [options.psFile] - Generate PS file.
+	 * @param {boolean} [options.psLevel2] - Generate Level 2 PostScript (PS only).
+	 * @param {boolean} [options.psLevel3] - Generate Level 3 PostScript (PS only). This enables all
 	 * Level 2 features plus shading patterns and masked images. This is the default setting.
-	 * @param {boolean=} options.quiet - Do not print any messages or errors.
-	 * @param {number=} options.resolutionXAxis - Specifies the X resolution, in pixels per inch of
+	 * @param {boolean} [options.quiet] - Do not print any messages or errors.
+	 * @param {number} [options.resolutionXAxis] - Specifies the X resolution, in pixels per inch of
 	 * image files (or rasterized regions in vector output). The default is 150 PPI.
-	 * @param {number=} options.resolutionXYAxis - Specifies the X and Y resolution, in pixels per
+	 * @param {number} [options.resolutionXYAxis] - Specifies the X and Y resolution, in pixels per
 	 * inch of image files (or rasterized regions in vector output). The default is 150 PPI.
-	 * @param {number=} options.resolutionYAxis - Specifies the Y resolution, in pixels per inch of
+	 * @param {number} [options.resolutionYAxis] - Specifies the Y resolution, in pixels per inch of
 	 * image files (or rasterized regions in vector output). The default is 150 PPI.
-	 * @param {number=} options.scalePageTo - Scales the long side of each page (width for landscape
+	 * @param {number} [options.scalePageTo] - Scales the long side of each page (width for landscape
 	 * pages, height for portrait pages) to fit in scale-to pixels. The size of the short side will
 	 * be determined by the aspect ratio of the page (PNG/JPEG/TIFF only).
-	 * @param {number=} options.scalePageToXAxis - Scales each page horizontally to fit in scale-to-x
+	 * @param {number} [options.scalePageToXAxis] - Scales each page horizontally to fit in scale-to-x
 	 * pixels. If scale-to-y is set to -1, the vertical size will determined by the aspect ratio of
 	 * the page (PNG/JPEG/TIFF only).
-	 * @param {number=} options.scalePageToYAxis - Scales each page vertically to fit in scale-to-y
+	 * @param {number} [options.scalePageToYAxis] - Scales each page vertically to fit in scale-to-y
 	 * pixels. If scale-to-x is set to -1, the horizontal size will determined by the aspect ratio of
 	 * the page (PNG/JPEG/TIFF only).
-	 * @param {boolean=} options.singleFile - Writes only the first page and does not add digits.
+	 * @param {boolean} [options.singleFile] - Writes only the first page and does not add digits.
 	 * Can only be used with `options.jpegFile`, `options.pngFile`, and `options.tiffFile`.
-	 * @param {boolean=} options.svgFile - Generate SVG (Scalable Vector Graphics) file.
-	 * @param {('none'|'packbits'|'jpeg'|'lzw'|'deflate')=} options.tiffCompression - Set TIFF compression.
-	 * @param {boolean=} options.tiffFile - Generate TIFF file(s).
-	 * @param {boolean=} options.transparentPageColor - Use a transparent page color
+	 * @param {boolean} [options.svgFile] - Generate SVG (Scalable Vector Graphics) file.
+	 * @param {('deflate'|'jpeg'|'lzw'|'none'|'packbits')} [options.tiffCompression] - Set TIFF compression.
+	 * @param {boolean} [options.tiffFile] - Generate TIFF file(s).
+	 * @param {boolean} [options.transparentPageColor] - Use a transparent page color
 	 * instead of white (PNG and TIFF only).
-	 * @param {string=} options.userPassword - Specify the user password for the PDF file.
+	 * @param {string} [options.userPassword] - Specify the user password for the PDF file.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfToCairo(file, outputFile, options = {}) {
@@ -701,10 +717,11 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				path.joinSafe(this.popplerPath, "pdftocairo"),
+				joinSafe(this.popplerPath, "pdftocairo"),
 				["-v"]
 			);
 
+			// @ts-ignore: parseOptions checks if falsy
 			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
@@ -723,7 +740,7 @@ class Poppler {
 				}
 
 				const child = spawn(
-					path.joinSafe(this.popplerPath, "pdftocairo"),
+					joinSafe(this.popplerPath, "pdftocairo"),
 					args
 				);
 
@@ -751,6 +768,7 @@ class Poppler {
 				});
 
 				child.on("close", (code) => {
+					/* istanbul ignore else */
 					if (stdOut !== "") {
 						resolve(stdOut.trim());
 					} else if (code === 0) {
@@ -758,8 +776,11 @@ class Poppler {
 					} else if (stdErr !== "") {
 						reject(new Error(stdErr.trim()));
 					} else {
-						/* istanbul ignore next */
-						reject(new Error(errorMessages[code]));
+						reject(
+							new Error(
+								code ? errorMessages[code] : errorMessages.unk
+							)
+						);
 					}
 				});
 			});
@@ -771,41 +792,41 @@ class Poppler {
 	/**
 	 * @author Frazer Smith
 	 * @description Converts a PDF file to HTML.
-	 * @param {Buffer| string} file - PDF file as Buffer, or filepath of the PDF file to read.
-	 * @param {string=} outputFile - Filepath of the file to output the results to.
+	 * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+	 * @param {string} [outputFile] - Filepath of the file to output the results to.
 	 * If `undefined` then Poppler will use the directory and name of the original file
 	 * and create a new file, with `-html` appended to the end of the filename.
 	 *
 	 * Required if `file` is a Buffer.
-	 * @param {object=} options - Object containing options to pass to binary.
-	 * @param {boolean=} options.complexOutput - Generate complex output.
-	 * @param {boolean=} options.dataUrls -  Use data URLs instead of external images in HTML.
-	 * @param {boolean=} options.exchangePdfLinks - Exchange .pdf links with .html.
-	 * @param {boolean=} options.extractHidden - Force hidden text extraction.
-	 * @param {number=} options.firstPageToConvert - First page to print.
-	 * @param {boolean=} options.fontFullName - Outputs the font name without any substitutions.
-	 * @param {boolean=} options.ignoreImages - Ignore images.
-	 * @param {('PNG'|'JPG')=} options.imageFormat - Image file format for Splash output (PNG or JPG).
+	 * @param {object} [options] - Object containing options to pass to binary.
+	 * @param {boolean} [options.complexOutput] - Generate complex output.
+	 * @param {boolean} [options.dataUrls] -  Use data URLs instead of external images in HTML.
+	 * @param {boolean} [options.exchangePdfLinks] - Exchange .pdf links with .html.
+	 * @param {boolean} [options.extractHidden] - Force hidden text extraction.
+	 * @param {number} [options.firstPageToConvert] - First page to print.
+	 * @param {boolean} [options.fontFullName] - Outputs the font name without any substitutions.
+	 * @param {boolean} [options.ignoreImages] - Ignore images.
+	 * @param {('JPG'|'PNG')} [options.imageFormat] - Image file format for Splash output (JPG or PNG).
 	 * If complexOutput is selected, but imageFormat is not specified, PNG will be assumed.
-	 * @param {number=} options.lastPageToConvert - Last page to print.
-	 * @param {boolean=} options.noDrm - Override document DRM settings.
-	 * @param {boolean=} options.noFrames - Generate no frames. Not supported in complex output mode.
-	 * @param {boolean=} options.noMergeParagraph - Do not merge paragraphs.
-	 * @param {boolean=} options.noRoundedCoordinates - Do not round coordinates
+	 * @param {number} [options.lastPageToConvert] - Last page to print.
+	 * @param {boolean} [options.noDrm] - Override document DRM settings.
+	 * @param {boolean} [options.noFrames] - Generate no frames. Not supported in complex output mode.
+	 * @param {boolean} [options.noMergeParagraph] - Do not merge paragraphs.
+	 * @param {boolean} [options.noRoundedCoordinates] - Do not round coordinates
 	 * (with XML output only).
-	 * @param {string=} options.outputEncoding - Sets the encoding to use for text output.
+	 * @param {string} [options.outputEncoding] - Sets the encoding to use for text output.
 	 * This defaults to `UTF-8`.
-	 * @param {string=} options.ownerPassword - Owner password (for encrypted files).
-	 * @param {boolean=} options.printVersionInfo - Print copyright and version info.
-	 * @param {boolean=} options.quiet - Do not print any messages or errors.
-	 * @param {boolean=} options.singlePage - generate single HTML that includes all pages.
-	 * @param {boolean=} options.stdout - Use standard output.
-	 * @param {string=} options.userPassword - User password (for encrypted files).
-	 * @param {number=} options.wordBreakThreshold - Adjust the word break threshold percent.
+	 * @param {string} [options.ownerPassword] - Owner password (for encrypted files).
+	 * @param {boolean} [options.printVersionInfo] - Print copyright and version info.
+	 * @param {boolean} [options.quiet] - Do not print any messages or errors.
+	 * @param {boolean} [options.singlePage] - generate single HTML that includes all pages.
+	 * @param {boolean} [options.stdout] - Use standard output.
+	 * @param {string} [options.userPassword] - User password (for encrypted files).
+	 * @param {number} [options.wordBreakThreshold] - Adjust the word break threshold percent.
 	 * Default is 10. Word break occurs when distance between two adjacent characters is greater
 	 * than this percent of character height.
-	 * @param {boolean=} options.xmlOutput - Output for XML post-processing.
-	 * @param {number=} options.zoom - Zoom the PDF document (default 1.5).
+	 * @param {boolean} [options.xmlOutput] - Output for XML post-processing.
+	 * @param {number} [options.zoom] - Zoom the PDF document (default 1.5).
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfToHtml(file, outputFile, options = {}) {
@@ -841,10 +862,11 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				path.joinSafe(this.popplerPath, "pdftohtml"),
+				joinSafe(this.popplerPath, "pdftohtml"),
 				["-v"]
 			);
 
+			// @ts-ignore: parseOptions checks if falsy
 			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
@@ -861,7 +883,7 @@ class Poppler {
 				}
 
 				const child = spawn(
-					path.joinSafe(this.popplerPath, "pdftohtml"),
+					joinSafe(this.popplerPath, "pdftohtml"),
 					args
 				);
 
@@ -883,7 +905,7 @@ class Poppler {
 
 				/**
 				 * pdfToHtml does not return an exit code so check output to see if it was successful.
-				 * See https://gitlab.freedesktop.org/poppler/poppler/-/blob/master/utils/pdftohtml.1
+				 * @see {@link  https://gitlab.freedesktop.org/poppler/poppler/-/blob/master/utils/pdftohtml.1 | Poppler pdftohtml man}
 				 */
 				child.on("close", () => {
 					if (stdOut !== "") {
@@ -903,73 +925,73 @@ class Poppler {
 	 * @description Converts a PDF file to colour image files in Portable Pixmap (PPM) format,
 	 * grayscale image files in Portable Graymap (PGM) format, or monochrome image files
 	 * in Portable Bitmap (PBM) format.
-	 * @param {Buffer| string} file - PDF file as Buffer, or filepath of the PDF file to read.
+	 * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
 	 * @param {string} outputPath - Filepath to output the results to.
-	 * @param {object=} options - Object containing options to pass to binary.
-	 * @param {('yes'|'no')=} options.antialiasFonts - Enable or disable font anti-aliasing.
+	 * @param {object} [options] - Object containing options to pass to binary.
+	 * @param {('no'|'yes')} [options.antialiasFonts] - Enable or disable font anti-aliasing.
 	 * This defaults to `yes`.
-	 * @param {('yes'|'no')=} options.antialiasVectors - Enable or disable vector anti-aliasing.
+	 * @param {('no'|'yes')} [options.antialiasVectors] - Enable or disable vector anti-aliasing.
 	 * This defaults to `yes`.
-	 * @param {boolean=} options.cropBox - Uses the crop box rather than media box when
+	 * @param {boolean} [options.cropBox] - Uses the crop box rather than media box when
 	 * generating the files (PNG/JPEG/TIFF only).
-	 * @param {number=} options.cropHeight - Specifies the height of crop area in pixels
+	 * @param {number} [options.cropHeight] - Specifies the height of crop area in pixels
 	 * (image output) or points (vector output).
-	 * @param {number=} options.cropSize - Specifies the size of crop square in pixels
+	 * @param {number} [options.cropSize] - Specifies the size of crop square in pixels
 	 * (image output) or points (vector output).
-	 * @param {number=} options.cropWidth - Specifies the width of crop area in pixels
+	 * @param {number} [options.cropWidth] - Specifies the width of crop area in pixels
 	 * (image output) or points (vector output).
-	 * @param {number=} options.cropXAxis - Specifies the x-coordinate of the crop area top left
+	 * @param {number} [options.cropXAxis] - Specifies the x-coordinate of the crop area top left
 	 * corner in pixels (image output) or points (vector output).
-	 * @param {number=} options.cropYAxis - Specifies the y-coordinate of the crop area top left
+	 * @param {number} [options.cropYAxis] - Specifies the y-coordinate of the crop area top left
 	 * corner in pixels (image output) or points (vector output).
-	 * @param {string=} options.defaultCmykProfile - If Poppler is compiled with colour management support, this option
+	 * @param {string} [options.defaultCmykProfile] - If Poppler is compiled with colour management support, this option
 	 * sets the DefaultCMYK color space to the ICC profile stored in the display profile file passed.
-	 * @param {string=} options.defaultGrayProfile - If Poppler is compiled with colour management support, this option
+	 * @param {string} [options.defaultGrayProfile] - If Poppler is compiled with colour management support, this option
 	 * sets the DefaultGray color space to the ICC profile stored in the display profile file passed.
-	 * @param {string=} options.defaultRgbProfile - If Poppler is compiled with colour management support, this option
+	 * @param {string} [options.defaultRgbProfile] - If Poppler is compiled with colour management support, this option
 	 * sets the DefaultRGB color space to the ICC profile stored in the display profile file passed.
-	 * @param {string=} options.displayProfile - If Poppler is compiled with colour management support, this option
+	 * @param {string} [options.displayProfile] - If Poppler is compiled with colour management support, this option
 	 * sets the display profile to the ICC profile stored in the display profile file passed.
-	 * @param {boolean=} options.evenPagesOnly - Generates only the even numbered pages.
-	 * @param {number=} options.firstPageToConvert - Specifies the first page to convert.
-	 * @param {('yes'|'no')=} options.freetype - Enable or disable FreeType (a TrueType / Type 1 font rasterizer).
+	 * @param {boolean} [options.evenPagesOnly] - Generates only the even numbered pages.
+	 * @param {number} [options.firstPageToConvert] - Specifies the first page to convert.
+	 * @param {('no'|'yes')} [options.freetype] - Enable or disable FreeType (a TrueType / Type 1 font rasterizer).
 	 * This defaults to `yes`.
-	 * @param {boolean=} options.forcePageNumber - Force page number even if there is only one page.
-	 * @param {boolean=} options.grayscaleFile - Generate grayscale PGM file (instead of a color PPM file).
-	 * @param {boolean=} options.hideAnnotations - Hide annotations.
-	 * @param {boolean=} options.jpegFile - Generate JPEG file instead a PPM file.
-	 * @param {number=} options.lastPageToConvert - Specifies the last page to convert.
-	 * @param {boolean=} options.monochromeFile - Generate monochrome PBM file (instead of a color PPM file).
-	 * @param {boolean=} options.oddPagesOnly - Generates only the odd numbered pages.
-	 * @param {string=} options.ownerPassword - Specify the owner password for the PDF file.
+	 * @param {boolean} [options.forcePageNumber] - Force page number even if there is only one page.
+	 * @param {boolean} [options.grayscaleFile] - Generate grayscale PGM file (instead of a color PPM file).
+	 * @param {boolean} [options.hideAnnotations] - Hide annotations.
+	 * @param {boolean} [options.jpegFile] - Generate JPEG file instead a PPM file.
+	 * @param {number} [options.lastPageToConvert] - Specifies the last page to convert.
+	 * @param {boolean} [options.monochromeFile] - Generate monochrome PBM file (instead of a color PPM file).
+	 * @param {boolean} [options.oddPagesOnly] - Generates only the odd numbered pages.
+	 * @param {string} [options.ownerPassword] - Specify the owner password for the PDF file.
 	 * Providing this will bypass all security restrictions.
-	 * @param {boolean=} options.pngFile - Generate PNG file instead a PPM file.
-	 * @param {boolean=} options.printProgress - Print progress info as each page is generated.
+	 * @param {boolean} [options.pngFile] - Generate PNG file instead a PPM file.
+	 * @param {boolean} [options.printProgress] - Print progress info as each page is generated.
 	 * Three space-separated fields are printed to STDERR: the number of the current page, the number
 	 * of the last page that will be generated, and the path to the file written to.
-	 * @param {boolean=} options.printVersionInfo - Print copyright and version information.
-	 * @param {boolean=} options.quiet - Do not print any messages or errors.
-	 * @param {number=} options.resolutionXAxis - Specifies the X resolution, in pixels per inch of
+	 * @param {boolean} [options.printVersionInfo] - Print copyright and version information.
+	 * @param {boolean} [options.quiet] - Do not print any messages or errors.
+	 * @param {number} [options.resolutionXAxis] - Specifies the X resolution, in pixels per inch of
 	 * image files (or rasterized regions in vector output). The default is 150 PPI.
-	 * @param {number=} options.resolutionXYAxis - Specifies the X and Y resolution, in pixels per
+	 * @param {number} [options.resolutionXYAxis] - Specifies the X and Y resolution, in pixels per
 	 * inch of image files (or rasterized regions in vector output). The default is 150 PPI.
-	 * @param {number=} options.resolutionYAxis - Specifies the Y resolution, in pixels per inch of
+	 * @param {number} [options.resolutionYAxis] - Specifies the Y resolution, in pixels per inch of
 	 * image files (or rasterized regions in vector output). The default is 150 PPI.
-	 * @param {number=} options.scalePageTo - Scales the long side of each page (width for landscape
+	 * @param {number} [options.scalePageTo] - Scales the long side of each page (width for landscape
 	 * pages, height for portrait pages) to fit in scale-to pixels. The size of the short side will
 	 * be determined by the aspect ratio of the page.
-	 * @param {number=} options.scalePageToXAxis - Scales each page horizontally to fit in scale-to-x
+	 * @param {number} [options.scalePageToXAxis] - Scales each page horizontally to fit in scale-to-x
 	 * pixels. If scale-to-y is set to -1, the vertical size will determined by the aspect ratio of
 	 * the page.
-	 * @param {number=} options.scalePageToYAxis - Scales each page vertically to fit in scale-to-y
+	 * @param {number} [options.scalePageToYAxis] - Scales each page vertically to fit in scale-to-y
 	 * pixels. If scale-to-x is set to -1, the horizontal size will determined by the aspect ratio of
 	 * the page.
-	 * @param {string=} options.separator - Specify single character separator between name and page number.
-	 * @param {boolean=} options.singleFile - Writes only the first page and does not add digits.
-	 * @param {('none'|'solid'|'shape')=} options.thinLineMode - Specifies the thin line mode. This defaults to `none`.
-	 * @param {('none'|'packbits'|'jpeg'|'lzw'|'deflate')=} options.tiffCompression - Set TIFF compression.
-	 * @param {boolean=} options.tiffFile - Generate TIFF file instead a PPM file.
-	 * @param {string=} options.userPassword - Specify the user password for the PDF file.
+	 * @param {string} [options.separator] - Specify single character separator between name and page number.
+	 * @param {boolean} [options.singleFile] - Writes only the first page and does not add digits.
+	 * @param {('none'|'shape'|'solid')} [options.thinLineMode] - Specifies the thin line mode. This defaults to `none`.
+	 * @param {('deflate'|'jpeg'|'lzw'|'none'|'packbits')} [options.tiffCompression] - Set TIFF compression.
+	 * @param {boolean} [options.tiffFile] - Generate TIFF file instead a PPM file.
+	 * @param {string} [options.userPassword] - Specify the user password for the PDF file.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfToPpm(file, outputPath, options = {}) {
@@ -1045,10 +1067,11 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				path.joinSafe(this.popplerPath, "pdftoppm"),
+				joinSafe(this.popplerPath, "pdftoppm"),
 				["-v"]
 			);
 
+			// @ts-ignore: parseOptions checks if falsy
 			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
@@ -1063,7 +1086,7 @@ class Poppler {
 				args.push(outputPath);
 
 				const child = spawn(
-					path.joinSafe(this.popplerPath, "pdftoppm"),
+					joinSafe(this.popplerPath, "pdftoppm"),
 					args
 				);
 
@@ -1079,13 +1102,17 @@ class Poppler {
 				});
 
 				child.on("close", (code) => {
+					/* istanbul ignore else */
 					if (stdErr !== "") {
 						reject(new Error(stdErr.trim()));
 					} else if (code === 0) {
 						resolve(errorMessages[code]);
 					} else {
-						/* istanbul ignore next */
-						reject(new Error(errorMessages[code]));
+						reject(
+							new Error(
+								code ? errorMessages[code] : errorMessages.unk
+							)
+						);
 					}
 				});
 			});
@@ -1097,110 +1124,110 @@ class Poppler {
 	/**
 	 * @author Frazer Smith
 	 * @description Converts a PDF file to PostScript (PS).
-	 * @param {Buffer| string} file - PDF file as Buffer, or filepath of the PDF file to read.
-	 * @param {string=} outputFile - Filepath of the file to output the results to.
+	 * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+	 * @param {string} [outputFile] - Filepath of the file to output the results to.
 	 * If `undefined` then will write output to stdout.
-	 * @param {object=} options - Object containing options to pass to binary.
-	 * @param {('yes'|'no')=} options.antialias - Enable anti-aliasing on rasterization, accepts `yes` or `no`.
-	 * @param {boolean=} options.binary - Write binary data in Level 1 PostScript. By default,
+	 * @param {object} [options] - Object containing options to pass to binary.
+	 * @param {('no'|'yes')} [options.antialias] - Enable anti-aliasing on rasterization, accepts `no` or `yes`.
+	 * @param {boolean} [options.binary] - Write binary data in Level 1 PostScript. By default,
 	 * pdftops writes hex-encoded data in Level 1 PostScript. Binary data is non-standard in Level 1
 	 * PostScript but reduces the file size and can be useful when Level 1 PostScript is required
 	 * only for its restricted use of PostScript operators.
-	 * @param {string=} options.defaultCmykProfile - If Poppler is compiled with colour management support, this option
+	 * @param {string} [options.defaultCmykProfile] - If Poppler is compiled with colour management support, this option
 	 * sets the DefaultCMYK color space to the ICC profile stored in the display profile file passed.
-	 * @param {string=} options.defaultGrayProfile - If Poppler is compiled with colour management support, this option
+	 * @param {string} [options.defaultGrayProfile] - If Poppler is compiled with colour management support, this option
 	 * sets the DefaultGray color space to the ICC profile stored in the display profile file passed.
-	 * @param {string=} options.defaultRgbProfile - If Poppler is compiled with colour management support, this option
+	 * @param {string} [options.defaultRgbProfile] - If Poppler is compiled with colour management support, this option
 	 * sets the DefaultRGB color space to the ICC profile stored in the display profile file passed.
-	 * @param {boolean=} options.duplex - Set the Duplex pagedevice entry in the PostScript file.
+	 * @param {boolean} [options.duplex] - Set the Duplex pagedevice entry in the PostScript file.
 	 * This tells duplex-capable printers to enable duplexing.
-	 * @param {boolean=} options.epsFile - Generate an EPS file. An EPS file contains a single image,
+	 * @param {boolean} [options.epsFile] - Generate an EPS file. An EPS file contains a single image,
 	 * so if you use this option with a multi-page PDF file, you must use `options.firstPageToConvert` and
 	 * `options.lastPageToConvert` to specify a single page.
 	 * The page size options (originalPageSizes, paperSize, paperWidth, paperHeight) can not be used
 	 * with this option.
-	 * @param {boolean=} options.fillPage - Expand PDF pages smaller than the paper to fill the
+	 * @param {boolean} [options.fillPage] - Expand PDF pages smaller than the paper to fill the
 	 * paper. By default, these pages are not scaled.
-	 * @param {number=} options.firstPageToConvert - Specifies the first page to convert.
-	 * @param {number=} options.form - Generate PostScript form which can be imported by software
+	 * @param {number} [options.firstPageToConvert] - Specifies the first page to convert.
+	 * @param {number} [options.form] - Generate PostScript form which can be imported by software
 	 * that understands forms.
 	 * A form contains a single page, so if you use this option with a multi-page PDF file,
 	 * you must use `options.firstPageToConvert` and `options.lastPageToConvert` to specify a single page.
 	 * The `options.level1` option cannot be used with `options.form`.
 	 * No more than one of the mode options (`options.epsFile`, `options.form`) may be given.
-	 * @param {number=} options.lastPageToConvert - Specifies the last page to convert.
-	 * @param {boolean=} options.level1 - Generate Level 1 PostScript. The resulting PostScript
+	 * @param {number} [options.lastPageToConvert] - Specifies the last page to convert.
+	 * @param {boolean} [options.level1] - Generate Level 1 PostScript. The resulting PostScript
 	 * files will be significantly larger (if they contain images), but will print on Level 1 printers.
 	 * This also converts all images to black and white.
-	 * @param {boolean=} options.level1Sep - Generate Level 1 separable PostScript.
+	 * @param {boolean} [options.level1Sep] - Generate Level 1 separable PostScript.
 	 * All colors are converted to CMYK. Images are written with separate stream data for the four components.
-	 * @param {boolean=} options.level2 - Generate Level 2 PostScript.
+	 * @param {boolean} [options.level2] - Generate Level 2 PostScript.
 	 * Level 2 supports color images and image compression. This is the default setting.
-	 * @param {boolean=} options.level2Sep - Generate Level 2 separable PostScript. All colors are
+	 * @param {boolean} [options.level2Sep] - Generate Level 2 separable PostScript. All colors are
 	 * converted to CMYK. The PostScript separation convention operators are used to handle custom (spot) colors.
-	 * @param {boolean=} options.level3 - Generate Level 3 PostScript.
+	 * @param {boolean} [options.level3] - Generate Level 3 PostScript.
 	 * This enables all Level 2 featuresplus CID font embedding.
-	 * @param {boolean=} options.level3Sep - Generate Level 3 separable PostScript.
+	 * @param {boolean} [options.level3Sep] - Generate Level 3 separable PostScript.
 	 * The separation handling is the same as for `options.level2Sep`.
-	 * @param {boolean=} options.noEmbedCIDFonts - By default, any CID PostScript fonts which are
+	 * @param {boolean} [options.noEmbedCIDFonts] - By default, any CID PostScript fonts which are
 	 * embedded in the PDF file are copied into the PostScript file. This option disables that embedding.
 	 * No attempt is made to substitute for non-embedded CID PostScript fonts.
-	 * @param {boolean=} options.noEmbedCIDTrueTypeFonts - By default, any CID TrueType fonts which are
+	 * @param {boolean} [options.noEmbedCIDTrueTypeFonts] - By default, any CID TrueType fonts which are
 	 * embedded in the PDF file are copied into the PostScript file. This option disables that embedding.
 	 * No attempt is made to substitute for non-embedded CID TrueType fonts.
-	 * @param {boolean=} options.noEmbedTrueTypeFonts - By default, any TrueType fonts which are embedded
+	 * @param {boolean} [options.noEmbedTrueTypeFonts] - By default, any TrueType fonts which are embedded
 	 * in the PDF file are copied into the PostScript file. This option causes pdfToPs to substitute base fonts instead.
 	 * Embedded fonts make PostScript files larger, but may be necessary for readable output.
 	 * Also, some PostScript interpreters do not have TrueType rasterizers.
-	 * @param {boolean=} options.noEmbedType1Fonts - By default, any Type 1 fonts which are embedded in the PDF file
+	 * @param {boolean} [options.noEmbedType1Fonts] - By default, any Type 1 fonts which are embedded in the PDF file
 	 * are copied into the PostScript file. This option causes pdfToPs to substitute base fonts instead.
 	 * Embedded fonts make PostScript files larger, but may be necessary for readable output.
-	 * @param {boolean=} options.noCenter - By default, PDF pages smaller than the paper
+	 * @param {boolean} [options.noCenter] - By default, PDF pages smaller than the paper
 	 * (after any scaling) are centered on the paper. This option causes them to be aligned to
 	 * the lower-left corner of the paper instead.
-	 * @param {boolean=} options.noCrop - By default, printing output is cropped to the CropBox
+	 * @param {boolean} [options.noCrop] - By default, printing output is cropped to the CropBox
 	 * specified in the PDF file. This option disables cropping.
-	 * @param {boolean=} options.noShrink - Do not scale PDF pages which are larger than the paper.
+	 * @param {boolean} [options.noShrink] - Do not scale PDF pages which are larger than the paper.
 	 * By default, pages larger than the paper are shrunk to fit.
-	 * @param {boolean=} options.opi - Generate OPI comments for all images and forms which have OPI information.
-	 * @param {boolean=} options.optimizecolorspace - By default, bitmap images in the PDF pass through to the
+	 * @param {boolean} [options.opi] - Generate OPI comments for all images and forms which have OPI information.
+	 * @param {boolean} [options.optimizecolorspace] - By default, bitmap images in the PDF pass through to the
 	 * output PostScript in their original color space, which produces predictable results.
 	 * This option converts RGB and CMYK images into Gray images if every pixel of the image has equal components.
 	 * This can fix problems when doing color separations of PDFs that contain embedded black and
 	 * white images encoded as RGB.
-	 * @param {boolean=} options.originalPageSizes - Set the paper size of each page to match
+	 * @param {boolean} [options.originalPageSizes] - Set the paper size of each page to match
 	 * the size specified in the PDF file.
-	 * @param {boolean=} options.overprint - Enable overprinting.
-	 * @param {string=} options.ownerPassword - Owner password (for encrypted files).
-	 * @param {number=} options.paperHeight - Set the paper height, in points.
-	 * @param {('letter'|'legal'|'A4'|'A3'|'match')=} options.paperSize - Set the paper size to one of `letter`, `legal`, `A4`,
-	 * or `A3`. This can also be set to `match`, which will set the paper size
+	 * @param {boolean} [options.overprint] - Enable overprinting.
+	 * @param {string} [options.ownerPassword] - Owner password (for encrypted files).
+	 * @param {number} [options.paperHeight] - Set the paper height, in points.
+	 * @param {('A3'|'A4'|'legal'|'letter'|'match')} [options.paperSize] - Set the paper size to one of `A3`, `A4`,
+	 * `legal`, or `letter`. This can also be set to `match`, which will set the paper size
 	 * of each page to match the size specified in the PDF file. If none of the paperSize,
 	 * paperWidth, or paperHeight options are specified the default is to match the paper size.
-	 * @param {number=} options.paperWidth - Set the paper width, in points.
-	 * @param {boolean=} options.passfonts - By default, references to non-embedded 8-bit fonts
+	 * @param {number} [options.paperWidth] - Set the paper width, in points.
+	 * @param {boolean} [options.passfonts] - By default, references to non-embedded 8-bit fonts
 	 * in the PDF file are substituted with the closest `Helvetica`, `Times-Roman`, or `Courier` font.
 	 * This option passes references to non-embedded fonts through to the PostScript file.
-	 * @param {boolean=} options.preload - Preload images and forms.
-	 * @param {boolean=} options.printVersionInfo - Print copyright and version information.
-	 * @param {('CMYK8'|'MONO8'|'RGB8')=} options.processColorFormat - Sets the process color format as it is used
+	 * @param {boolean} [options.preload] - Preload images and forms.
+	 * @param {boolean} [options.printVersionInfo] - Print copyright and version information.
+	 * @param {('CMYK8'|'MONO8'|'RGB8')} [options.processColorFormat] - Sets the process color format as it is used
 	 * during rasterization and transparency reduction.
 	 *
 	 * The default depends on the other settings: For `options.level1` the default is MONO8; for `options.level1Sep`,
 	 * `options.level2Sep`, `options.level3Sep`, or `options.overprint` the default is CMYK8; in all other
 	 * cases RGB8 is the default.
 	 * If `option.processColorProfile` is set then `options.processColorFormat` is inferred from the specified ICC profile.
-	 * @param {string=} options.processColorProfile - Sets the ICC profile that is assumed during
+	 * @param {string} [options.processColorProfile] - Sets the ICC profile that is assumed during
 	 * rasterization and transparency reduction.
-	 * @param {boolean=} options.quiet - Do not print any messages or errors.
-	 * @param {('always'|'never'|'whenneeded')=} options.rasterize - By default, pdfToPs rasterizes pages as needed,
+	 * @param {boolean} [options.quiet] - Do not print any messages or errors.
+	 * @param {('always'|'never'|'whenneeded')} [options.rasterize] - By default, pdfToPs rasterizes pages as needed,
 	 * for example, if they contain transparencies. To force rasterization, set `rasterize` to `always`.
 	 * Use this to eliminate fonts.
 	 * To prevent rasterization, set `rasterize` to `never`.
 	 * This may produce files that display incorrectly.
-	 * @param {number=} options.resolutionXYAxis - Specifies the X and Y resolution, in pixels per
+	 * @param {number} [options.resolutionXYAxis] - Specifies the X and Y resolution, in pixels per
 	 * inch of image files (or rasterized regions in vector output). The default is 300 PPI.
-	 * @param {string=} options.userPassword - User password (for encrypted files).
+	 * @param {string} [options.userPassword] - User password (for encrypted files).
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfToPs(file, outputFile, options = {}) {
@@ -1265,7 +1292,7 @@ class Poppler {
 			processColorFormat: { arg: "-processcolorformat", type: "string" },
 			quiet: { arg: "-q", type: "boolean" },
 			rasterize: {
-				args: "-rasterize",
+				arg: "-rasterize",
 				type: "string",
 				minVersion: "0.90.0",
 			},
@@ -1275,10 +1302,11 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				path.joinSafe(this.popplerPath, "pdftops"),
+				joinSafe(this.popplerPath, "pdftops"),
 				["-v"]
 			);
 
+			// @ts-ignore: parseOptions checks if falsy
 			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
@@ -1297,7 +1325,7 @@ class Poppler {
 				}
 
 				const child = spawn(
-					path.joinSafe(this.popplerPath, "pdftops"),
+					joinSafe(this.popplerPath, "pdftops"),
 					args
 				);
 
@@ -1318,6 +1346,7 @@ class Poppler {
 				});
 
 				child.on("close", (code) => {
+					/* istanbul ignore else */
 					if (stdOut !== "") {
 						resolve(stdOut.trim());
 					} else if (code === 0) {
@@ -1325,8 +1354,11 @@ class Poppler {
 					} else if (stdErr !== "") {
 						reject(new Error(stdErr.trim()));
 					} else {
-						/* istanbul ignore next */
-						reject(new Error(errorMessages[code]));
+						reject(
+							new Error(
+								code ? errorMessages[code] : errorMessages.unk
+							)
+						);
 					}
 				});
 			});
@@ -1338,49 +1370,49 @@ class Poppler {
 	/**
 	 * @author Frazer Smith
 	 * @description Converts a PDF file to TXT.
-	 * @param {Buffer| string} file - PDF file as Buffer, or filepath of the PDF file to read.
-	 * @param {string=} outputFile - Filepath of the file to output the results to.
+	 * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+	 * @param {string} [outputFile] - Filepath of the file to output the results to.
 	 * If `undefined` then will write output to stdout.
-	 * @param {object=} options - Object containing options to pass to binary.
-	 * @param {boolean=} options.boundingBoxXhtml - Generate an XHTML file containing bounding
+	 * @param {object} [options] - Object containing options to pass to binary.
+	 * @param {boolean} [options.boundingBoxXhtml] - Generate an XHTML file containing bounding
 	 * box information for each word in the file.
-	 * @param {boolean=} options.boundingBoxXhtmlLayout - Generate an XHTML file containing
+	 * @param {boolean} [options.boundingBoxXhtmlLayout] - Generate an XHTML file containing
 	 * bounding box information for each block, line, and word in the file.
-	 * @param {boolean=} options.cropBox - Use the crop box rather than the media box with
+	 * @param {boolean} [options.cropBox] - Use the crop box rather than the media box with
 	 * `options.boundingBoxXhtml` and `options.boundingBoxXhtmlLayout`
-	 * @param {number=} options.cropHeight - Specifies the height of crop area in pixels
+	 * @param {number} [options.cropHeight] - Specifies the height of crop area in pixels
 	 * (image output) or points (vector output).
-	 * @param {number=} options.cropWidth - Specifies the width of crop area in pixels
+	 * @param {number} [options.cropWidth] - Specifies the width of crop area in pixels
 	 * (image output) or points (vector output).
-	 * @param {number=} options.cropXAxis - Specifies the x-coordinate of the crop area top left
+	 * @param {number} [options.cropXAxis] - Specifies the x-coordinate of the crop area top left
 	 * corner in pixels (image output) or points (vector output).
-	 * @param {number=} options.cropYAxis - Specifies the y-coordinate of the crop area top left
+	 * @param {number} [options.cropYAxis] - Specifies the y-coordinate of the crop area top left
 	 * corner in pixels (image output) or points (vector output).
-	 * @param {('unix'|'dos'|'mac')=} options.eolConvention - Sets the end-of-line convention to use for
-	 * text output: unix; dos; mac.
-	 * @param {number=} options.firstPageToConvert - Specifies the first page to convert.
-	 * @param {number=} options.fixedWidthLayout - Assume fixed-pitch (or tabular) text, with the
+	 * @param {('dos'|'mac'|'unix')} [options.eolConvention] - Sets the end-of-line convention to use for
+	 * text output: dos; mac; unix.
+	 * @param {number} [options.firstPageToConvert] - Specifies the first page to convert.
+	 * @param {number} [options.fixedWidthLayout] - Assume fixed-pitch (or tabular) text, with the
 	 * specified character width (in points). This forces physical layout mode.
-	 * @param {boolean=} options.generateHtmlMetaFile - Generate simple HTML file, including the
+	 * @param {boolean} [options.generateHtmlMetaFile] - Generate simple HTML file, including the
 	 * meta information. This simply wraps the text in `<pre>` and `</pre>` and prepends the meta headers.
-	 * @param {boolean=} options.generateTsvFile - Generate a TSV file containing the bounding box
+	 * @param {boolean} [options.generateTsvFile] - Generate a TSV file containing the bounding box
 	 * information for each block, line, and word in the file.
-	 * @param {number=} options.lastPageToConvert - Specifies the last page to convert.
-	 * @param {boolean=} options.listEncodingOptions - List the available encodings.
-	 * @param {boolean=} options.maintainLayout - Maintain (as best as possible) the original physical
+	 * @param {number} [options.lastPageToConvert] - Specifies the last page to convert.
+	 * @param {boolean} [options.listEncodingOptions] - List the available encodings.
+	 * @param {boolean} [options.maintainLayout] - Maintain (as best as possible) the original physical
 	 * layout of the text. The default is to undo physical layout (columns, hyphenation, etc.) and
 	 * output the text in reading order.
-	 * @param {boolean=} options.noDiagonalText - Discard diagonal text.
-	 * @param {boolean=} options.noPageBreaks - Do not insert page breaks (form feed characters)
+	 * @param {boolean} [options.noDiagonalText] - Discard diagonal text.
+	 * @param {boolean} [options.noPageBreaks] - Do not insert page breaks (form feed characters)
 	 * between pages.
-	 * @param {string=} options.outputEncoding - Sets the encoding to use for text output.
+	 * @param {string} [options.outputEncoding] - Sets the encoding to use for text output.
 	 * This defaults to `UTF-8`.
-	 * @param {string=} options.ownerPassword - Owner password (for encrypted files).
-	 * @param {boolean=} options.printVersionInfo - Print copyright and version information.
-	 * @param {boolean=} options.quiet - Do not print any messages or errors.
-	 * @param {boolean=} options.rawLayout - Keep the text in content stream order. This is a
+	 * @param {string} [options.ownerPassword] - Owner password (for encrypted files).
+	 * @param {boolean} [options.printVersionInfo] - Print copyright and version information.
+	 * @param {boolean} [options.quiet] - Do not print any messages or errors.
+	 * @param {boolean} [options.rawLayout] - Keep the text in content stream order. This is a
 	 * hack which often undoes column formatting, etc. Use of raw mode is no longer recommended.
-	 * @param {string=} options.userPassword - User password (for encrypted files).
+	 * @param {string} [options.userPassword] - User password (for encrypted files).
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfToText(file, outputFile, options = {}) {
@@ -1424,10 +1456,11 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				path.joinSafe(this.popplerPath, "pdftotext"),
+				joinSafe(this.popplerPath, "pdftotext"),
 				["-v"]
 			);
 
+			// @ts-ignore: parseOptions checks if falsy
 			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
@@ -1446,7 +1479,7 @@ class Poppler {
 				}
 
 				const child = spawn(
-					path.joinSafe(this.popplerPath, "pdftotext"),
+					joinSafe(this.popplerPath, "pdftotext"),
 					args
 				);
 
@@ -1467,6 +1500,7 @@ class Poppler {
 				});
 
 				child.on("close", (code) => {
+					/* istanbul ignore else */
 					if (stdOut !== "") {
 						resolve(stdOut.trim());
 					} else if (code === 0) {
@@ -1474,8 +1508,11 @@ class Poppler {
 					} else if (stdErr !== "") {
 						reject(new Error(stdErr.trim()));
 					} else {
-						/* istanbul ignore next */
-						reject(new Error(errorMessages[code]));
+						reject(
+							new Error(
+								code ? errorMessages[code] : errorMessages.unk
+							)
+						);
 					}
 				});
 			});
@@ -1488,11 +1525,11 @@ class Poppler {
 	 * @author Frazer Smith
 	 * @description Merges several PDF files in order of their occurrence in the files array to
 	 * one PDF result file.
-	 * @param {Array} files - Filepaths of the PDF files to merge.
+	 * @param {string[]} files - Filepaths of the PDF files to merge.
 	 * An entire directory of PDF files can be merged like so: `path/to/directory/*.pdf`.
 	 * @param {string} outputFile - Filepath of the file to output the resulting merged PDF to.
-	 * @param {object=} options - Object containing options to pass to binary.
-	 * @param {boolean=} options.printVersionInfo - Print copyright and version information.
+	 * @param {object} [options] - Object containing options to pass to binary.
+	 * @param {boolean} [options.printVersionInfo] - Print copyright and version information.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfUnite(files, outputFile, options = {}) {
@@ -1502,10 +1539,11 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				path.joinSafe(this.popplerPath, "pdfunite"),
+				joinSafe(this.popplerPath, "pdfunite"),
 				["-v"]
 			);
 
+			// @ts-ignore: parseOptions checks if falsy
 			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
@@ -1515,7 +1553,7 @@ class Poppler {
 			args.push(outputFile);
 
 			const { stdout } = await execFileAsync(
-				path.joinSafe(this.popplerPath, "pdfunite"),
+				joinSafe(this.popplerPath, "pdfunite"),
 				args
 			);
 			return Promise.resolve(stdout);