Processar erros do Cloud Storage na Web

Às vezes, quando você está criando um aplicativo, as coisas não saem como planejado e ocorre um erro!

Em caso de dúvida, verifique o manipulador de erros (ou a função catch() para Promises) e veja o que a mensagem de erro tem a dizer.

Se você verificou a mensagem de erro e possui regras de segurança de armazenamento em nuvem que permitem sua ação, mas ainda está com dificuldades para resolver o erro, visite nossa página de suporte e diga-nos como podemos ajudar.

Lidar com mensagens de erro

Existem vários motivos pelos quais podem ocorrer erros, incluindo a inexistência do arquivo, o usuário não ter permissão para acessar o arquivo desejado ou o usuário cancelar o upload do arquivo.

Para diagnosticar adequadamente o problema e lidar com o erro, aqui está uma lista completa de todos os erros que nosso cliente irá levantar e como eles ocorreram.

Código Razão
storage/unknown Ocorreu um erro desconhecido.
storage/object-not-found Nenhum objeto existe na referência desejada.
storage/bucket-not-found Nenhum bucket está configurado para o Cloud Storage
storage/project-not-found Nenhum projeto está configurado para o Cloud Storage
storage/quota-exceeded A cota do seu bucket do Cloud Storage foi excedida. Se você estiver no nível gratuito, atualize para um plano pago. Se você estiver em um plano pago, entre em contato com o suporte do Firebase.
storage/unauthenticated O usuário não está autenticado. Autentique-se e tente novamente.
storage/unauthorized O usuário não está autorizado a realizar a ação desejada, verifique suas regras de segurança para garantir que estão corretas.
storage/retry-limit-exceeded O limite máximo de tempo para uma operação (upload, download, exclusão, etc.) foi excedido. Tente fazer upload novamente.
storage/invalid-checksum O arquivo no cliente não corresponde à soma de verificação do arquivo recebido pelo servidor. Tente fazer upload novamente.
storage/canceled O usuário cancelou a operação.
storage/invalid-event-name Nome de evento inválido fornecido. Deve ser um de [ `running` , `progress` , `pause` ]
storage/invalid-url URL inválido fornecido para refFromURL() . Deve estar no formato: gs://bucket/object ou https://firebasestorage.googleapis.com/v0/b/bucket/o/object?token=<TOKEN>
storage/invalid-argument O argumento passado para put() deve ser `File`, `Blob` ou `UInt8` Array. O argumento passado para putString() deve ser uma string bruta, `Base64` ou `Base64URL`.
storage/no-default-bucket Nenhum bucket foi definido na propriedade storageBucket da sua configuração.
storage/cannot-slice-blob Geralmente ocorre quando o arquivo local foi alterado (excluído, salvo novamente, etc.). Tente fazer upload novamente depois de verificar se o arquivo não foi alterado.
storage/server-file-wrong-size O arquivo no cliente não corresponde ao tamanho do arquivo recebido pelo servidor. Tente fazer upload novamente.