Os URLs são reservados pelo Firebase Hosting no seu site começando com /__. O uso de outros produtos do Firebase junto com o Firebase Hosting é facilitado por esse namespace reservado.
Esses URLs reservados estão disponíveis quando você implanta no Firebase (firebase deploy) ou quando executa o app em um servidor local (firebase serve).
Adicionar scripts a URLs reservados
Como o Firebase Hosting é veiculado pelo HTTP/2 quando implantado, é possível melhorar o desempenho com o carregamento de arquivos da mesma origem. Todas as versões do SDK do Firebase para JavaScript são veiculadas pelo Firebase Hosting a partir de URLs especiais formatados como a seguir:
/__/firebase/js-sdk-version/firebase-sdk-name.js
É extremamente recomendável carregar somente as bibliotecas que você usa no seu app. Por exemplo, para incluir somente o Authentication e Cloud Firestore, adicione os seguintes scripts à parte inferior de sua tag <body>, mas antes de usar os serviços do Firebase:
<body>
<!-- Insert these scripts at the bottom of the HTML, but before you use any Firebase services -->
<!-- Firebase App (the core Firebase SDK) is always required and must be listed first -->
<script src="/__/firebase/6.0.2/firebase-app.js"></script>
<!-- Add Firebase products that you want to use -->
<script src="/__/firebase/6.0.2/firebase-auth.js"></script>
<script src="/__/firebase/6.0.2/firebase-firestore.js"></script>
</body>
Configuração automática do SDK
O gerenciamento de vários ambientes (como desenvolvimento, preparo e produção) é facilitada pela configuração automática do SDK a partir de uma única codebase. Ao contar com o URL do Hosting reservado, você implanta o mesmo código em vários projetos do Firebase.
Além da hospedagem dos próprios SDKs, a configuração necessária para inicializar o SDK para o projeto do Firebase associado ao site do Hosting é disponibilizada pelo namespace reservado. Essa configuração do Firebase e a inicialização do SDK são fornecidas por um script que pode ser incluído diretamente:
<!-- Load the Firebase SDKs before loading this file -->
<script src="/__/firebase/init.js"></script>
Quando você implanta no Firebase ou testa seu app localmente, esse script configura automaticamente o SDK do Firebase para JavaScript para o projeto ativo do Firebase e inicializa o SDK.
Se você preferir controlar a inicialização, os valores de configuração do Firebase também estarão disponíveis no formulário JSON:
fetch('/__/firebase/init.json').then(async response => {
firebase.initializeApp(await response.json());
});
Auxiliares do Auth
O Firebase Authentication usa o namespace reservado para fornecer JavaScript e HTML especiais a fim de concluir a autenticação com provedores por meio do OAuth. Isso permite que cada projeto do Firebase tenha um subdomínio exclusivo, o que aumenta a segurança do Firebase Authentication.
Além disso, você pode usar seu próprio domínio personalizado para a opção authDomain do firebase.initializeApp(). Se você configurar um domínio personalizado no Firebase Hosting, é possível especificar esse domínio personalizado (em vez do subdomínio web.app ou firebaseapp.com) ao inicializar os SDKs do Firebase.
URLs reservados e service workers
Se você estiver criando um Progressive Web App (PWA), gere um service worker que tenha um fallback de navegação e renderize um URL específico por padrão, caso ele não corresponda a uma lista de itens armazenados previamente em cache.
Se você estiver usando a biblioteca sw-precache, adicione uma configuração de lista de permissões do fallback de navegação que exclua o namespace reservado:
{
navigateFallbackWhitelist: [/^(?!\/__).*/]
}
Em geral, lembre-se de que o namespace com sublinhado duplo é reservado para uso do Firebase e de que não é permitido interceptar essas solicitações no seu service worker.