[Bug]: browser.cjs does not recognize nullish coalescing operator on production

[SpencerIsTheKey]

What happened?

When moving from local dev to production server, laravel-pdf throws the following error when generating a test pdf:

'1'Symfony\Component\Process\Exception\ProcessFailedException: The command "PATH=$PATH:/usr/local/bin:/opt/homebrew/bin NODE_PATH=`npm root -g` node '/var/www/production-app/vendor/spatie/browsershot/src/../bin/browser.cjs' '{"url":"file:\/\/\/tmp\/993164535-0053870001747106342\/index.html","action":"pdf","options":{"path":"\/tmp\/1720122940-0050535001747106342\/test.pdf","args":["--no-sandbox"],"viewport":{"width":800,"height":600},"displayHeaderFooter":false,"timeout":240000,"printBackground":true}}'" failed.

Exit Code: 1(General error)

Working directory: /var/www/production-app

Output:
================


Error Output:
================
/var/www/production-app/vendor/spatie/browsershot/bin/browser.cjs:104
                protocolTimeout: request.options.protocolTimeout ?? 30000,
                                                                  ^

SyntaxError: Unexpected token '?'
    at wrapSafe (internal/modules/cjs/loader.js:915:16)
    at Module._compile (internal/modules/cjs/loader.js:963:27)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:1027:10)
    at Module.load (internal/modules/cjs/loader.js:863:32)
    at Function.Module._load (internal/modules/cjs/loader.js:708:14)
    at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:60:12)
    at internal/main/run_main_module.js:17:47
 in /var/www/production-app/vendor/spatie/browsershot/src/Browsershot.php:1115
Stack trace:
#0 /var/www/production-app/vendor/spatie/browsershot/src/Browsershot.php(721): Spatie\Browsershot\Browsershot->callBrowser()
#1 /var/www/production-app/vendor/spatie/browsershot/src/Browsershot.php(639): Spatie\Browsershot\Browsershot->savePdf()
#2 /var/www/production-app/vendor/spatie/laravel-pdf/src/PdfBuilder.php(265): Spatie\Browsershot\Browsershot->save()
#3 /var/www/production-app/vendor/spatie/laravel-pdf/src/PdfBuilder.php(241): Spatie\LaravelPdf\PdfBuilder->saveOnDisk()
#4 /var/www/production-app/app/Http/Services/PDFService.php(21): Spatie\LaravelPdf\PdfBuilder->save()
#5 /var/www/production-app/app/Jobs/TestJob.php(26): App\Http\Services\PDFService::generateTest()
#6 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(36): App\Jobs\TestJob->handle()
#7 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Container/Util.php(43): Illuminate\Container\BoundMethod::Illuminate\Container\{closure}()
#8 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(95): Illuminate\Container\Util::unwrapIfClosure()
#9 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(35): Illuminate\Container\BoundMethod::callBoundMethod()
#10 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Container/Container.php(696): Illuminate\Container\BoundMethod::call()
#11 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Bus/Dispatcher.php(126): Illuminate\Container\Container->call()
#12 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php(170): Illuminate\Bus\Dispatcher->Illuminate\Bus\{closure}()
#13 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php(127): Illuminate\Pipeline\Pipeline->Illuminate\Pipeline\{closure}()
#14 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Bus/Dispatcher.php(130): Illuminate\Pipeline\Pipeline->then()
#15 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Queue/CallQueuedHandler.php(126): Illuminate\Bus\Dispatcher->dispatchNow()
#16 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php(170): Illuminate\Queue\CallQueuedHandler->Illuminate\Queue\{closure}()
#17 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Pipeline/Pipeline.php(127): Illuminate\Pipeline\Pipeline->Illuminate\Pipeline\{closure}()
#18 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Queue/CallQueuedHandler.php(121): Illuminate\Pipeline\Pipeline->then()
#19 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Queue/CallQueuedHandler.php(69): Illuminate\Queue\CallQueuedHandler->dispatchThroughMiddleware()
#20 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Queue/Jobs/Job.php(102): Illuminate\Queue\CallQueuedHandler->call()
#21 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Queue/Worker.php(442): Illuminate\Queue\Jobs\Job->fire()
#22 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Queue/Worker.php(392): Illuminate\Queue\Worker->process()
#23 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Queue/Worker.php(335): Illuminate\Queue\Worker->runJob()
#24 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Queue/Console/WorkCommand.php(149): Illuminate\Queue\Worker->runNextJob()
#25 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Queue/Console/WorkCommand.php(132): Illuminate\Queue\Console\WorkCommand->runWorker()
#26 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(36): Illuminate\Queue\Console\WorkCommand->handle()
#27 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Container/Util.php(43): Illuminate\Container\BoundMethod::Illuminate\Container\{closure}()
#28 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(95): Illuminate\Container\Util::unwrapIfClosure()
#29 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(35): Illuminate\Container\BoundMethod::callBoundMethod()
#30 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Container/Container.php(696): Illuminate\Container\BoundMethod::call()
#31 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Console/Command.php(213): Illuminate\Container\Container->call()
#32 /var/www/production-app/vendor/symfony/console/Command/Command.php(279): Illuminate\Console\Command->execute()
#33 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Console/Command.php(182): Symfony\Component\Console\Command\Command->run()
#34 /var/www/production-app/vendor/symfony/console/Application.php(1094): Illuminate\Console\Command->run()
#35 /var/www/production-app/vendor/symfony/console/Application.php(342): Symfony\Component\Console\Application->doRunCommand()
#36 /var/www/production-app/vendor/symfony/console/Application.php(193): Symfony\Component\Console\Application->doRun()
#37 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Foundation/Console/Kernel.php(198): Symfony\Component\Console\Application->run()
#38 /var/www/production-app/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1235): Illuminate\Foundation\Console\Kernel->handle()
#39 /var/www/production-app/artisan(13): Illuminate\Foundation\Application->handleCommand()
#40 {main}

