Começar os testes de origem

Testar um recurso novo ou experimental de plataforma da Web.

Sam Dutton

Os testes de origem oferecem acesso a um recurso novo ou experimental para criar funcionalidades que os usuários podem testar por um tempo limitado antes que o recurso seja disponibilizado para todos.

Quando o Chrome oferece um teste de origem para um recurso, você pode se registrar para o teste para ativar o recurso para todos os usuários na sua origem, sem exigir que eles alternem nenhuma sinalização ou mudem para uma versão alternativa do Chrome (embora possam precisar fazer upgrade). Os testes de origem permitem que os desenvolvedores criem demonstrações e protótipos usando novos recursos. Os testes também ajudam os engenheiros do Chrome a entender como novos recursos são usados e como eles podem interagir com outras tecnologias da Web.

Os testes de origem são públicos e abertos a todos os desenvolvedores. Eles são limitados em duração e uso. A participação é um processo autogerenciado com documentação e suporte limitados. Os participantes precisam estar dispostos e capazes de trabalhar de maneira relativamente independente usando a documentação disponível, que, nesta fase, provavelmente está limitada a especificações e explicações da API, embora tentemos fornecer orientação sempre que possível.

Se você se inscrever para um teste, a equipe do Chrome solicitará periodicamente um feedback específico sobre seu 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 o Firefox e o Microsoft Edge.

Testes de origem de terceiros

Os testes de origem geralmente só estão disponíveis em sistemas próprios: eles funcionam apenas para uma única origem registrada. Com os testes de origem de terceiros, os provedores de conteúdo incorporado podem testar 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

Nem todos os testes de origem servem para testar novas APIs. Alguns testes permitem que um recurso descontinuado seja reativado temporariamente. Eles são conhecidos como testes de descontinuação e, em alguns contextos, foram chamados de testes de origem "reversos".

Por exemplo, no Chrome 85, o AppCache não está mais disponível no Chrome por padrão. Os sites que precisarem de mais tempo para migrar do AppCache poderão ser registrados no teste de descontinuação para continuar usando o AppCache até o Chrome 93.

Participar de um teste de origem

  1. Escolha um teste de origem na lista de testes ativos.
  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 ativar o recurso de teste:
  4. Teste o novo recurso.
  5. Enviar feedback. Para isso, acesse o 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 inclui um link para feedback espontâneo da comunidade. Isso normalmente aponta para o recurso no GitHub ou em algum outro canal público.
  6. Quando seu token expirar, você vai receber um e-mail com um link de renovação. Para fazer isso, será solicitado novamente que você envie feedback.

É possível fazer o 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 disponibilizados de diferentes origens, como código incluído em vários sites de sua propriedade.

O framework de testes de origem procura o primeiro token válido e ignora todos os outros tokens. Você pode 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 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 esse 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 de forma programática.

Assim 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 a src de um elemento <script> para JavaScript incluído em um arquivo externo.

Tokens e extensões

Para usar um recurso de teste dentro de um script em segundo plano, pop-up ou documento fora da tela, adicione um trial_token ao arquivo manifesto.json.

Os scripts de conteúdo são tratados de maneira diferente. A exposição de um recurso a um mundo pode ser confusa e pouco intuitiva. Em vez de usar o trial_token do manifesto, adicione o token à página inserindo um cabeçalho usando declaritiveNetRequest ou de maneira programática diretamente no script de conteúdo. Lembre-se de que os tokens estão vinculados a domínios específicos, portanto, convém registrá-los para o 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 inscrição no teste de origem

Se um teste de origem for estendido, você vai receber um aviso por e-mail de que precisa renovar o registro e fornecer um novo token para cada origem inscrita no teste.

  1. Navegue até a página My Registration.

  2. Para cada origem registrada para o teste estendido, clique no botão RENEW. Captura de tela da página &quot;Meus registros&quot; do teste de origem do Chrome, mostrando os botões &quot;RENEW&quot;

  3. Copie o novo token e disponibilize-o para todas as páginas que precisam permanecer inscritas no teste. Se necessário, você pode fornecer vários tokens. O Chrome ignora os inválidos ou expirados.

Ver informações sobre testes de origem

Confira informações sobre os testes de origem disponíveis em uma página do painel Application no Chrome DevTools.

Informações do teste de origem de um site exibidas na visualização de detalhes do frame do painel **Application** do Chrome DevTools.

Você também pode usar nosso decodificador de token de teste de origem para visualizar os dados codificados em um token.

Ferramenta decodificador de teste de origem que mostra valores decodificados de teste de origem.

Demonstrações de testes de origem

Saiba mais