„Vercel“ diegimo „Puppeteer Chrome“ klaidos „Nepavyko rasti Chrome (ver. 130.0.6723.116)“ taisymas

Kodėl jūsų „Puppeteer“ diegimas nepavyksta „Vercel“ (ir kaip tai ištaisyti)

Žiniatinklio nuskaitymo arba ekrano kopijų įrankio paleidimas vietinėje sąrankoje paprastai vyksta sklandžiai, kol ateina laikas jį įdiegti. Neseniai susidūriau su šia problema bandydamas paleisti savo scenarijus įjungtas . 🚀 Nors mano vietiniame kompiuteryje viskas veikė puikiai, „Vercel“ diegimas vis grąžindavo klaidą: .

Ši klaida gali būti varginanti, ypač todėl, kad ji nerodoma atliekant vietinius bandymus. Problema paprastai rodo, kad įdiegtoje aplinkoje trūksta naršyklės versijos arba netinkama jos konfigūracija kad Puppeteer naudoja Vercel.

Pagal numatytuosius nustatymus „Vercel“ ne visada apima konkretų „Chrome“ vykdomąjį failą, kurio reikalauja „Puppeteer“, o tai reiškia, kad scenarijus gali jo nerasti vykdymo metu. Šiame vadove bus paaiškinta, kodėl įvyksta ši klaida, ir kai kurios strategijos, kaip ją išspręsti.

Nesvarbu, ar esate Puppeteer kūrėjas, ar tiesiog šalinate diegimo triktis, suprasdami šiuos niuansus galite sutaupyti valandų derinimo. 🛠️ Pasinerkime į sprendimą ir jūsų „Puppeteer“ sąranka „Vercel“ veiktų sklandžiai.

komandą	Naudojimo pavyzdys ir išsamus aprašymas
puppeteer.launch({ ... })	Ši komanda paleidžia „Puppeteer“ egzempliorių su konkrečiomis konfigūravimo parinktimis, tokiomis kaip ignoreHTTPSErrors ir executablePath. Šios parinktys padeda išspręsti „Chrome“ versijų klaidas tokiose diegimo platformose kaip „Vercel“, nustatant tikslią „Chrome“ vykdomojo failo vietą ir tvarkant saugos nustatymus.
executablePath	Naudojamas puppeteer.launch, executablePath nurodo kelią į „Chrome“ dvejetainį failą. Nustačius šį kelią, „Puppeteer“ nuotoliniuose serveriuose naudoja tinkamą „Chrome“ versiją, o tai būtina aplinkose be serverių, pvz., „Vercel“, kur „Chrome“ gali būti neįdiegta pagal numatytuosius nustatymus.
args: ['--no-sandbox', '--disable-setuid-sandbox']	Šios vėliavėlės išjungia „Chrome“ smėlio dėžės funkciją, kuri būtina, kad „Puppeteer“ veiktų daugelyje debesų prieglobos paslaugų teikėjų. Smėlio dėžė paprastai išjungiama, kad būtų išvengta leidimų klaidų bendrinamuose serveriuose, tačiau tai turėtų būti daroma atsargiai dėl saugumo pasekmių.
cacheDirectory	„Puppeteer“ konfigūracijos faile „cacheDirectory“ nustato pasirinktinį katalogą, skirtą naršyklės talpyklai saugoti. Tai ypač naudinga „Vercel“, nes leidžia valdyti, kur „Puppeteer“ saugo atsisiųstus „Chrome“ dvejetainius failus, taip išvengiant klaidų, susijusių su talpykla.
await page.goto(url, { waitUntil: 'networkidle2' })	Ši komanda įkelia URL ir laukia, kol bus ne daugiau kaip du tinklo ryšiai, kad puslapis būtų laikomas visiškai įkeltu. „Networkidle2“ parinktis užtikrina, kad visi ištekliai būtų įkelti prieš darant ekrano kopiją, todėl ji idealiai tinka sudėtingiems puslapiams užfiksuoti.
page.setViewport({ width: 1920, height: 1080 })	Nustatomi „Chrome“ egzemplioriaus peržiūros srities matmenys, imituojant nurodyto dydžio ekraną. Tai būtina ekrano kopijoms ir vizualiniam testavimui, nes ji kontroliuoja užfiksuoto tinklalapio išvaizdą.
path.join(__dirname, '..', 'public', fileName)	Ši komanda sukuria failo kelią, sujungdama dabartinį katalogą su viešuoju aplanku, sukurdama konkretų katalogą ekrano kopijoms saugoti. Tai būtina tvarkant išvesties failus, ypač teikiant ekrano kopijos kelią atgal klientui.
uuid()	Kiekvienai ekrano kopijai sukuriamas unikalus identifikatorius, užtikrinantis, kad kiekvieno failo pavadinimas būtų unikalus ir išvengta perrašymų. Ši funkcija ypač naudinga programoms, kurios vienu metu saugo kelis vaizdus arba duomenų failus.
chai.request(app)	Ši komanda, kuri yra Chai HTTP modulio dalis, siunčia užklausą programų serveriui (apibrėžiamai kaip programa), kad patikrintų galutinio taško atsakymus. Tai naudinga atliekant automatinį testavimą, leidžiantį kūrėjams patikrinti, ar ekrano kopijos API veikia taip, kaip tikėtasi.
describe() and it()	Šios Mocha testavimo funkcijos apibrėžia testų rinkinius (aprašo ()) ir atskirus testus (it ()), skirtus funkcionalumui patvirtinti. Jie naudojami siekiant patvirtinti, kad kiekvienas Puppeteer ekrano kopijos API aspektas veikia tinkamai įvairiomis sąlygomis – nuo ​​trūkstamų parametrų iki galiojančių URL.

