Começar os testes de origem

Teste um recurso novo ou experimental da plataforma da Web.

Sam Dutton

Os testes de origem dão acesso a um recurso novo ou experimental para que você possa testá-lo e oferecê-lo aos usuários por um período limitado. Depois que o teste é concluído e o feedback é avaliado, o Chrome decide se o recurso deve 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 exigir que eles ativem flags ou mudem para uma versão alternativa do Chrome (embora talvez seja necessário fazer um 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. Eles têm duração e uso limitados. A participação é um processo autogerenciado com documentação e suporte limitados. Os participantes precisam estar dispostos e aptos a trabalhar de forma relativamente independente usando a documentação disponível, que, nesta fase, provavelmente se limita a especificações e explicações da API. Tentamos fornecer orientações sempre que possível.

Se você se inscrever em um teste, a equipe do Chrome vai pedir feedback específico sobre o uso do recurso de teste. 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 exigir 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 reativar temporariamente um recurso descontinuado. Eles são conhecidos como testes de descontinuação. Em alguns contextos, eles são chamados de testes de origem "reversos".

Por exemplo, os eventos de mutação foram removidos, a partir do Chrome 127. Os sites que precisavam de mais tempo antes de remover esses eventos podem se inscrever no teste de descontinuação para reativar os eventos temporariamente em sites especificados.

Participe de um teste de origem

  1. Escolha um teste de origem na lista de testes ativos de testes.
  2. Solicite um token clicando no botão Registrar e preenchendo o formulário.
  3. Forneça o token em todas as páginas da Web em que você quer que o recurso de teste seja ativado:
  4. Teste o novo recurso.
  5. Envie feedback. Faça isso pelo 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 fornece um link para feedback espontâneo da comunidade. Normalmente, ele aponta para o recurso no GitHub ou em algum outro canal público.
  6. Quando o token expirar, você vai receber um e-mail com um link de renovação. Para fazer isso, você precisa enviar feedback novamente.

É possível 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 origens diferentes, como código incluído em vários sites que você possui.

A estrutura 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 página, conforme descrito anteriormente, você pode injetar um token com JavaScript:

const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);

Use esse método se estiver participando de um teste de terceiros.

Tokens e iframes

Para acessar um recurso de teste de um iframe, você pode fornecer um token de teste em uma metatag, um cabeçalho HTTP ou de maneira programática.

Como para todo o uso de tokens, 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 <script> elemento para JavaScript incluído em um arquivo externo.

Tokens e extensões

Para usar um recurso de teste em um script de segundo plano, pop-up, painel lateral, ou documento fora da tela, use a trial_tokens chave no seu arquivo manifest.json.

"trial_tokens": ["AnlT7gRo/750gGKtoI/A3D2rL5yAQA9wISlLqHGE6vJQinPfk0HiIij5LhWs+iuB7mTeotXmEXkvdpOAC1YjAgAAAG97Im9yaWdpbiI6ImNocm9tZS1leHRlbnNpb246Ly9sampoamFha21uY2lib25uanBhb2dsYmhjamVvbGhrayIsImZlYXR1cmUiOiJJQ2Fubm90QmVsaWV2ZVlvdVdhc3RlZFlvdXJUaW1lRGVjb2RpbmdUaGlzIiwiZXhwaXJ5Ijo1NzI1NDA3OTk5fQ=="]

Os scripts de conteúdo são processados de maneira diferente. Expor um recurso a um mundo pode ser confuso e não intuitivo. Em vez de usar o trial_token do manifesto, adicione o token à página de uma das seguintes maneiras:

Lembre-se de que os tokens estão vinculados a domínios específicos. Portanto, é necessário se registrar no domínio em que o script de conteúdo está sendo executado, em vez do 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 de origem

Se um 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.

  1. Acesse Meus registros.
  2. Para cada origem registrada no teste estendido, clique em RENOVAR. Exemplo da página &quot;Minhas inscrições&quot; com botões &quot;RENOVAR&quot;
  3. Copie o novo token e disponibilize-o para todas as páginas que precisam permanecer inscritas no teste. Você pode fornecer vários tokens, se necessário.

O Chrome ignora tokens inválidos ou expirados.

Conferir informações sobre o teste de origem

Confira informações sobre os testes de origem disponíveis para um site no painel Application do Chrome DevTools.

Visualização de detalhes do frame do painel &quot;Aplicativo&quot; do Chrome DevTools.

Recursos no teste de origem

A seguir, confira demonstrações de APIs em testes de origem em andamento

Recursos

Continue lendo nossa documentação de conceitos do Chrome:

Saiba mais sobre os testes de origem no Chrome:

Outros navegadores

Encontre testes de origem em outros navegadores:

Anterior
Variações do Chrome
Avançar
Testes de origem de terceiros