Como executar o Safari no Linux: opções de acesso remoto e WebKit

A Apple não oferece uma versão atual e oficialmente suportada do Safari para Linux. Sua última versão para Windows, o Safari 5.1.7, foi lançada em 2010 e está desatualizada. Use um Mac remoto para acessar o Safari ou a versão WebKit do Playwright para testes no Linux; WebKit não é o Safari.

Escolha o método que melhor se adequa ao seu objetivo.

Para informações específicas sobre o comportamento do Safari, extensões, suporte a mídia ou uma versão exata, teste no Safari instalado no macOS. O WebKit do Linux pode detectar problemas do mecanismo, mas não pode certificar o navegador da Apple.

Utilize uma sessão Safari real a partir do Linux.

Um serviço de teste de navegadores é uma opção simples que dispensa o uso de um Mac. O BrowserStack Live oferece sessões de navegadores na nuvem e inclui o Safari entre os navegadores suportados. Consulte a visão geral do serviço Live e a lista atual de navegadores; as versões disponíveis do macOS e do Safari podem sofrer alterações.

1. Abra um painel de controle de navegador remoto. Faça login em um serviço que ofereça o Safari para macOS. No seletor de dispositivos ou navegadores, escolha um computador macOS e uma versão do Safari disponível.
2. Inicie uma sessão e abra seu site. Digite o endereço do site público na janela do navegador remoto. O navegador está sendo executado no Mac remoto; o computador Linux apenas exibe e controla essa sessão.

Acesse um local de desenvolvimento local.

Se o site só funciona na sua máquina Linux, um navegador remoto não conseguirá acessar o localhost por conta própria. Use o túnel de teste local do serviço. A configuração oficial do BrowserStack oferece um binário de linha de comando para Linux para essa finalidade:

1. Baixe o binário Linux que corresponde à arquitetura do seu sistema seguindo as instruções de teste local do BrowserStack e, em seguida, extraia o arquivo ZIP.
2. Copie sua chave de acesso das configurações da sua conta. Em um terminal, acesse a pasta que contém o arquivo binário extraído e execute o seguinte comando:

./BrowserStackLocal --key YOUR_ACCESS_KEY

Substitua o marcador pela sua própria chave e mantenha o terminal aberto durante o teste. Em seguida, inicie ou reinicie a sessão Live com o Teste Local ativado e insira seu endereço local, como http://localhost:3000. Pare o túnel com Ctrl+Cquando terminar. Trate a chave de acesso como uma senha e não a cole em código público nem a compartilhe.

Execute o WebKit localmente com o Playwright.

Para testes automatizados executados no Linux ou em um ambiente de CI Linux, o Playwright pode instalar sua versão para WebKit. Em um sistema com Python 3, crie um ambiente virtual, instale o Playwright e baixe o binário do navegador correspondente:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install playwright
playwright install webkit

Um script Python mínimo pode iniciar esse navegador e carregar uma página:

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.webkit.launch()
    page = browser.new_page()
    page.goto("https://example.com")
    print(page.title())
    browser.close()

Execute o script com Python. Se o navegador reportar bibliotecas de sistema ausentes, instale as dependências do WebKit para sua distribuição ou siga o guia de instalação do navegador e requisitos de sistema do Playwright . Execute novamente o comando de instalação do navegador após atualizar o Playwright, caso haja alterações na versão do navegador necessária.

O WebKit do Playwright é uma versão modificada a partir do código-fonte do WebKit, não sendo um produto oficial do Safari, e pode incluir alterações anteriores às do Safari. Alguns comportamentos também variam de acordo com o sistema operacional. Para uma experiência mais semelhante à do Safari, o Playwright recomenda executar o WebKit no macOS, especialmente para reprodução de vídeo.

Por que o Wine e o antigo instalador do Safari são más escolhas

O método antigo do Wine iniciava o Safari para Windows, não uma versão atual para Linux. A Apple considera o Safari 5.1.7, lançado em 2010, desatualizado. O Wine não consegue adicionar correções de segurança ausentes ou recursos modernos do Safari. Evite espelhos de instaladores não oficiais e nunca use este navegador para contas confidenciais. Se for mantê-lo para testes históricos, isole-o da navegação e dos dados do dia a dia.

Solução rápida de problemas

• A sessão remota não pode abrir o localhost: confirme se o túnel local ainda está ativo, se o Teste Local está habilitado na sessão Live e se o seu servidor de desenvolvimento está escutando na porta especificada no URL.
• O Playwright WebKit não será iniciado: verifique se há bibliotecas Linux ausentes e siga as instruções de dependência do sistema para sua distribuição.
• Um teste do WebKit é aprovado, mas o Safari ainda apresenta diferenças: repita o teste no Safari instalado no macOS. Os dois ambientes podem diferir em relação a patches do navegador e recursos da plataforma.