„Puppeteer“ „Chrome“ klaidos įveikimas diegiant „Vercel“.

Pateikiamas pagrindinis scenarijus yra užpakalinė funkcija, kuri naudoja kad užfiksuotumėte vartotojo pateikto URL ekrano kopiją. Ši užduotis ypač naudinga dinamiškai generuojant peržiūras arba žiniatinklio rinkimo tikslais. Tačiau diegimas tokiose platformose kaip gali sukelti klaidų, pvz., aplinkoje „Chrome“ nerasta. Taip nutinka todėl, kad „Vercel“ nėra su iš anksto įdiegta „Chrome“ numatytoje vietoje, o tai reiškia, kad „Puppeteer“ turi būti sukonfigūruotas, kad surastų arba įdiegtų tinkamą versiją. Savo pavyzdyje įdiegėme parinktis, kaip nurodyti „Puppeteer“ vykdomąjį kelią į tinkintą „Chrome“ dvejetainį failą ir tvarkyti SSL problemas naudodami žymą ignoreHTTPSErrors, kad įsitikintume, jog sąranka veikia įvairiose aplinkose.

Scenarijus pradedamas apibrėžiant ekrano kopijos funkciją, kuri paima URL iš užklausos. Jei URL trūksta, jis siunčia JSON klaidos atsakymą, bet jei pateikiamas, jis inicijuoja „Puppeteer“ su būtinomis konfigūracijomis, pvz., ir parinktys. The yra būtinas, nes jis nukreipia „Puppeteer“ į tikslią „Chrome“ vietą, išspręsdamas „Vercel“ klaidą „Nepavyko rasti Chrome“. Be to, args pasirinkimai, konkrečiai ir , išjunkite „Chrome“ smėlio dėžės funkciją – reikalavimą tam tikroms aplinkoms be serverio. Šie nustatymai užtikrina, kad scenarijus gali būti vykdomas nepatiriant leidimo problemų Vercel valdomoje infrastruktūroje.

Paleidus Puppeteer, scenarijus atidaro naują naršyklės puslapį ir naudoja su variantas. Tai nurodo „Puppeteer“ palaukti, kol puslapis bus visiškai įkeltas ir ne daugiau kaip dvi nuolatines tinklo užklausas, užtikrinant, kad net sudėtingi puslapiai būtų visiškai atvaizduojami prieš darant ekrano kopiją. Šis veiksmas yra labai svarbus norint užfiksuoti patikimą ir tikslią ekrano kopiją, ypač tvarkant šiuolaikinius tinklalapius, kurie dažnai labai priklauso nuo asinchroninio įkėlimo. Tada peržiūros srities dydis nustatomas į 1920 x 1080, imituojant Full HD ekraną, o tai garantuoja, kad užfiksuotas turinys atspindės išdėstymą, kurį dauguma vartotojų matytų staliniame įrenginyje.

Galiausiai, scenarijus sugeneruoja unikalų failo pavadinimą naudodamas biblioteka, išsaugodama ekrano kopiją viešajame kataloge, kur ją galima pasiekti ir grąžinti vartotojui kaip JSON atsakymą. Kruopščiai struktūrizuodami failų kelius naudodami „Node“. metodas, scenarijus išvengia failo kelio problemų, kurios gali kilti dėl aplinkos nustatymų skirtumų. Pavyzdžiui, nors ši struktūra sklandžiai veikia vietiniame kompiuteryje, tie patys keliai gali neveikti Vercel, todėl labai svarbu kiekvieną failo kelią apibrėžti moduliniu ir pritaikomu būdu. Galiausiai ši sąranka užtikrina, kad „Puppeteer“ funkcija sklandžiai veiktų tiek vietinėje, tiek be serverio aplinkoje, tvarkydama visus pagrindinius aspektus, pvz., puslapio įkėlimą, klaidų tvarkymą ir aplinkos apribojimus. 🖥️

