Total for .NET Total for Java Total for Python

Total for Node.js via Java

为您的下一个 Node.js 应用提供的文档处理 SDK

轻松转换、合并、比较、签名和脱敏常见文档格式，如 PDF、Word 和 Excel——全部使用 GroupDocs Node.js SDK。

NPM下载开始免费试用

版本 26.8.0 已发布

看看有什么新鲜事

const java = require('java');
const groupdocs = require('@groupdocs/groupdocs.total');

const PdfConvertOptions = java.import('com.groupdocs.conversion.options.convert.PdfConvertOptions');

// 加载源 DOCX 文件
const converter = new groupdocs.Converter("./business-plan.docx");
// 为 PDF 文件创建保存选项
const pdfConvertOptions = new PdfConvertOptions();
// 将 DOCX 文件转换为 PDF
converter.convert("./converted.pdf", pdfConvertOptions);
converter.close();

// 加载已转换的 PDF 文件
const metadata = new groupdocs.Metadata("./converted.pdf");
// 移除 PDF 文件的元数据
metadata.sanitize();
// 保存无元数据的 PDF 文件
metadata.save("./converted_no_metadata.pdf");
metadata.close();

npm i @groupdocs/groupdocs.total

GroupDocs Node.js SDK 概览

使用同一个 SDK 包实现转换、合并、比较、签名和脱敏等常见文档格式，如 PDF、Word 和 Excel，详情请参阅产品概览。

将多个 GroupDocs 包的强大功能整合为单一企业级解决方案

GroupDocs.Total for Node.js via Java 将所有主要 GroupDocs API——Conversion、Merger、Signature 和 Comparison 的功能整合到一个工具套件中。

自动化复杂工作流，如将 Word 文件转换为 PDF、合并报告、应用安全数字签名或比较合同版本——全部在单一流程中完成。

这种统一的方法可节省时间，降低开发工作量，并简化整个组织的文档管理。

掌握多样的文件格式

实现对 200 多种文件类型的无缝兼容，包括 Word、Excel、PDF、PowerPoint、图像、CAD 图纸，甚至电子邮件或代码文件。GroupDocs.Total 确保您的解决方案在几乎所有业务环境使用的格式中均能完美运行。

跨平台且可伸缩的设计

可自信地部署在 Windows、Linux 或 macOS——任何运行 Node.js 和 Java 的环境。GroupDocs.Total 基于 Java 的引擎为企业工作负载提供高性能和可伸缩性，无论是本地部署、容器化还是云端运行。

平台独立性

GroupDocs.Total for Node.js via Java 支持以下操作系统、框架和包管理器，详情请参阅系统要求。

支持的文件格式

GroupDocs.Total for Node.js via Java 支持以下文件格式的操作。

Microsoft Office、OpenDocument 和文本格式

Word: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, TXT
Excel: XLS, XLSX, XLSM, XLSB, XLTM, XLT, XLTM, XLTX
PowerPoint: PPT, PPTX, PPS, PPSX, PPSM, POT, POTM, POTX, PPTM
Project: MPP, MPT, MPX
Outlook: MSG, EML, EMLX, PST, OST
OneNote: ONE
OpenDocument: ODT, OTT, ODS, ODP, OTP, OTS, ODG
Fixed Page Layout: PDF, TEX, XPS, OXPS
e-Books: EPUB, MOBI, DjVu
Delimiter-Separated Values: CSV, TSV

图像、图形和图表

光栅图像: BMP, GIF, JPG, PNG, TIFF, WebP, DNG, DIB, Jpeg2000 family
Windows Icon: ICO
Scalable Vector Graphics: SVG, CDR, CMX, IGS, SVGZ
Adobe Photoshop: PSD, PSB
Stereo Lithography (3D Printing): STL
Medical Imaging: DICOM
Plotter Documents: PLT, HPG
Autodesk Design Web Formats: DWF, DWG
AutoCAD Drawing: DWT, IFC, STL, CF2

其他

