We’re pleased to announce the GroupDocs.Conversion for Node.js via Java v25.11 release, available as of November 2025. This update brings a critical compatibility fix for the newest Node.js 20+ runtimes, upgrades the underlying Java library, and introduces a few public API changes.

此版本的新功能

相容性修正

  • [Fix] CONVERSIONNODEJS-257 – GroupDocs.Conversion for Node.js via Java 現已完全相容於最新的 Node.js 20+ 版本。
    此修正解決了在較新 Node.js 可執行檔下載入原生 Java 橋接時發生的執行時錯誤。

底層程式庫更新

  • [Enhancement] CONVERSIONNODEJS-258 – Java 相依性已升級至 GroupDocs.Conversion for Java v25.9。
    所有在 Java 25.4 – 25.9 版本中包含的改進與錯誤修正現在已自動納入。

套件 README 更新

已更新 npm 套件 README，內容包括：

  • 主要產品功能
  • 系統需求
  • 安裝說明
  • 快速入門程式碼範例
  • 使用情境

文件更新

已更新的文件主題：

新增的文件主題：

公共 API 變更

Converter 類別

已移除接受串流的 Converter 類別建構函式，取而代之的是使用串流供應者：

const fs = require('fs');
const java = require('java');
const path = require('path');

// Create read stream from file
const readStream = fs.createReadStream("source.docx");

// Convert to GroupDocs input stream
const stream = await groupdocs.readDataFromStream(readStream);

// Create Supplier<InputStream> that returns the stream (equivalent to Java lambda: () -> stream)
const streamSupplier = java.newProxy('java.util.function.Supplier', {
  get: function() {
    return stream;
  }
});

// Initialize converter with stream data
const converter = new groupdocs.Converter(streamSupplier);

PdfConvertOptions 類別

  1. 方法 setWidth 已重新命名為 setPageWidth
  2. 方法 setHeight 已重新命名為 setPageHeight
// Configure PDF conversion options with advanced settings
const convertOptions = new groupdocs.PdfConvertOptions();
convertOptions.setPageWidth(1024); // Set output width
convertOptions.setPageHeight(768); // Set output height

如何取得更新

  • npm – 將套件升級至最新版本：
npm install @groupdocs/groupdocs.conversion@25.11.0
  • 直接下載 – 從官方 release page 取得最新的 JAR 和相關檔案。

資源

敬請關注即將推出的版本，這些版本將帶來更多格式支援、效能優化與 API 精煉。如您遇到任何問題或有任何建議，請透過支援論壇與我們聯繫。祝編程愉快！