Replay de Sessão

O replay de sessão oferece uma forma de inspecionar as ações executadas e as requisições de rede. Esse recurso permite reproduzir sessões gravadas, possibilitando um exame detalhado, página por página, das ações executadas e das requisições de rede.

Vantagens

✅ Gravação em tempo real – Registra automaticamente todas as requisições de rede durante a execução do script

✅ Reprodução quadro a quadro – Refaça com precisão as ações do navegador

✅ Colaboração em equipe – Compartilhe facilmente as gravações de sessão para depuração em equipe

✅ Precisão de milissegundos – Inspecione os timestamps a nível de evento para um ajuste aprimorado do script

✅ Isolamento seguro – Os dados da sessão são criptografados e protegidos por controle de acesso granular

✅ Formato leve – Os arquivos de gravação são 90% menores do que arquivos de vídeo graças ao diffing de DOM baseado em rrweb

Como Usar

Crie uma Sessão do Scrapeless Browser

Tipo Um: Criar uma Gravação de Sessão pelo Playground

O playground tem a gravação de sessão habilitada por padrão através das configurações de parâmetros.

Você também pode habilitar a gravação de sessão nas configurações do Playground. No entanto, observe que, uma vez que você habilite a opção Use Playground Settings, ela sobrescreverá os parâmetros de conexão no código do playground.

Após a configuração, clique em “Run” para iniciar a gravação.

Tipo Dois: Criar uma Gravação de Sessão pela API

Você também pode conectar a nossa funcionalidade de sessão em seus outros projetos via API, definindo os parâmetros da sessão em seu código.

Para habilitar a gravação, defina o parâmetro de consulta sessionRecording como true. O valor padrão é false. Você também pode usar o parâmetro sessionName para definir um nome para a sua sessão, facilitando encontrá-la rapidamente na lista de sessões.

Para uma documentação mais detalhada, consulte: Documentação da API do Agent Browser. O exemplo de código é o seguinte:

const { Scrapeless } = require('@scrapeless-ai/sdk');
const puppeteer =require('puppeteer-core');
const client = new Scrapeless({ apiKey: 'API Key' });
 
// custom fingerprint
const fingerprint = {
    platform: 'Windows',
}
 
// Create browser session and get WebSocket endpoint
const { browserWSEndpoint } = client.browser.create({
    sessionName: 'sdk_test',
    sessionTTL: 180,
    proxyCountry: 'US',
    sessionRecording: true,
    fingerprint,
});
 
(async () => {
    const browser = await puppeteer.connect({browserWSEndpoint});
    const page = await browser.newPage();
 
    await page.goto('https://www.scrapeless.com');
    await new Promise(res => setTimeout(res, 3000));
 
    await page.goto('https://www.google.com');
    await new Promise(res => setTimeout(res, 3000));
 
    await page.goto('https://www.youtube.com');
    await new Promise(res => setTimeout(res, 3000));
 
    await browser.close();
})();

const puppeteer =require('puppeteer-core');
 
const token = 'API Key'
 
// custom fingerprint
const fingerprint = {
    platform: 'Windows',
}
 
const query = new URLSearchParams({
    sessionTTL: 180,
    sessionName: 'test_scraping', // session name
    sessionRecording: true, // enable web session recording
    proxyCountry: 'ANY',
    token: token,
    fingerprint: encodeURIComponent(JSON.stringify(fingerprint)),
});
 
const connectionURL = `wss://browser.scrapeless.com/api/v2/browser?${query.toString()}`;
 
(async () => {
    const browser = await puppeteer.connect({browserWSEndpoint: connectionURL});
    const page = await browser.newPage();
 
    await page.goto('https://www.scrapeless.com');
    await new Promise(res => setTimeout(res, 3000));
 
    await page.goto('https://www.google.com');
    await new Promise(res => setTimeout(res, 3000));
 
    await page.goto('https://www.youtube.com');
    await new Promise(res => setTimeout(res, 3000));
 
    await browser.close();
})();

const {chromium} =require('playwright');
 
const token = 'API Key'
 
// custom fingerprint
const fingerprint = {
    platform: 'Windows',
}
 
const query = new URLSearchParams({
    sessionTTL: 180,
    sessionName: 'test_scraping', // session name
    sessionRecording: true, // enable web session recording
    proxyCountry: 'ANY',
    token: token,
    fingerprint: encodeURIComponent(JSON.stringify(fingerprint)),
});
 
const connectionURL = `wss://browser.scrapeless.com/api/v2/browser?${query.toString()}`;
 
(async () => {
    const browser = await chromium.connectOverCDP(connectionURL);
    const page = await browser.newPage();
 
    await page.goto('https://www.scrapeless.com');
    await new Promise(res => setTimeout(res, 3000));
 
    await page.goto('https://www.google.com');
    await new Promise(res => setTimeout(res, 3000));
 
    await page.goto('https://www.youtube.com');
    await new Promise(res => setTimeout(res, 3000));
 
    await browser.close();
})();

Ver o Replay

Após o navegador terminar a execução, a gravação da sessão será salva automaticamente. Clique na lista de histórico de sessões para visualizá-la.

Limitações

💡 A gravação de sessão foca apenas na experiência visual do usuário no navegador e não inclui nenhuma atividade subjacente do servidor, interações com banco de dados ou alterações técnicas que não se reflitam na estrutura da página (DOM).

💡 Animações complexas construídas com tecnologias como WebGL ou canvas podem não ser reproduzidas com fidelidade perfeita nas gravações de sessão.

Sessão ao vivo Ferramentas de desenvolvimento