Браузерная автоматизация с Puppeteer
Последнее изменение:
Puppeteer это библиотека Node.js, которая позволяет автоматизировать процессы в Chromium браузере при помощи API высокого уровня, через Chrome DevTools Protocol. Например, вы можете создать веб-краулеры, которые будут искать и собирать данные, используя Mimic браузер с подмененными отпечатками.
Определение порта Indigo
В Indigo нужно предопределить порт, для использования автоматизации с Puppeteer. Вы можете предопределить порт Indigo следующим образом:
- Пройдите в директорию C:\Users\%username%\.indigobrowser и откройте файл app.properties
- Добавьте следующую строку: multiloginapp.port=[PORT_NUMBER]
- Сохраните app.properties файл
В дальнейшем вы сможете обращаться к Indigo по данному порту.
Как начать
Шаг 1
Удостоверьтесь в том, что у вас установлен Node.js и пакетный менеджер npm. Вы можете скачать Node.js и npm с официального сайта Node.js (последние версии Node.js имеют npm в наличии). Как альтернатива, вы можете использовать yarn для менеджмента пакетов Node.js.
Вы можете проверить версию ваших Node.js и npm, вызвав следующую команду в терминале:
nodejs -v || node -v && npm -v
Шаг 2
Создайте новый npm проект в текущей директории.
npm init -y
Данная команда создаст конфигурационный файл package.json, так же -y параметр позволяет пропустить вопросы связанные с настройкой проекта и использовать дефолтные значения.
Шаг 3
Установите Puppeteer в директории проекта.
npm install [email protected] --save
Пожалуйста, обратите внимание, что для каждой версии Chromium имеется своя версия Puppeteer. Начиная с Indigo 5.6.1, Mimic браузер использует Chromium 84, который работает с Puppeteer 5.1.0. Вы можете следить за обновлениями браузерного движка Mimic, через наш журнал изменений. Совместимость версий Puppeteer и Chromium вы можете проверить в Puppeteer документации.
Совместимость с предыдущими версиями:
Chromium 80 (начиная с Indigo 5.2) | Puppeteer 2.1.0 |
Шаг 4
Создайте .js файл с вашим кодом автоматизации. Пожалуйста, используйте следующий код в качестве примера.
const puppeteer = require('puppeteer');
const http = require('http');
async function startProfile(){
//Replace profileId value with existing browser profile ID.
let profileId = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx';
let mlaPort = 35000;
/*Send GET request to start the browser profile by profileId.
Returns web socket as response which should be passed to puppeteer.connect*/
http.get(`http://127.0.0.1:${mlaPort}/api/v1/profile/start?automation=true&puppeteer=true&profileId=${profileId}`, (resp) => {
let data = '';
let ws = '';
//Receive response data by chunks
resp.on('data', (chunk) => {
data += chunk;
});
/*The whole response data has been received. Handling JSON Parse errors,
verifying if ws is an object and contains the 'value' parameter.*/
resp.on('end', () => {
let ws;
try {
ws = JSON.parse(data);
} catch(err) {
console.log(err);
}
if (typeof ws === 'object' && ws.hasOwnProperty('value')) {
console.log(`Browser websocket endpoint: ${ws.value}`);
run(ws.value);
}
});
}).on("error", (err) => {
console.log(err.message);
});
}
async function run(ws) {
try{
//Connecting Puppeteer with Mimic instance and performing simple automation.
const browser = await puppeteer.connect({browserWSEndpoint: ws, defaultViewport:null});
const page = await browser.newPage();
await page.goto('https://multilogin.com');
await page.screenshot({ path: `/home/${process.env.USER}/Desktop/multiloginScreenshot.png` });
await browser.close();
} catch(err){
console.log(err.message);
}
}
startProfile();
Шаг 5
Запустите .js файл через терминал для запуска вашего скрипта автоматизации.
nodejs example.js