网络: HTML, MHT, MHTML, XML
Metafile: WMF, EMF, CGM, EMZ, WMZ
Visio: VSD, VDX, VSS, VSSX, VSX, VST, VSTX, VTX, VSDX, VDW, VSTM, VSSM, VSDM
Project: MPP, MPT, MPX
PostScript: PS, EPS
档案: ZIP, TAR, BZ2, GZ, RAR, RAR5
其他: VCF, VCARD, NUMBERS, NSF, OBJ
C/C++/C# Files: C, CC, C# , CPP, CXX, CS, H, HH, M, MM
Java/JavaScript Files: JAVA, JS, JSON, PROPERTIES

关键特性

全面的文档处理——大规模查看、转换、比较和管理 PDF 与 Office 文件。查看示例指南了解如何将其集成到您的应用程序中。

格式转换

在数百种文件类型之间实现高保真转换，保留布局、字体和元数据。支持批处理、流式和服务器端工作流，适用于生产系统。

安全的文件查看

高质量渲染，支持 180+ 种格式输出为 HTML、PDF、PNG 和 JPEG。可嵌入的查看器组件，适用于 Web 和桌面，具备可配置的访问控制和分页功能。

内容比较

精准的并排和内联比较，突出显示内容、格式和布局的变化，并生成可操作的变更报告，以供审查和审计。

水印控制

以编程方式进行水印添加和提取，支持文本/图像水印、条件应用规则以及合规性的审计日志。

元数据管理

在各种格式间实现强大的元数据读写和标准化，支持批量操作和基于策略的工作流，以提升可搜索性和治理能力。

文档合并

将多个文档（支持混合类型）合并为单一可搜索的输出，提供页面级排序、冲突解决和输出格式选项。

基于模板的生成

从模板和外部数据（JSON、XML、数据库）自动生成文档，实现可重复、可审计的报告以及大规模的个性化文档。

文本编辑（遮蔽）

精确且不可逆的遮蔽，支持正则、模糊匹配和同义词感知检测。可进行可视化遮蔽或从底层文档数据中移除。

签名灵活性

支持电子和数字签名（PKI）、图像/文本印章以及验证工作流——可集成到签署流水线和审计追踪中。

真实业务文档工作流

展示在日常文档工作流中如何使用 GroupDocs 的实际场景。

合并两个 DOCX 文件并将合并后的 DOCX 转换为 PDF

业务需求: 将多个源文档合并为单一可携带的交付物（例如： intake 表单、批准文件或合同章节的汇编），并生成最终的 PDF 用于分发或归档。

使用的产品: GroupDocs.Merger + GroupDocs.Conversion

结果: 生成单个可打印且可存档的 PDF，保持布局和元数据——降低手动合并工作，简化审查，并确保下游系统的输出一致性。

JavaScript

const fs = require('fs');
const path = require('path');
const java = require('java');
const groupdocs = require('@groupdocs/groupdocs.total');

const PdfConvertOptions = java.import('com.groupdocs.conversion.options.convert.PdfConvertOptions');
const PdfOptions = java.import('com.groupdocs.conversion.options.convert.PdfOptions');
const PdfFormats = java.import('com.groupdocs.conversion.options.convert.PdfFormats');

// 应用许可证
const licensePath = path.resolve("./GroupDocs.Total.lic");
if (fs.existsSync(licensePath)) {
    groupdocs.License.setLicense(licensePath);
}

// 将两个 DOCX 文件合并为一个文档
const merger = new groupdocs.Merger("./part-a.docx");
merger.join("./part-b.docx");
merger.save("./output-merged.docx");
merger.dispose();

// 将合并后的 DOCX 转换为 PDF（PDF/A-2b，满足归档合规）
const converter = new groupdocs.Converter("./output-merged.docx");
const options = new PdfConvertOptions();
const pdfOptions = new PdfOptions();
pdfOptions.setPdfFormat(PdfFormats.PdfA_2B);
options.setPdfOptions(pdfOptions);
converter.convert("./final-delivery.pdf", options);
converter.close();