const puppeteer = require('puppeteer');
const path = require('path');
const { v4: uuid } = require('uuid');
const fs = require('fs');

// Main screenshot function
const screenshot = async (req, res) => {
    const url = req.query.url;
    if (!url) {
        return res.status(400).json({ message: 'URL is required' });
    }

    let browser;
    try {
        // Launch Puppeteer with specific Chrome executable path and options
        browser = await puppeteer.launch({
            ignoreHTTPSErrors: true,
            executablePath: process.env.CHROME_PATH || '/opt/bin/chromium',
            args: ['--no-sandbox', '--disable-setuid-sandbox']
        });

        const page = await browser.newPage();
        await page.goto(url, { waitUntil: 'networkidle2' });
        await page.setViewport({ width: 1920, height: 1080 });

        const fileName = \`${uuid()}.png\`;
        const screenshotPath = path.join(__dirname, '..', 'public', fileName);
        await page.screenshot({ path: screenshotPath });

        res.json({ screenshotPath: \`/image/\${fileName}\` });
    } catch (err) {
        console.error('Error capturing screenshot:', err);
        res.status(500).json({ error: 'Failed to capture screenshot' });
    } finally {
        if (browser) await browser.close();
    }
};

module.exports = screenshot;

const { join } = require('path');

/
 * @type {import('puppeteer').Configuration}
 */
module.exports = {
    // Specify cache directory for Puppeteer
    cacheDirectory: join(__dirname, '.cache', 'puppeteer'),
    // Specify which Chromium version Puppeteer should install
    executablePath: '/opt/bin/chromium',
    args: ['--no-sandbox', '--disable-setuid-sandbox'],
};

// Add to package.json
"scripts": {
    "postinstall": "npx puppeteer install --path ./.cache/puppeteer",
    "start": "node index.js"
}

// Configure environment variable in Vercel
process.env.CHROME_PATH = "/opt/bin/chromium";

const chai = require('chai');
const chaiHttp = require('chai-http');
const app = require('../app'); // Express app where screenshot endpoint is defined

chai.use(chaiHttp);
const expect = chai.expect;

describe('Screenshot API', () => {
    it('should return an error for missing URL parameter', (done) => {
        chai.request(app)
            .get('/screenshot')
            .end((err, res) => {
                expect(res).to.have.status(400);
                expect(res.body).to.have.property('message').eql('URL is required');
                done();
            });
    });

    it('should capture a screenshot successfully for a valid URL', (done) => {
        chai.request(app)
            .get('/screenshot?url=https://example.com')
            .end((err, res) => {
                expect(res).to.have.status(200);
                expect(res.body).to.have.property('screenshotPath');
                done();
            });
    });
});

„Puppeteer“ optimizavimas debesų aplinkai

Diegiant Puppeteer pagrįstas programas debesų platformose, pvz arba , labai svarbu suprasti šios aplinkos apribojimus. Skirtingai nuo vietinių sąrankų, debesų aplinkos paprastai veikia valdomose arba be serverio architektūrose, o tai reiškia, kad tokios priklausomybės kaip „Chrome“ ne visada yra lengvai pasiekiamos. Tiesą sakant, lėlininko metodas gali nepavykti, jei reikiama „Chrome“ versija neįdiegta serveryje, todėl gali atsirasti klaidų, pvz., „Nepavyko rasti Chrome“. Gera praktika yra nurodyti „Chrome“ vykdomąjį kelią naudojant executablePath, nes tai užtikrina, kad „Puppeteer“ gali efektyviai rasti ir paleisti „Chrome“ bet kurioje aplinkoje.

Be to, norint užtikrinti suderinamumą, labai svarbu pridėti būtinų paleidimo argumentų. Vėliavos, pvz ir yra ypač naudingi. Nors šios žymos išjungia kai kurias „Chrome“ saugos funkcijas, jos dažnai būtinos nustatant be serverio, kai „Chrome“ smėlio dėžė nepalaikoma. Be to, nurodant pasirinktinį talpyklos katalogą naudojant Puppeteer's parinktis padeda išvengti galimų talpyklos problemų, ypač kai naudojamos kelios naršyklės versijos. Pavyzdžiui, nustatymas cacheDirectory į žinomą katalogą užtikrina, kad visos priklausomybės būtų pasiekiamos vykdymo metu.

Galiausiai, optimizuoti metodas gali labai pagerinti našumą. Naudodami parinktį, scenarijus laukia, kol puslapis bus baigtas įkelti, o tai labai svarbu aplinkose, kuriose interneto greitis arba išteklių įkėlimas skiriasi. Tai ypač naudinga fiksuojant tikslias ekrano kopijas dinaminiuose puslapiuose arba programose, kur turinys įkeliamas asinchroniškai. Šių metodų derinys leidžia „Puppeteer“ sklandžiai veikti debesų platformose ir siūlo galingą automatizuotų užduočių sprendimą gamyboje. 🚀

1. Kodėl debesies platformose rodomos klaidos „Nepavyko rasti Chrome“?
2. Šios klaidos dažnai atsiranda dėl to, kad pagal numatytuosius nustatymus debesų platformose nėra visos „Chrome“ dvejetainės programos. Tai galite išspręsti nurodydami „Puppeteer“ sąrankoje.
3. Kaip užtikrinti, kad „Puppeteer“ veiktų tiek vietinėje, tiek debesų aplinkoje?
4. Naudojant ir su debesims draugiškomis vėliavėlėmis kaip gali padaryti jūsų sąranką pakankamai lanksčią abiem aplinkoms.
5. Ką daro vėliavą padaryti lėlėje?
6. The vėliavėlė išjungia „Chrome“ smėlio dėžės saugą, kuri leidžia „Puppeteer“ veikti debesies paslaugose, kurios nepalaiko smėlio dėžės, tačiau ją reikia naudoti atsargiai.
7. Kodėl man reikia papročio už Puppeteer?
8. Tinkinimo nustatymas užtikrina, kad „Puppeteer“ atsisiųstų „Chrome“ dvejetainius failus į žinomą vietą, o tai gali užkirsti kelią klaidoms diegiant, ypač aplinkoje be serverio.
9. Koks yra tikslas parinktis metodas?
10. The parinktis laukia, kol bus ne daugiau kaip du aktyvūs tinklo ryšiai. Tai naudinga fiksuojant visiškai įkeltą puslapį ir tvarkant dinaminį turinį.
11. Ar „Puppeteer“ gali veikti be nurodytos „Chrome“ versijos?
12. Taip, bet rekomenduojama nurodyti ir užtikrinti, kad būtų pasiekiama suderinama „Chrome“ versija, kad debesies sąrankos rezultatai būtų nuoseklūs.
13. Kaip valdyti „Puppeteer“ talpyklą įvairiose aplinkose?
14. Galite nurodyti universalų esančiame failą, leidžiantį „Puppeteer“ rasti „Chrome“ dvejetainius failus tokiose platformose kaip „Vercel“ ir „Heroku“.
15. Is skiriasi nuo ?
16. taip, neapima „Chrome“, kad sumažintumėte dydį, todėl turėsite nurodyti „Chrome“ dvejetainį failą. Pilnas Į paketą automatiškai įtraukta „Chrome“.
17. Ką daryti, jei „Puppeteer“ veikia lėtai debesų aplinkoje?
18. Optimizavimas nustatymus ir išjungti nereikalingas parinktis, pvz gali pagerinti našumą ribotų išteklių aplinkoje.
19. Ar „Puppeteer“ suderinamas su visais debesų paslaugų teikėjais?
20. Paprastai taip, bet kiekvienas teikėjas gali turėti unikalių reikalavimų. Naudojant debesims pritaikytus nustatymus, pvz užtikrina geresnį suderinamumą.

Norint sėkmingai įdiegti „Puppeteer“ sistemoje „Vercel“, reikia suprasti konkrečius „Chrome“ sąrankos poreikius. Nurodant ir tinkamai sukonfigūravus „Puppeteer“ talpyklos kelius, išvengiama varginančios klaidos „Nepavyko rasti Chrome“. Šie koregavimai užtikrina, kad „Puppeteer“ veiktų patikimai tiek vietinėje, tiek debesų aplinkoje. 🚀

Pritaikius šiuos sprendimus savo projektui, ekrano kopijų fiksavimas iš vartotojo pateiktų URL tampa sklandus ir leidžia kurti dinamiškesnes žiniatinklio programas. Tinkamai sukonfigūravus, „Puppeteer“ išlieka neįkainojama automatizavimo ir žiniatinklio rinkimo įrankiu, net ir tokiose platformose be serverių kaip „Vercel“.