Atualize suas extensões antes das próximas mudanças na sincronização de favoritos

James Lee
James Lee

Publicado em: 17 de junho de 2025

Em agosto do ano passado, anunciamos mudanças futuras no modelo de identidade do Chrome para plataformas Windows, Mac e Linux, seguindo as que já foram lançadas no iOS e Android. O objetivo dessas mudanças é alinhar o Chrome às expectativas atuais dos usuários em relação ao login. Os usuários esperam cada vez mais apenas fazer login para acessar os itens, incluindo favoritos, e sair para manter tudo seguro.

Como parte do lançamento dessas atualizações, estamos introduzindo mudanças na forma como o Chrome armazena favoritos no computador. Por exemplo, os favoritos armazenados localmente em um dispositivo permanecem locais após o login. Os usuários podem fazer upload desses dados para a Conta do Google individualmente ou em massa. Para permitir que as extensões ofereçam suporte a isso, estamos expondo novos dados na API Chrome Extensions. As informações a seguir são relevantes para todos os autores de extensões do Chrome que usam a API chrome.bookmarks.

Visão geral

Hoje, os usuários sempre têm um único conjunto de pastas de nível superior, incluindo "Barra de favoritos" e "Outros favoritos". Os dados nessas pastas podem ou não ser sincronizados, dependendo se o usuário fez login com a sincronização ativada.

Como parte das mudanças no modelo de identidade, o Chrome vai separar os favoritos sincronizados e não sincronizados em duas subárvores separadas na árvore de favoritos. Em alguns casos, quando um usuário não escolhe fazer upload de todos os favoritos para a conta, ele pode ter pastas de favoritos sincronizadas e não sincronizadas ao mesmo tempo. As extensões que usam a API Bookmarks talvez precisem ser atualizadas para mostrar a árvore de favoritos de uma forma clara para os usuários.

Detalhes das mudanças na API

Para usuários com uma mistura de favoritos sincronizados e não sincronizados, a API Bookmarks pode retornar uma árvore semelhante à seguinte na API getTree:

  • id=A (name: "Bookmarks bar", folderType: "bookmarks-bar", syncing: true)
    • …
  • id=B (name: "Outros favoritos", folderType: "other", syncing: true)
    • …
  • id=C (name: "Bookmarks bar", folderType: "bookmarks-bar", syncing: false)
    • …
  • id=D (name: "Outros favoritos", folderType: "other", syncing: false)
    • …

Para permitir que os desenvolvedores de extensões distingam essas pastas de nível superior, duas novas propriedades foram adicionadas à API:

  • folderType: permite que as extensões identifiquem as pastas "especiais", como a barra de favoritos. O name e o id não devem ser usados para essa finalidade. O name depende da localidade, e o id não é fixo.
  • syncing: para permitir que as extensões diferenciem as partes da árvore que estão sendo sincronizadas e as que não estão. Isso será true antes que o modelo de identidade mude se o usuário estiver conectado e com a sincronização ativada.

Atualizações de extensões

Se alguma das seguintes situações for verdadeira para sua extensão, talvez seja necessário fazer atualizações:

  • Se a extensão mostrar o resultado completo de getTree ao usuário para evitar que versões com nomes idênticos, por exemplo, da barra de favoritos, sejam exibidas. Talvez você queira anexar um sufixo ao nome ou fornecer algum outro tratamento de interface.
  • Se a extensão tentar corresponder às pastas permanentes da barra de favoritos, outras ou móveis por id ou name. Esses métodos já não eram compatíveis.
  • Se a extensão presumir que há exatamente ou no máximo uma instância das pastas permanentes da barra de favoritos, outras ou móveis

Teste

As novas propriedades de API de extensão folderType e syncing estão documentadas e disponíveis na versão mais recente do Chrome Canary (138.0.7196.0 ou mais recente).

Os usuários nos canais estáveis do Chrome têm um único armazenamento (ou seja, no máximo um de cada tipo de pasta). Para fins de teste, é possível ativar o armazenamento duplo da seguinte forma:

  1. Ative as duas opções a seguir em chrome://flags e reinicie o Chrome.
    • sync-enable-bookmarks-in-transport-mode
    • enable-bookmarks-selected-type-on-signin-for-testing
  2. Adicione um novo perfil do Chrome (https://support.google.com/chrome/answer/2364824)
    • Não faça login: escolha "Continuar sem uma conta".
  3. Se você adicionar páginas aos favoritos, elas serão adicionadas ao armazenamento não sincronizado.
  4. Agora faça login no Chrome:
    • Clique na foto do avatar no canto superior direito, ao lado do menu de três pontos.
    • Clique em "Fazer login no Chrome" e siga as instruções.
    • Escolha "Não, obrigado" quando for perguntado se você quer ativar a sincronização.
  5. Se você adicionar páginas aos favoritos, elas serão adicionadas ao armazenamento de sincronização, permitindo testar o caso de armazenamento duplo.

Cronogramas

As mudanças para expor o armazenamento duplo serão lançadas gradualmente, começando para um subconjunto de usuários do canal Stable do Chrome não antes do final de junho de 2025. O lançamento vai começar para uma pequena porcentagem de usuários e depois será ampliado nas semanas seguintes.