puppeteer@25.13.0

A high-level API to control headless Chrome over the DevTools Protocol

AI Security Review

scanned 12d ago · by lpm-firewall-ai

The postinstall behavior is browser setup for Puppeteer and honors its download configuration. The inspected entrypoints showed no separate attack behavior.

Static reason

One or more suspicious static signals were detected.

Trigger

Package installation runs the postinstall script.

Impact

No harmful impact was established from the inspected source.

Mechanism

The script invokes Puppeteer’s configured browser installer, which installs browser builds into its cache.

AI rationale

The postinstall behavior is browser setup for Puppeteer and honors its download configuration. The inspected entrypoints showed no separate attack behavior.

Decision evidence

public snapshot

AI called this Clean at 96.0% confidence as Benign with low false-positive risk.

Evidence for AI clean decision

package.json defines postinstall as node install.mjs.
install.mjs invokes Puppeteer’s browser download routine.
The routine reads configuration, honors the skip-download setting, and schedules browser installation.
The installer passes browser, cache directory, platform, and build ID to the browser installer.
The public entrypoint re-exports puppeteer-core and creates a PuppeteerNode instance.

Evidence against

Behavioral surface

Source

EnvironmentVars

Supply chain

HighEntropyStrings

ManifestNo manifest risk signals triggered.

scanned 9 file(s), 23.0 KB of source

Source & flagged code

9 flagged

package.jsonView file

Lines 22-62json

22 "./internal/*": {

23 "import": "./lib/puppeteer/*",

24 "require": "./lib/puppeteer/*"

25 },

26 "./*": {

27 "import": "./*",

28 "require": "./*"

29 }

30 },

31 "repository": {

32 "type": "git",

33 "url": "https://github.com/puppeteer/puppeteer/tree/main/packages/puppeteer"

34 },

35 "engines": {

36 "node": ">=22.12.0"

37 },

38 "scripts": {

39 "build:docs": "wireit",

40 "build": "wireit",

41 "clean": "../../tools/clean.mjs",

42 "postinstall": "node install.mjs",

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L42

Medium

Ambiguous Install Lifecycle Script

Install-time lifecycle script is not statically allowlisted and needs review.

package.jsonView on unpkg · L42

43 "prepack": "wireit",

44 "unit": "wireit",

45 "unit:only": "wireit"

46 },

47 "wireit": {

Low

Suspicious Lifecycle Evidence

package.json defines postinstall as node install.mjs.

package.jsonView on unpkg · L42

48 "prepack": {

49 "command": "node --experimental-strip-types ../../tools/cp.ts ../../README.md README.md",

50 "files": [

51 "../../README.md"

52 ],

53 "output": [

54 "README.md"

55 ]

56 },

57 "build": {

58 "dependencies": [

59 "build:tsc",

60 "build:types"

61 ]

62 },

install.mjsView file

Lines 19-44javascript

19/**

20 * @returns {import("puppeteer/internal/node/install.js")}

21 */

22async function importInstaller() {

23 try {

24 return await import(

lib/puppeteer/node/install.jsView file

Lines 1-72javascript

1/**

2 * @license

4 * SPDX-License-Identifier: Apache-2.0

5 */

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

7import { PUPPETEER_REVISIONS } from 'puppeteer-core/internal/revisions.js';

lib/puppeteer/getConfiguration.jsView file

Lines 95-132javascript

95 '.config/puppeteerrc',

96 '.puppeteerrc.cjs',

97 '.puppeteerrc.js',

98 '.puppeteerrc.json',

99 '.puppeteerrc',

100 'puppeteer.config.cjs',

101

lib/puppeteer/puppeteer.jsView file

6export * from 'puppeteer-core'; import { PuppeteerNode } from 'puppeteer-core'; import { getConfiguration } from './getConfiguration.js'; /** * @public */ // @ts-expect-error usi

Low

Ai Review Evidence

The public entrypoint re-exports puppeteer-core and creates a PuppeteerNode instance.

lib/puppeteer/puppeteer.jsView on unpkg · L6

Source & flagged code

9 flagged · loading source

package.jsonView file

•scripts.postinstall = node install.mjs

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

•scripts.postinstall = node install.mjs

Medium

Ambiguous Install Lifecycle Script

Install-time lifecycle script is not statically allowlisted and needs review.

package.jsonView on unpkg

42"postinstall": "node install.mjs", "prepack": "wireit", "unit": "wireit", "unit:only": "wireit" }, "wire

Low

Suspicious Lifecycle Evidence

package.json defines postinstall as node install.mjs.

package.jsonView on unpkg · L42

install.mjsView file

Findings

1 High2 Medium9 Low

HighInstall Time Lifecycle Scriptspackage.json

MediumAmbiguous Install Lifecycle Scriptpackage.json

MediumEnvironment Vars

LowScripts Present

LowHigh Entropy Strings

LowSuspicious Lifecycle Evidencepackage.json

LowAi Review Evidenceinstall.mjs

LowAi Review Evidencelib/puppeteer/node/install.js

LowAi Review Evidencelib/puppeteer/getConfiguration.js

LowAi Review Evidencelib/puppeteer/node/install.js

LowAi Review Evidencelib/puppeteer/puppeteer.js

Affected versions and remediation

This report applies to puppeteer@25.13.0.

See all versions of puppeteer for other recorded verdicts.

Review the evidence and your use of puppeteer@25.13.0 before allowing it. Restrict the permissions described in this report.
Choose an independently verified alternative or release. This report does not establish that other versions are safe.

Evidence last updated: 2026-10-14 04:28:09.840Z (UTC).

Think this verdict is wrong? Dispute it on GitHub or read how reports are produced.