Implementation:Puppeteer Puppeteer ResolveBuildId

Knowledge Sources	Puppeteer
Domains	Browser_Management, Version_Control
Last Updated	2026-02-11 23:00 GMT

Overview

Concrete tool for resolving browser version tags to specific build IDs, provided by the @puppeteer/browsers package.

Description

The resolveBuildId() function resolves a browser release tag to a concrete build ID. It dispatches to browser-specific resolution functions that may query remote APIs (Chrome for Testing endpoints, Firefox version APIs) or return the tag directly if it is already a version string.

Usage

Call this function before install() to obtain a build ID from a channel tag.

Code Reference

Source Location

• Repository: puppeteer
• File: packages/browsers/src/browser-data/browser-data.ts
• Lines: 168-203

Signature

async function resolveBuildId(
  browser: Browser,
  platform: BrowserPlatform,
  tag: string | BrowserTag,
): Promise<string>;

Import

import {resolveBuildId, Browser, BrowserPlatform} from '@puppeteer/browsers';

I/O Contract

Inputs

Name	Type	Required	Description
browser	Browser	Yes	Browser enum: 'chrome', 'firefox', 'chromium', 'chromedriver', 'chrome-headless-shell'
platform	BrowserPlatform	Yes	Target platform enum
tag	string or BrowserTag	Yes	Version tag: 'stable', 'canary', 'latest', 'beta', 'dev', or specific version string

Outputs

Name	Type	Description
return	Promise<string>	Resolved build ID string (e.g., "131.0.6778.33" for Chrome stable)

Usage Examples

import {resolveBuildId, Browser, detectBrowserPlatform} from '@puppeteer/browsers';

const platform = detectBrowserPlatform();
const buildId = await resolveBuildId(Browser.CHROME, platform, 'stable');
console.log(`Chrome stable build ID: ${buildId}`);

Related Pages

Implements Principle

• Principle:Puppeteer_Puppeteer_Browser_Version_Resolution