提取文本、缩略图和元数据以进行索引

业务需求: 自动从导入的文档中提取可搜索的文本、可视化预览和结构化元数据，以驱动企业索引中的搜索、预览和内容分类。

使用的产品: GroupDocs.Viewer + GroupDocs.Metadata

结果: 实现更快速的文档检索和更丰富的搜索用户体验（文本 + 缩略图 + 元数据），提升相关性并自动化下游工作流，如标记、路由或基于机器学习的分类。

JavaScript

const fs = require('fs');
const path = require('path');
const java = require('java');
const groupdocs = require('@groupdocs/groupdocs.total');

const HtmlViewOptions = java.import('com.groupdocs.viewer.options.HtmlViewOptions');
const AnySpecification = java.import('com.groupdocs.metadata.search.AnySpecification');

// 应用许可证
const licensePath = path.resolve("./GroupDocs.Total.lic");
if (fs.existsSync(licensePath)) {
    groupdocs.License.setLicense(licensePath);
}

// 将文档页面渲染为 HTML 以供预览
const viewer = new groupdocs.Viewer("bussiness-plan.docx");
viewer.view(HtmlViewOptions.forEmbeddedResources("p_{0}.html"));
viewer.close();

// 读取元数据（标题、作者、自定义属性）
const metadata = new groupdocs.Metadata("bussiness-plan.docx");
const props = metadata.findProperties(new AnySpecification());
const it = props.iterator();
while (it.hasNext()) {
    const prop = it.next();
    console.log(prop.getName(), String(prop.getValue()));
}
metadata.close();

比较商业提案的两个版本，生成变更报告，并对个人信息进行脱敏

业务需求: 商业提案通常会经过多次修订。快速识别变更内容并在对外共享文档前去除姓名、电子邮件或电话号码等敏感联系信息十分重要。

使用的产品: GroupDocs.Comparison + GroupDocs.Redaction

结果: 结果是一份清晰的变更报告，突出显示提案各版本之间的所有编辑，并对联系信息进行安全脱敏，以实现安全合规的分发。

JavaScript

const fs = require('fs');
const path = require('path');
const java = require('java');
const groupdocs = require('@groupdocs/groupdocs.total');

const SaveOptions = java.import('com.groupdocs.redaction.options.SaveOptions');
const ReplacementOptions = java.import('com.groupdocs.redaction.redactions.ReplacementOptions');
const RegexRedaction = java.import('com.groupdocs.redaction.redactions.RegexRedaction');

// 应用许可证
const licensePath = path.resolve("./GroupDocs.Total.lic");
if (fs.existsSync(licensePath)) {
    groupdocs.License.setLicense(licensePath);
}

// 比较文档的两个版本
const comparer = new groupdocs.Comparer("./proposal_v1.docx");
comparer.add("./proposal_v2.docx");
comparer.compare("./proposal_diffs.docx");
comparer.close();

// 定义用于脱敏个人和公司信息的模式
const replacementOptions = new ReplacementOptions("[REDACTED]");
const phonePattern = String.raw`\b(?:\+?1[-.\s]?)?(?:\(?\d{3}\)?[-.\s]?)\d{3}[-.\s]?\d{4}\b`;
const emailPattern = String.raw`[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}`;

// 定义要应用的脱敏规则
const redactions = [
    new RegexRedaction(emailPattern, replacementOptions),
    new RegexRedaction(phonePattern, replacementOptions),
];

// 对文档应用脱敏
const redactor = new groupdocs.Redactor("./proposal_diffs.docx");
for (const redaction of redactions) {
    redactor.apply(redaction);
}

// 设置保存选项以保持源文件格式
const saveOptions = new SaveOptions();
saveOptions.setAddSuffix(true);
saveOptions.setRasterizeToPDF(false);
saveOptions.setRedactedFileSuffix("redacted");

// 保存已脱敏的文档
redactor.save(saveOptions);
redactor.close();