Install GroupDocs.Viewer for Node.js via Java Leave feedback

• Node.js: 20 LTS or later
• Java: JRE/JDK 8+ (recommended 17 LTS)
• Build tools if needed by your environment (node-gyp toolchain)

See full details on the System Requirements page.

All Java-bridged packages are hosted on npm. Install the library into your project using your preferred package manager:

# npm
npm install @groupdocs/groupdocs.viewer

# yarn
yarn add @groupdocs/groupdocs.viewer

# pnpm
pnpm add @groupdocs/groupdocs.viewer

Ensure your Java installation is available on PATH and JAVA_HOME is set.

Windows (PowerShell):

$env:JAVA_HOME="C:\Program Files\Java\jdk-17"
$env:Path="$env:JAVA_HOME\bin;$env:Path"

Linux/macOS (Bash):

export JAVA_HOME=/usr/lib/jvm/java-17
export PATH="$JAVA_HOME/bin:$PATH"

See the System Requirements page for more details.

Create a small script (e.g., check.js) and run it with Node.js:

import { Viewer } from '@groupdocs/groupdocs.viewer';

try {
  console.log('GroupDocs.Viewer loaded:', typeof Viewer === 'function');
  console.log('Java bridge initialized successfully.');
  process.exit(0);
} catch (e) {
  console.error('Failed to load GroupDocs.Viewer:', e);
  process.exit(1);
}

And than run the script to verify the installation:

node check.js

You can download a package archive from GroupDocs.Releases and add it to your app. After downloading the .tar file, install it locally:

npm install ./groupdocs-groupdocs.viewer-<version>.tar

Alternatively, configure npm to use your corporate registry or proxy, then install using the standard command.

Once you have installed the GroupDocs.Viewer package, here’s a minimal example of how you can use it in a Node.js application.

1. Create a JavaScript file (e.g., app.js) in your project’s root directory.

2. Import the GroupDocs.Viewer module and implement a simple file viewing functionality:

   JavaScript

   import { Viewer, HtmlViewOptions } from '@groupdocs/groupdocs.viewer';
   
   // Path to the file you want to render
   const filePath = 'sample.pdf';
   
   // Initialize viewer
   const viewer = new Viewer(filePath);
   
   // Render the file to HTML
   viewer.view(HtmlViewOptions.forEmbeddedResources());
   
   // Exit with a success code
   process.exit(0);
   

   sample.pdf

   sample.pdf is the sample file used in this example. Click here to download it.

3. Run the app by executing the following command in your terminal:

   node app.js
   

This minimal example converts a document to HTML format. The output will contain rendered pages in HTML format.

• node-gyp toolchain not found: install the required build tools for your OS (see System Requirements).
• Java not detected: set JAVA_HOME and add <JAVA_HOME>/bin to PATH.
• Corporate proxy: configure npm proxy settings before running install.
• Permission errors: ensure you have write access to the project directory and cache folders.