Установка Node.js и npm

Puppeteer — это библиотека, основанная на Node.js, которая предоставляет API для управления браузером Chrome или Chromium через протокол DevTools. Для того чтобы начать работать с Puppeteer, необходимо установить Node.js, который включает в себя npm (менеджер пакетов), а также правильно настроить окружение для работы с Puppeteer.

  1. Установка Node.js

Node.js — это серверная среда выполнения JavaScript, построенная на движке V8, который используется в браузере Google Chrome. Установка Node.js — это первый шаг для работы с Puppeteer. Для этого потребуется выполнить несколько простых шагов.

  1. Перейти на официальный сайт Node.js.

  2. На главной странице доступны две версии Node.js:

    • LTS (Long Term Support) — версия с долгосрочной поддержкой, рекомендуется для большинства пользователей.
    • Current — версия с последними функциями и улучшениями. Обычно используется для разработки и тестирования новых возможностей.

    Для стабильной работы с Puppeteer рекомендуется выбирать версию LTS.

  3. После выбора нужной версии загрузить установочный файл для вашей операционной системы. Node.js поддерживает Windows, macOS и Linux.

    • Для Windows и macOS установочные файлы предоставляются в виде .msi и .pkg соответственно.
    • Для Linux предоставляются архивы и пакеты для различных дистрибутивов.

  4. После загрузки файла следует пройти через стандартный процесс установки:

    • Для Windows достаточно запустить .msi файл и следовать инструкциям установщика.
    • Для macOS достаточно запустить .pkg файл и следовать инструкциям.
    • Для Linux можно воспользоваться командой установки через пакетный менеджер, например, через apt для Ubuntu или brew для macOS.

  1. Проверка установки Node.js и npm

После установки Node.js можно убедиться в корректности установки, проверив версии Node.js и npm через командную строку или терминал. 

node -v
npm -v

Команда node -v вернет текущую версию Node.js, а команда npm -v — версию npm. Если версии отображаются корректно, значит установка прошла успешно.

  1. Установка Puppeteer

Теперь, когда Node.js и npm установлены, можно приступить к установке Puppeteer. Для этого нужно создать новый проект или использовать уже существующий.

  1. Перейдите в директорию вашего проекта через терминал или командную строку.
  2. Если проект новый, то инициализируйте его с помощью команды: 
npm init -y

Эта команда создаст файл package.json, который будет хранить все зависимости проекта.

  1. Установите Puppeteer с помощью команды: 
npm install puppeteer

Эта команда загрузит и установит Puppeteer и все необходимые зависимости.

  1. Проверка установки Puppeteer

После того как установка завершена, можно проверить, что библиотека установлена правильно. Для этого создайте файл, например, test.js, в котором будет находиться простой скрипт для запуска Puppeteer.

Пример кода: 

const puppeteer = require(&




(async () => { const browser = await puppeteer.launch(); const page =
await browser.newPage(); await page.goto('https://example.com'); await
page.screenshot({ path: 'example.png' }); await browser.close();
})();

Этот скрипт открывает браузер, переходит на страницу https://example.com, делает скриншот страницы и сохраняет его как example.png.

Запустите скрипт через терминал: 

node test.js

Если скриншот успешно сохранен, значит, Puppeteer работает корректно.

  1. Проблемы при установке и их решение

Во время установки Node.js или Puppeteer могут возникнуть различные проблемы, такие как несовместимость версий или отсутствие зависимостей. Вот несколько распространенных ситуаций:

  • Ошибка при установке Puppeteer: Иногда могут возникать проблемы с установкой Puppeteer из-за несовместимости с версией Node.js. В таких случаях полезно проверить, используется ли совместимая версия Node.js, а также обновить npm до последней версии: 
npm install -g npm
  • Проблемы с правами доступа: На некоторых системах могут возникать ошибки с правами доступа при установке глобальных пакетов. В таком случае можно использовать флаг –unsafe-perm: 
npm install puppeteer --unsafe-perm=true
  • Проблемы с Chromium: Puppeteer автоматически скачивает подходящую версию Chromium, однако если это не происходит или браузер не запускается, можно попробовать скачать и установить Chromium вручную.

  1. Обновление Node.js и npm

С течением времени версии Node.js и npm обновляются, и рекомендуется следить за их актуальностью, чтобы использовать последние возможности и исправления безопасности. Обновление Node.js можно выполнить, скачав установщик с официального сайта, а для обновления npm можно использовать команду: 

npm install -g npm

Если установлена версия Node.js слишком старая, возможно, потребуется обновить её вручную. Для этого можно использовать менеджер версий, такой как nvm, который позволяет устанавливать и переключаться между различными версиями Node.js.

  1. Установка Puppeteer с определенной версией Chromium

Puppeteer, начиная с версии 2.x, устанавливает последнюю версию Chromium по умолчанию. В некоторых случаях может потребоваться использовать конкретную версию Chromium. Для этого можно использовать флаг PUPPETEER_CHROMIUM_REVISION, который позволяет указать нужную версию: 

PUPPETEER_CHROMIUM_REVISION=<revision_number> npm install puppeteer

Где <revision_number> — это номер ревизии Chromium, который можно найти в официальной документации или на GitHub.

  1. Установка Puppeteer в Docker

Для изоляции окружения часто используется Docker. В этом случае можно создать Dockerfile, который будет автоматически устанавливать Node.js, Puppeteer и все зависимости. Пример Dockerfile: 

FROM node:16





WORKDIR /app


COPY package.json package-lock.json ./


RUN npm install


COPY . .

CMD ["node", "test.js"]

Затем создайте образ и запустите контейнер: 

docker build -t puppeteer-app .
docker run --rm puppeteer-app

Это позволит запускать Puppeteer в изолированной среде, что особенно полезно для CI/CD пайплайнов.

  1. Настройка Proxy для Puppeteer

Если необходимо использовать прокси для работы с Puppeteer, это можно сделать при запуске браузера, указав параметры proxyServer. Пример: 

const browser = await puppeteer.launch({
  args: ['--proxy-server=http://your.proxy.server:8080']
});

Это обеспечит доступ к интернет-ресурсам через указанный прокси-сервер.

Эти шаги обеспечат корректную установку Node.js, npm и Puppeteer, а также помогут избежать распространенных проблем при настройке.

Оглавление