Mariner/ docs← marinerhttp.dev

03 · INTEGRAÇÕES

Integração com o macOS

As partes do Mariner que saem da janela — sincronização com o iCloud, Atalhos e Siri, Spotlight, o histórico de requisições, o proxy de todo o app e o teto de download.

Sincronização com o iCloud

Desligada por padrão. Ative em ⌘, → iCloud e reinicie o app.

  • Sincroniza: workspaces, coleções, pastas, requisições e ambientes, pelo seu banco privado do iCloud. Nenhum servidor do Mariner entra no meio.
  • Nunca sincroniza: o histórico e os bodies de resposta, que ficam em um armazenamento local, e as credenciais, que ficam nas Chaves de cada Mac.

O ícone de nuvem na barra de status indica a situação: verde quando está conectado, iCloud off, Sync error, ou Not syncing quando uma mudança local passa tempo demais sem confirmação. Clique para ver o último salvamento local, o último evento do iCloud e as mudanças pendentes; Sync now ali ou ⌘S em qualquer lugar força um envio. Se o iCloud não conseguir inicializar no início, o Mariner continua funcionando local, desliga o interruptor e mostra o motivo nos Ajustes.

Atalhos e Siri

O Mariner oferece a ação Run Request para o app Atalhos: escolha uma requisição salva e ela roda com o ambiente ativo do workspace — mesmo com o Mariner fechado — devolvendo o body da resposta (até 2 KB) como valor que a próxima ação pode usar. A Siri entende frases como “Run ‹request› in Mariner” e “Send ‹request› with Mariner” para as requisições que você habilitou no Atalhos.

Spotlight

Todas as requisições são indexadas. Digite o nome no Spotlight e o resultado abre a requisição no Mariner.

Histórico

⌘⇧H abre o histórico do workspace atual: cada execução com seu status, duração, a requisição do jeito que foi enviada e a resposta.

  • Filtre por classe de status (2xx … 5xx, erros), por coleção ou por texto sobre nome e URL.
  • Botão direito em uma linha: Re-run (com a definição atual da requisição), Open Request, Copy URL, Delete.
  • Retention mantém uma janela deslizante por workspace — 200 execuções por padrão, ajustável de 10 a 10.000 — e Purge Now aplica na hora. Clear All apaga o que está filtrado naquele momento.
  • Export HAR escreve as execuções filtradas como um arquivo HAR 1.2 para as ferramentas que o leem.

Os bodies de resposta são guardados até 1 MB cada; o que passa disso é descartado e marcado como cortado. As últimas cinco execuções também estão a um ⌘K em Recent.

Proxy

⌘, → Network → Use a proxy, com host e porta, uma verificação de alcance ao vivo e uma lista de exceções (localhost, 127.0.0.1, *.local; um ponto inicial como .example.com cobre todos os subdomínios). Um único proxy atende HTTP e HTTPS para o app inteiro.

⌘⇧P liga ou desliga sem abrir os Ajustes; um chip na barra de URL indica quando o tráfego passa por ele. As requisições usam um timeout de 30 segundos.

Quando a falha é do proxy e não do servidor, o Mariner diz isso em vez de culpar a rede: Proxy connection failed — nomeando host e porta quando o proxy é o que você configurou aqui, e apontando para os Ajustes do sistema quando não é —, Proxy rejected the credentials (o Mariner ainda não envia credenciais de proxy), Proxy refused the tunnel quando ele responde ao CONNECT com algo que não é um túnel, e Proxy configuration failed quando o arquivo PAC não pode ser lido. Antes isso chegava como um kCFErrorDomainCFNetwork 310 cru, ou como um erro de TLS apontando para um certificado que nunca chegou a ser visto.

Teto de download

⌘, → Network também limita quanto de corpo de resposta o Mariner puxa para a memória: 50 MB por padrão, ajustável para 10, 25, 100 ou 250 MB, ou desligado para quem sabe que está baixando algo grande de propósito.

É o único limite que age antes de os bytes existirem — o corpo chega em pedaços e a transferência é cortada assim que passa, então um endpoint de 2 GB não consegue fazer o app pedir 2 GB ao sistema. Os outros tamanhos desta página (o 1 MB por corpo do histórico, os tetos do visualizador) protegem o disco ou a renderização, e quando eles entram em cena a resposta já está na memória.

Registro de exploração

Um pequeno diário opcional de marcos — primeiro 2xx, primeiro erro, uma resposta abaixo de 100 ms — em Ajuda → Registro de exploração. Desligue o acompanhamento em Ajustes → Aparência se preferir não ter.

Ver em Markdown ↗