PDF.js 是一个用于网页上显示 PDF 文件的 JavaScript 库，而 @types/pdfjs-dist 是一个 TypeScript npm 包，提供了用 TypeScript 编写使用 PDF.js 的代码时所需的类型信息。
本文将介绍如何安装并使用 @types/pdfjs-dist 这个 npm 包，来使得在 TypeScript 项目中使用 PDF.js 变得更加方便和可靠。
安装
在使用 @types/pdfjs-dist 之前，需要先安装 PDF.js 库。可以通过以下命令在项目中安装 PDF.js：
npm install pdfjs-dist
之后，再通过以下命令安装 @types/pdfjs-dist：
npm install @types/pdfjs-dist -D
其中，-D 参数表示将 @types/pdfjs-dist 作为开发环境依赖来安装。
使用
安装完 @types/pdfjs-dist 后，在 TypeScript 中就可以直接使用 PDF.js 的核心功能了。
以下是一个简单的 TypeScript 示例代码，展示如何使用 PDF.js 加载 PDF 文档，并打印文档的页面数：
-- -------------------- ---- ------- ------ - -- -------- ---- ------------- ------ ---- - ---------------- - ---- ------------------------------- ----- --- - ----- -------- ------ ----- ----------- - -------------------------- ------------------------------ ----------------- -- - ------------------- -- -------- -------------- ---
首先，通过 import 语句将 pdfjsLib 和 PDFDocumentProxy 引入 TypeScript 中。pdfjsLib 是 PDF.js 的核心对象，而 PDFDocumentProxy 是 @types/pdfjs-dist 提供的一个类型，表示 PDF.js 中文档对象的类型信息。
接着，定义 PDF 文档的 URL，通过 pdfjsLib.getDocument() 方法加载文档，并在加载成功后调用 callback 函数，打印文档页面数。
注意，pdfjsLib.getDocument() 返回的是一个 Promise 对象，需要通过 .then() 方法来获取加载完成的 PDFDocumentProxy 对象，并在其中进行后续处理。
总结
在 TypeScript 项目中使用 PDF.js，可以通过安装并使用 @types/pdfjs-dist 这个 npm 包来方便地提供类型信息。
在代码编写过程中，需要注意导入 pdfjsLib 和 PDFDocumentProxy，正确处理 Promise 的返回值，并根据文档 API 编写相应的代码逻辑。
希望本文能为初学者提供参考和指导，帮助更多人顺利地使用 PDF.js 来展示 PDF 文档。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/194548