How to Run Examples

The complete project GroupDocs.Total for Node.js via Java — Code Examples with runnable examples and sample files is hosted on GitHub. The structure and commands below are based on this repository and its README.

Prerequisites

Before running examples, make sure your environment meets the System Requirements and Installation guides:

  • Node.js: 20 LTS or later
  • Java: JRE/JDK 8+ (17 LTS recommended)
  • Java environment: JAVA_HOME set and added to PATH

Windows PowerShell:

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

Linux/macOS:

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

Run examples using npm

To get started, make sure that Node.js and Java are installed and configured as described above.

  1. Clone the repository with examples

    git clone git@github.com:groupdocs-total/GroupDocs.Total-for-Node.js-via-Java.git
    
  2. Navigate to the Examples folder

    cd ./GroupDocs.Total-for-Node.js-via-Java/Examples
    
  3. Install dependencies

    npm install
    

    This pulls @groupdocs/groupdocs.total from npm. We typically keep the dependency on the latest published version; to use another version, change it in package.json.

    If installation fails with native build errors, review the build tools section in System Requirements.

  4. Configure license (optional)

    If you have a license file, you can set the license path in the run_all_examples.js file. By default, the runner checks for the GROUPDOCS_LICENSE_PATH (or GROUPDOCS_LIC_PATH) environment variable or looks for files with the .lic extension in the Examples directory. You can also get a temporary license to test all the features.

    Without a license the APIs run in evaluation mode and add trial watermarks to output.

  5. Run all examples

    npm start
    

    List every example, then run one on its own:

    node run_all_examples.js --list
    node run_all_examples.js --example ViewerRenderToHtml
    

    You can also run an individual example by navigating to the folder containing the example script and running it. Output files are placed in the same folder as the script file.

More Resources

Find additional details and examples in the GroupDocs.Total for Node.js via Java documentation.

We also offer GroupDocs.Total packages for other platforms: