O conteúdo acompanha o endereço
Uma data URI, também chamada de data URL, é um endereço iniciado por data: que contém o próprio conteúdo a ser lido. Uma aplicação compatível extrai esses bytes do endereço, em vez de buscar esse conteúdo em um servidor externo.
O esquema permite informar o tipo de mídia antes da vírgula que separa a identificação do conteúdo. O marcador opcional base64, precedido por um ponto e vírgula, indica a codificação Base64. Sem esse marcador, os caracteres que precisam de escape usam a codificação percentual, como %20 para um espaço.
Como interpretar um texto incorporado
O exemplo data:text/plain,ola%20mundo contém o texto ola mundo. A parte text/plain identifica texto simples. Depois da vírgula, a aplicação decodifica %20 como espaço e recupera a mensagem. Essa leitura não exige baixar um arquivo externo.
Com Base64, a mesma mensagem pode ser escrita desta forma:
data:text/plain;base64,b2xhIG11bmRvA aplicação decodifica b2xhIG11bmRv e recupera ola mundo, embora os caracteres do endereço sejam diferentes. A codificação permite representar os bytes em texto e não oferece sigilo.
O esquema foi concebido para conteúdos curtos. Os navegadores também aplicam políticas de uso e restringem a navegação direta para endereços data:. Para usar um conteúdo incorporado na sua aplicação, confira a aceitação do esquema no destino específico, além de testar o tamanho do endereço.
Dúvidas frequentes
Perguntas frequentes sobre data URI
- Uma data URI precisa usar Base64?
- O marcador de Base64 é opcional. Sem ele, os bytes são representados por caracteres permitidos no endereço e por sequências percentuais, como %20 para um espaço.
- Base64 protege o conteúdo contra leitura?
- A codificação Base64 pode ser revertida para recuperar os bytes originais. Um segredo incluído numa data URI permanece acessível a qualquer aplicação que receba o endereço completo.
- Existe um tamanho aceito por todas as aplicações?
- Os limites dependem do navegador e da aplicação que recebe o endereço. A RFC 2397 destina o esquema a conteúdos curtos, por isso é necessário conferir a compatibilidade no destino.
Para continuar
Recursos relacionados
Documentação
RFC 2397: conteúdo incorporado no esquema data
Define a sintaxe do esquema data, o tipo de mídia e as formas de codificar o conteúdo.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Sessão com orientação técnica ao vivo para investigar conteúdo incorporado que a aplicação não consegue interpretar ou exibir.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O uso de conteúdo incorporado exige interpretar a codificação e conferir as políticas aceitas pelo navegador ou pela aplicação.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.