Skip to content

docs: add SOP for 'options.recursive' failure occurring in latest Zen…#272

Open
lokeshyerneni wants to merge 1 commit intozen-browser:mainfrom
lokeshyerneni:main
Open

docs: add SOP for 'options.recursive' failure occurring in latest Zen…#272
lokeshyerneni wants to merge 1 commit intozen-browser:mainfrom
lokeshyerneni:main

Conversation

@lokeshyerneni
Copy link
Copy Markdown

Node 25 incompatibility: options.recursive no longer supported during branding patch

Description

When running the Zen Browser desktop setup with Node.js v25, the build fails during the branding patch step with the following error:

TypeError [ERR_INVALID_ARG_VALUE]: The property 'options.recursive' is no longer supported. Received true

Stack Trace (trimmed)

Object.convert (node_modules/async-icns/icns.js:108:9)
async setupImages (node_modules/@zen-browser/surfer/dist/commands/patches/branding-patch.js:109:5)
async Object.apply (node_modules/@zen-browser/surfer/dist/commands/patches/branding-patch.js:243:3)

Reproduction Steps

  1. Install Node.js v25
  2. Follow the documentation from Steps 1 to Steps 3
  3. Observe failure during branding patch step

Expected Behavior

The build process completes successfully.

Actual Behavior

The process exits with:

TypeError [ERR_INVALID_ARG_VALUE]: The property 'options.recursive' is no longer supported. Received true

Environment

  • Node.js: v25.x
  • Also tested working on: Node.js v22.x (LTS)
  • OS: macOS

Workaround

Downgrading to Node.js v22 resolves the issue.

Suspected Cause

Based on first glance, this appears to originate from async-icns using deprecated Node.js fs APIs (e.g. fs.rmdir(..., { recursive: true })), which have been removed in Node.js v25.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant