Testar um recurso novo ou experimental da plataforma da Web.
Os testes de origem dão acesso a um recurso novo ou experimental para que você possa testá-lo e oferecê-lo aos seus usuários por um tempo limitado. Quando o teste é concluído e o feedback é avaliado, o Chrome decide se o recurso será disponibilizado para todos.
Você pode se inscrever em um teste de origem para ativar um recurso para todos os usuários na sua origem, sem precisar ativar nenhuma flag ou mudar para uma versão alternativa do Chrome (embora possa ser necessário fazer upgrade). Depois de registrados, os desenvolvedores podem criar demonstrações e protótipos usando os novos recursos. Os testes também ajudam os engenheiros do Chrome a entender como os novos recursos são usados e como eles podem interagir com outras tecnologias da Web.
Disponibilidade
Os testes de origem são públicos e abertos a todos os desenvolvedores. Elas são limitadas em duração e uso. A participação é um processo autogerenciado com documentação e suporte limitados. Os participantes precisam estar dispostos e ser capazes de trabalhar de forma relativamente independente usando a documentação disponível, que, nesta etapa, provavelmente está limitada a explicações e especificações da API. Tentamos fornecer orientações sempre que possível.
Se você se inscrever para um teste, a equipe do Chrome vai pedir feedback específico sobre seu uso do recurso de teste periodicamente. Alguns recursos podem passar por vários testes de origem, à medida que o feedback é incorporado e os ajustes são feitos.
Os testes de origem também estão disponíveis para Firefox e Microsoft Edge.
Testes de origem de terceiros
Por padrão, um recurso de teste de origem só está disponível na origem registrada para o teste. Alguns testes oferecem uma opção de correspondência de terceiros no registro. Isso permite que provedores de conteúdo ou serviços incorporados testem um novo recurso em vários sites sem precisar de um token para cada origem.
Saiba mais: O que são testes de origem de terceiros?
Testes de descontinuação
Alguns testes de origem permitem que você reative temporariamente um recurso descontinuado. Eles são conhecidos como testes de descontinuação. Em alguns contextos, eles são chamados de testes de origem "inversos".
Por exemplo, os eventos de mutação foram removidos, a partir do Chrome 127. Os sites que precisarem de mais tempo antes de remover esses eventos podem se inscrever no teste de descontinuação para reativar os eventos temporariamente em sites específicos.
Participar de um teste de origem
- Escolha um teste de origem na lista de testes ativos.
- Solicite um token clicando no botão Register e preenchendo o formulário.
- Forneça o token em todas as páginas da Web em que você quer ativar o recurso de teste:
- Como uma metatag no <head>:
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE"> - Como um cabeçalho HTTP:
Origin-Trial: TOKEN_GOES_HERE - Fornecendo um token de maneira programática.
- Como uma metatag no <head>:
- Teste o novo recurso.
- Enviar feedback. Faça isso no site de teste de origem. Esse feedback não é público e está disponível apenas para um grupo limitado de pessoas na equipe do Chrome. Cada teste também oferece um link para feedback espontâneo da comunidade. Isso geralmente aponta para o recurso no GitHub ou em algum outro canal público.
- Quando o token expirar, você vai receber um e-mail com um link de renovação. Para fazer isso, você vai precisar enviar o feedback novamente.
Você pode se inscrever no mesmo teste de origem várias vezes, para origens diferentes, e incluir vários tokens na mesma página. Isso pode ser útil se você precisar fornecer tokens válidos para recursos veiculados de diferentes origens, como o código incluído em vários sites seus.
O framework de testes de origem procura o primeiro token válido e ignora todos os outros. É possível validar isso com o Chrome DevTools.
Fornecer um token de maneira programática
Em vez de fornecer um token como um cabeçalho HTTP ou como uma metatag no HTML da sua página, conforme descrito anteriormente, é possível injetar um token com JavaScript:
const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);
Use este método se você estiver participando de um teste de terceiros.
Tokens e iframes
Para acessar um recurso de teste em um iframe, forneça um token de teste em uma metatag, um cabeçalho HTTP ou programaticamente.
Como em todo uso de token, a origem registrada para o token precisa corresponder ao
contexto do JavaScript que acessa o recurso de teste: a origem da
página que inclui um script inline ou o src de um elemento <script> para
JavaScript incluído em um arquivo externo.
Tokens e extensões
Para usar um recurso de teste em um
script em segundo plano,
pop-up,
painel lateral ou
documento fora da tela, use a
chave trial_tokens no
arquivo manifest.json.
"trial_tokens": ["AnlT7gRo/750gGKtoI/A3D2rL5yAQA9wISlLqHGE6vJQinPfk0HiIij5LhWs+iuB7mTeotXmEXkvdpOAC1YjAgAAAG97Im9yaWdpbiI6ImNocm9tZS1leHRlbnNpb246Ly9sampoamFha21uY2lib25uanBhb2dsYmhjamVvbGhrayIsImZlYXR1cmUiOiJJQ2Fubm90QmVsaWV2ZVlvdVdhc3RlZFlvdXJUaW1lRGVjb2RpbmdUaGlzIiwiZXhwaXJ5Ijo1NzI1NDA3OTk5fQ=="]
Os scripts de conteúdo são processados
de maneira diferente. A exposição de um recurso a um mundo pode ser confusa e não intuitiva. Em vez de usar o trial_token do manifesto, adicione
o token à página de uma das seguintes maneiras:
- Inserir um cabeçalho usando
declarativeNetRequest - Programaticamente, adicione-o diretamente ao script de conteúdo.
Os tokens estão vinculados a domínios específicos, então você precisa se registrar no domínio em que o script de conteúdo está sendo executado, e não no ID da extensão.
Para registrar sua extensão em um teste, use o URL
chrome-extension://YOUR_EXTENSION_ID, por exemplo,
chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk.
Renovar a inscrição no teste da origem
Se o teste de origem for estendido, você vai receber um e-mail avisando que precisa renovar o registro e fornecer um novo token para cada origem inscrita no teste.
- Acesse Meus registros.
- Para cada origem registrada no teste estendido, clique em RENOVAR.
- Copie o novo token e disponibilize-o para todas as páginas que precisam permanecer inscritas no teste. É possível fornecer vários tokens, se necessário.
O Chrome ignora tokens inválidos ou expirados.
Conferir informações do teste de origem
Acesse informações sobre os testes de origem disponíveis para um site no painel Application do Chrome DevTools.
Você também pode usar nosso decodificador de token de teste de origem para acessar os dados codificados em um token.
Demonstrações
Os sites a seguir mostram exemplos de implantação de tokens.
Como fornecer um token de teste de origem
- Token em uma metatag
- Token em um cabeçalho
- Token injetado por script de terceiros
- Recurso acessado em um iframe
- Exemplos de iframes entre origens
Ferramentas de teste de origem
Recursos no teste de origem
Confira a seguir demonstrações de APIs em testes de origem em andamento
Recursos
Continue lendo nossa documentação de conceito do Chrome:
Saiba mais sobre os testes de origem no Chrome:
- Guia para desenvolvedores da Web
- Explicação do teste de origem
- Como executar um teste de origem
- Processo de lançamento de novos recursos no Chromium
- Intent to explain: Demystifying the Blink shipping process
- Visualizar informações de testes de origem no Chrome DevTools 94
Outros navegadores
Encontre testes de origem em outros navegadores: