temurin-jdk-downloader

A Node.js utility library for downloading, extracting, and auto-discovering Eclipse Adoptium Temurin (OpenJDK) binary releases from GitHub. Supports robust file downloading (with progress and timeouts), ZIP extraction, and Java executable detection for Windows systems.

Features

• Automatic download of the latest matching Temurin (OpenJDK) Windows ZIP distribution (e.g., 8, 11, 17, 21, 25, and more).
• Progress-aware file download (with timeout, error handling, and redirect support).
• In-memory ZIP extraction with full folder structure preserved.
• Auto-detects java.exe path (for setting JAVA_HOME in CI or local setup).
• Simple async APIs and no binary dependencies.

Installation

npm install temurin-jdk-downloader

Note: This package is intended for use in Windows environments and downloads x64 Windows JDK zip archives.

Usage

Download and Install OpenJDK with Auto-Detection

const { downloadTemurinJDK } = require('temurin-jdk-downloader');

(async () => {
  // Download and extract Temurin JDK 21 to the specified folder
  const { version, javaPath, binPath } = await downloadTemurinJDK({
    version: 21,
    targetExtractDir: 'C:/jdk-installs',
  });

  console.log(`JDK Version: ${version}`);
  console.log(`java.exe Path: ${javaPath}`);
  console.log(`bin Path: ${binPath}`);
})();

• Installs into: C:/jdk-installs/temurin21-binaries
• Finds bin/java.exe automatically.

Download a File with Progress

const { downloadFile } = require('temurin-jdk-downloader');

await downloadFile(
  'https://example.com/file.zip',
  'C:/temp/file.zip',
  {
    timeout: 60000,
    onProgress: (percent, downloadedBytes, totalBytes) =>
      console.log(percent + '%'),
  }
);

Extract a ZIP Archive

const { extractZip } = require('temurin-jdk-downloader');
await extractZip('C:/temp/openjdk.zip', 'C:/jdk-unpacked');

Find a Java Executable

const { findJavaExe } = require('temurin-jdk-downloader');
const javaPath = findJavaExe('C:/jdk-installs/temurin21-binaries');

Lookup Direct Download URL for a JDK (Advanced)

const { getTemurinBinaryURL } = require('temurin-jdk-downloader');
const url = await getTemurinBinaryURL('temurin17-binaries');
console.log(url);
// -> https://github.com/adoptium/temurin17-binaries/...

API Reference

downloadTemurinJDK({ version, targetExtractDir })

Download, extract, and auto-discover the JDK for the given version.

• version (number): Desired OpenJDK major version (defaults to 25 if omitted).
• targetExtractDir (string): Directory where the JDK archive will be extracted.

Returns: Promise<{ version: string|null, javaPath: string, binPath: string }>
Throws on unsupported versions or failures.

downloadFile(url, destPath, [options])

Robust downloader for HTTP/HTTPS files, with progress and timeout support.

• url (string): URL to download.
• destPath (string): Local file path to save.
• options (object):
  • timeout (number): Optional timeout in ms (default: 120000 = 2min).
  • onProgress (function): Optional callback: (percent, downloadedBytes, totalBytes) => {}

Returns: Promise<void>

extractZip(zipPath, extractTo)

Extracts all files from a ZIP archive.

• zipPath (string): Path to ZIP file.
• extractTo (string): Output directory.

Returns: Promise<void>

findJavaExe(baseDir)

Finds a java.exe inside the extracted JDK directory.

• baseDir (string): Path to the main JDK root folder.

Returns: string|null (absolute path to java.exe if found)

getTemurinBinaryURL(temurinBinary)

Resolves the download URL of the latest Windows ZIP from GitHub.

• temurinBinary (string): e.g. 'temurin21-binaries'

Returns: Promise<string|undefined>

Supported JDK Versions

• 8, 11, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25

Limitations

• Windows only: Downloads Windows x64 Hotspot OpenJDK binaries (.zip).
• Scrapes GitHub releases for latest builds (subject to website structure changes).
• Does not install system-wide or set environment variables—this is just extraction and discovery.
• Requires Node.js >= 14.

License

MIT

Credits

• Eclipse Adoptium for OpenJDK builds
• Inspired by CI/CD automation use cases

Pull requests and improvements are welcome!