Sessões e perfis persistentes
Saiba mais sobre Sessões Persistentes (sticky) e Perfis Persistentes no Headless Browser da Oxylabs. Reconecte-se a sessões em andamento e reutilize seus cookies ou local storage em várias sessões.
Gerenciar fluxos de trabalho de automação multietapa de longa duração ou manter estados de usuário autenticados entre sequências de conexão distintas requer persistir estados do navegador. Oxylabs Headless Browser oferece dois sistemas avançados de persistência:
Mantenha um ambiente de navegador remoto ativo em execução entre desconexões do cliente.
Salve e restaure cookies, localStorage e cache do navegador.
Sessões Persistentes
As Sessões Persistentes (sticky) mantêm sua instância remota do navegador em execução na nuvem (mesmo quando seu script de automação local se desconecta) ao definir um custom session_name na sua URL de conexão:
wss://USER:PASS@hb.oxylabs.io?session_name=checkout-flow-testsession_name
Quando definido, uma sessão persiste até o tempo máximo de vida (TTL) (máx. 24h ou até ser interrompida). Reconecte com o mesmo session_name para reconectar o mesmo ID de sessão e as abas existentes. Formato suportado: ^[A-Za-z0-9-]{3,36}$
Cadeia de caracteres
keep_alive
Enquanto false (padrão), chamar browser.close() recupera e encerra a sessão.
Enquanto true, a sessão permanece ativa na nuvem depois que você se desconecta (por até 10 minutos).
Booleano
Reconectar a uma aba existente
// Reconnect to existing session with
const browser = await chromium.connectOverCDP(endpoint);
const ctx = browser.contexts()[0];
const page = ctx.pages().find(p => p.url().includes("http://example.com "));Perfis Persistentes
Os Perfis Persistentes são ativadas por padrão para todos os usuários, com um limite padrão de 5 perfis. Use-o para salvar cookies e localStorage em um perfil nomeado e restaurá-los em uma sessão nova. Os seguintes parâmetros permitem manter uma persona autenticada entre sessões sem precisar reautenticar toda vez:
o_profile
Salve/restaure cookies e localStorage com um perfil nomeado (14 dias desde o último uso). Formato suportado: ^[A-Za-z0-9_-]{1,36}$
Cadeia de caracteres
o_profile_save
Forçar o salvamento do perfil durante ou no final da sessão. Padrão: false.
Booleano
proxy_resi_ses_id
ID de sessão personalizado para fixar o IP de saída residencial entre sessões. Formato suportado: ^[A-Za-z0-9]{3,36}$.
Cadeia de caracteres
proxy_resi_ses_time
Duração para manter o IP de saída do proxy residencial fixado, em minutos. Mín 1, máx 1440 (24h).
Inteiro
Restauração confiável entre sessões
Para sites com sistemas rígidos de monitoramento de bots, salvar cookies não é suficiente. Se um perfil restaurado se conectar a partir de um IP de saída residencial diferente, seus cookies podem ser invalidados, resultando em páginas em branco ou telas de verificação de segurança.
Para garantir logins consistentes, combine seu perfil com um IP de saída residencial fixado:
Atualizado
Isto foi útil?