No changes between production and local dev config

How to reproduce the bug

A job calls a service, which calls the Pdf::view() function.

Library call:

Pdf::view('testPDF')
        ->withBrowsershot(function (Browsershot $browsershot){
          $browsershot->timeout(240);
          $browsershot->noSandbox();
        })
        ->disk('sharepoint')->save('program/test.pdf');

testPDF.blade.php:

<!DOCTYPE HTML>
<div>
TESTING PDF SAVING
</div>

Package Version

1.5.5

PHP Version

8.3.20

Laravel Version

11.44.0

Which operating systems does with happen with?

Linux

Notes

Followed the steps to resolve similar issues to no solution. Setting noSandbox() did not prevent the error, and the only thing manually setting the node and npm paths did was change the command from

"PATH=$PATH:/usr/local/bin:/opt/homebrew/bin NODE_PATH=`npm root -g` node '/var/www/production-app/vendor/spatie/browsershot/src/../bin/browser.cjs' '{"url":"file:\/\/\/tmp\/993164535-0053870001747106342\/index.html","action":"pdf","options":{"path":"\/tmp\/1720122940-0050535001747106342\/test.pdf","args":["--no-sandbox"],"viewport":{"width":800,"height":600},"displayHeaderFooter":false,"timeout":240000,"printBackground":true}}'"

to

"PATH=$PATH:/usr/local/bin:/opt/homebrew/bin NODE_PATH=`/usr/bin/node /usr/bin/npm root -g` /usr/bin/node '/var/www/production-app/vendor/spatie/browsershot/src/../bin/browser.cjs' '{"url":"file:\/\/\/tmp\/472083338-0158386001747108022\/index.html","action":"pdf","options":{"path":"\/tmp\/883966702-0155035001747108022\/test.pdf","args":["--no-sandbox"],"viewport":{"width":800,"height":600},"displayHeaderFooter":false,"timeout":240000,"printBackground":true}}'"

[SpencerIsTheKey]

My bad, my job environment was running Node v12.22 and the node version I pointed it to was the same executable the process found automatically. I found the path to the correct version, and had to install chromium manually. Still having an issue that I'm not sure how to solve...

In the boot method of my AppServiceProvider.php, I define the defaults for the laravel-pdf like so:

Pdf::default()
        ->withBrowsershot(function (Browsershot $browsershot){
          $browsershot->setNodeBinary(env('NODE_PATH'));
          $browsershot->setChromePath(env('CHROME_PATH'));
          $browsershot->noSandbox();
          $browsershot->setCustomTempPath(storage_path('app/temp'));
          $browsershot->timeout(240);
        })->disk('sharepoint');

but when creating a PDF, I get a Error: net::ERR_FILE_NOT_FOUND at file:///var/www/production-app/storage/app/temp/389260074-0162015001747112630/index.html. The file created by laravel-pdf for this has permissions level of 644, so the program should be able to read it but isn't able to find it

[SpencerIsTheKey]

Turns out the answer was pretty simple. I had installed the snap version of chromium, which is more restricted in the files it can access than the deb version.

I solved this by removing the snap version of chromium, installing the deb version, and updating my CHROME_PATH environment variable for the new executable.

sudo snap remove chromium

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install ./google-chrome-stable_current_amd64.deb

CHROME_PATH="/usr/bin/google-chrome"

[SpencerIsTheKey]

So to summarize, the original issue was that the queue workers were using an old version of Node.

To fix that, I used the default() function to make sure that every instance of Pdf uses the correct node version which I found using which node.

This resulted in the following error:

Error: Could not find Chrome (ver. 136.0.7103.92). This can occur if either
 1. you did not perform an installation before running the script (e.g. `npx puppeteer browsers install chrome-headless-shell`) or
 2. your cache path is incorrectly configured (which is: /root/.cache/puppeteer).
For (2), check out our guide on configuring puppeteer at https://pptr.dev/guides/configuration.

Which I resolved by manually installing chromium with sudo apt install -y chromium-browser, which was a mistake and resulted in the ERR_FILE_NOT_FOUND error mentioned above.

The issue was fully resolved by removing the snap version of chromium browser, installing the deb version, and pointing laravel-pdf at the new executable.

sudo snap remove chromium

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install ./google-chrome-stable_current_amd64.deb

CHROME_PATH="/usr/bin/google-chrome"