Conteúdo do curso Lição 117 de 156 · Como um navegador decide
Como um navegador decide

A Storage Access API

Por que isso importa Bloquear ou particionar cookies de terceiros para os rastreadores, mas também desconecta você de conteúdos incorporados honestos: uma caixa de comentários em que você está conectado, um player de vídeo que conhece a sua conta, um formulário de login dentro de outra página. A Storage Access API é como os navegadores deixam esses conteúdos incorporados funcionarem de novo, com você no controle.

Pense no guarda-volumes de novo. Cada loja agora tem o próprio talão de fichas, então a sua ficha principal do prédio da própria AdCo não serve para nada dentro da ShopA. A Storage Access API é o atendente do guarda-volumes na ShopA perguntando a você: "Quer usar a sua ficha principal aqui?" Se você disser sim, aquele atendente, naquela loja, pode usá-la.

Storage Access API: um recurso do navegador que deixa um quadro incorporado de outro site pedir acesso aos próprios cookies sem particionamento, os que ele tem quando você o visita diretamente.

Gesto do usuário: uma ação de verdade sua, como um clique ou uma tecla, dentro da página. Os navegadores a usam como prova de que um pedido não foi feito em silêncio por um script.

Como um conteúdo incorporado pede

Imagine que comments.example está incorporado em blog.example. Dentro do quadro, o script dele faz isto (JavaScript, mostrado só para leitura):

// Inside the comments.example frame
if (!(await document.hasStorageAccess())) {
  signInButton.onclick = async () => {        // must run inside a click
    try {
      await document.requestStorageAccess();     // the browser may ask you
      location.reload();                         // now it sees its own cookies
    } catch {
      showMessage("Open comments.example to sign in");
    }
  };
}

hasStorageAccess() responde "eu já tenho os meus cookies aqui?". requestStorageAccess() pede os cookies, e dá certo ou falha. Um conteúdo incorporado bem escrito trata a falha com elegância.

As regras que os motores aplicam

  • Só quadros incorporados pedem. Uma página de nível superior já tem os próprios cookies.
  • É preciso um gesto do usuário. Um script não pode pedir acesso em silêncio quando a página carrega; o pedido precisa estar dentro do seu clique.
  • Talvez você precise conhecer o conteúdo incorporado. Os motores podem exigir que você já tenha visitado o site incorporado diretamente antes, para que um rastreador de que você nunca ouviu falar não possa pedir. O Safari, por exemplo, exige isso.
  • O navegador pode mostrar um aviso, nomeando os dois sites, e você pode recusar.
  • As concessões são restritas. Elas cobrem um site incorporado num site de nível superior, e expiram depois de um tempo.
  • Quadros em sandbox precisam que a página permita isso explicitamente, com o token de sandbox allow-storage-access-by-user-activation.

Os avisos e limites de tempo exatos variam entre os motores e mudam com o tempo; o formato acima é comum a todos.

Onde ela existe

A Storage Access API existe no Safari, no Firefox e no Chrome (no Chrome desde a versão 119). No Chrome ela só importa para quem bloqueia cookies de terceiros, já que todos os outros ainda têm cookies de terceiros sem particionamento. Os Related Website Sets, que antes concediam acesso automaticamente entre sites de uma mesma empresa, foram aposentados (verificado em outubro de 2026).

Storage Access versus CHIPS

É fácil confundir os dois. Com o CHIPS (o atributo Partitioned da Etapa 1), um conteúdo incorporado aceita um pote separado em cada site e não precisa de permissão. Com o Storage Access, o conteúdo incorporado pede o seu único pote compartilhado, que consegue reconhecer você entre sites, então precisa do seu gesto e possivelmente do seu sim. Prefira o CHIPS quando o conteúdo incorporado não precisa saber quem você é em outros lugares.

Um equívoco comum

"Conceder acesso ao armazenamento deixa o conteúdo incorporado ler os cookies da página." Não deixa. comments.example recebe de volta os próprios cookies, nada dos de blog.example. O que você está aceitando é que comments.example possa reconhecer você neste blog.

Resumo

  • A Storage Access API deixa um conteúdo incorporado pedir os próprios cookies sem particionamento.
  • Ela precisa de um gesto do usuário, só funciona em quadros, pode mostrar um aviso e concede acesso a um conteúdo incorporado num site por um tempo limitado.
  • Ela existe no Safari, no Firefox e no Chrome 119; no Chrome só importa quando os cookies de terceiros estão bloqueados (verificado em outubro de 2026).
  • O CHIPS dá um pote separado por site sem permissão; o Storage Access dá o pote compartilhado com o seu consentimento.

Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição

Este exercício abre em breve

Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.