puppeteer@25.14.0

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

AI Security Review

scanned 11d ago · by lpm-firewall-ai

Source inspection ties the postinstall hook to supported browser installation and the CLI to browser management. The inspected entrypoints and configuration reveal no concrete attack behavior.

Static reason

One or more suspicious static signals were detected.

Trigger

Package installation runs the postinstall hook; browser management runs when a user invokes the CLI.

Impact

The inspected behavior sets up browsers for Puppeteer automation; no confirmed attack effect was established.

Mechanism

The hook calls Puppeteer’s browser installer with browser and cache configuration, with a configured skip-download setting that returns before installation.

AI rationale

Source inspection ties the postinstall hook to supported browser installation and the CLI to browser management. The inspected entrypoints and configuration reveal no concrete attack behavior.

Decision evidence

public snapshot

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

Evidence for AI clean decision

The manifest’s postinstall hook runs the package’s install script.
The install script calls Puppeteer’s browser download routine.
The routine invokes the browser installer with a browser, cache directory, and build identifier.
The installer returns early when the configured global download-skip setting is enabled.
The main module exports the Puppeteer Core API and initializes package configuration.
The CLI delegates browser management to a browser-focused command using Puppeteer’s configured cache.

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

8 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"

Low

Suspicious Lifecycle Evidence

The manifest’s postinstall hook runs the package’s install script.

package.jsonView on unpkg · L42

46 },

47 "wireit": {

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-57javascript

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/puppeteer.jsView file

Lines 1-26javascript

1/**

2 * @license

4 * SPDX-License-Identifier: Apache-2.0

5 */

6export * from 'puppeteer-core';

7import { PuppeteerNode } from 'puppeteer-core'

lib/puppeteer/node/cli.jsView file

Lines 1-32javascript

1#!/usr/bin/env node

2/**

3 * @license

5 * SPDX-License-Identifier: Apache-2.0

6 */

7import { CLI, Browser } from '@puppeteer/browsers';

8import { PUPPETEER_REVISIONS } from

Source & flagged code

8 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": "

Low

Suspicious Lifecycle Evidence

The manifest’s postinstall hook runs the package’s install script.

package.jsonView on unpkg · L42

install.mjsView file

Findings

1 High2 Medium8 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/puppeteer.js

LowAi Review Evidencelib/puppeteer/node/cli.js

Affected versions and remediation

This report applies to puppeteer@25.14.0.

See all versions of puppeteer for other recorded verdicts.

Review the evidence and your use of puppeteer@25.14.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 15:37:06.536Z (UTC).

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