What’s new in this release

Category Identifier Description
Fix COMPARISONNODEJS-19 Compatibility issue with Node.js 20+ versions resolved. The library now loads and runs correctly on the latest LTS releases of Node.js.
Enhancement – The npm package README has been revised: installation steps are now explicit, and three common usage scenarios are documented.
Enhancement – Code‑example repository refreshed: structure standardized, logging added, and examples aligned with the official documentation.
Documentation – All example scripts are now standalone and can be executed without additional scaffolding. Updated topics: System Requirements, Installation, How to Run Examples.
Documentation – New documentation topic Running in Docker added, describing the Docker image, environment variables, and execution flow.

Key fix – Node.js 20+ compatibility

Prior to 25.11 the library threw Unsupported node version errors on Node 20.x and later. The fix updates the underlying Java bridge and package metadata, ensuring the @groupdocs/groupdocs.comparison binary works on the current LTS line without runtime patches.

Updated README – quick start snippet

# Install the package
npm i @groupdocs/groupdocs.comparison

// compare-two-docs.js
const { GroupDocsComparison } = require('@groupdocs/groupdocs.comparison');

(async () => {
    const comparison = new GroupDocsComparison({
        // Path to the Java runtime (JRE) if not in PATH
        javaHome: process.env.JAVA_HOME
    });

    const result = await comparison.compare(
        'samples/left.docx',
        'samples/right.docx',
        { outputPath: 'output/result.html' }
    );

    console.log(`Comparison completed. Result saved to ${result.outputPath}`);
})();

The snippet above reflects the new usage scenario added to the README and matches the updated documentation in Installation and How to Run Examples.

Documentation updates

  • System Requirements – clarified OS, JRE version, and Node.js versions supported.
  • Installation – step‑by‑step guide for npm, Maven, and Docker deployments.
  • How to Run Examples – instructions for running each example script directly from the repository.
  • Running in Docker – complete Dockerfile, docker run command, and volume‑mount guidelines.

All documentation is available under the Node.js‑via‑Java product section:

How to get the update

  • npm – Upgrade to the latest version (25.11) directly from the registry:

    npm install @groupdocs/groupdocs.comparison@latest

    Package page: https://www.npmjs.com/package/@groupdocs/groupdocs.comparison

  • Direct download – Binary and Java bridge files are bundled in the release assets on the GroupDocs download portal (link available in the full release notes).

Resources