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 criar funcionalidade que seus usuários podem testar por um tempo limitado antes que o recurso seja ser disponibilizados a todos.

Quando o Chrome oferece um teste de origem para um recurso, você pode se inscrever nele. para ativar o recurso para todos os usuários no seu origin, sem solicitá-las para alternar as flags ou para uma versão alternativa do Chrome (embora possam precisam atualizar). 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. Elas são limitadas duração e uso. A participação é um processo autogerenciado com limitações documentação e suporte. Os participantes devem estar dispostos e capazes de trabalhar de forma relativamente independente usando a documentação disponível, que, etapa, provavelmente serão limitadas a especificações e explicações da API, embora tente orientar sempre que possível.

Se você se registrar para uma avaliação, a equipe do Chrome solicitará periodicamente feedback específico sobre o uso do recurso de teste. Alguns recursos podem passar vários testes de origem, já que o feedback é incorporado e ajustes são feitos.

Os testes de origem também estão disponíveis para Firefox e Microsoft Edge (em inglês).

Testes de origem de terceiros

Os testes de origem geralmente estão disponíveis apenas para dados próprios: eles só funcionam para uma única origin registrada. Os testes de origem de terceiros possibilitam que provedores de conteúdo incorporado testar um novo recurso em vários sites sem precisar de um token para cada origem.

Saiba mais: O que são origens de terceiros testes?

Testes de descontinuação

Nem todos os testes de origem são para testar novas APIs. Alguns testes ativam uma versão descontinuada que o recurso seja reativado temporariamente. Isso é conhecido como testes de descontinuação, e, em alguns contextos, foram chamadas de "reverso" testes de origem.

Por exemplo, do Chrome 85 O AppCache é "não" estão disponíveis no Chrome por padrão. Sites que precisam de mais tempo para migrar O AppCache pode se registrar 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 testes.
  2. Solicite um token clicando no botão Register e preenchendo o forma
  3. Forneça o token em todas as páginas da Web para as quais você quer que o recurso de teste ser ativados:
  4. Teste o novo recurso.
  5. Enviar feedback. Faça isso no site de testes de origem. Esse feedback não é pública e está disponível apenas para um grupo limitado de pessoas no Chrome equipe. Cada teste também fornece um link para feedback espontâneo da comunidade. Isso normalmente aponta para o recurso no GitHub ou algum outro canal público.
  6. Quando seu token expirar, você vai receber um e-mail com um link de renovação. Afazeres Por isso, você será solicitado novamente a enviar feedback.

Você pode se registrar para o mesmo teste de origem várias vezes, para diferentes origens e incluem vários tokens na mesma página. Isso pode ser útil se você precisam fornecer tokens válidos para recursos veiculados por 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, em seguida, ignora todas as e outros tokens. Você pode validar isso com o Chrome DevTools.

Fornecer um token de maneira programática

Em vez de fornecer um token como cabeçalho HTTP ou metatag no HTML de 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 um metatag, um cabeçalho HTTP ou de maneira programática.

Para todos os usos de tokens, a origem registrada para o token deve corresponder ao contexto do JavaScript que acessa o recurso de teste: a origem do inclui um script in-line ou o src de um elemento <script> para JavaScript incluído de um arquivo externo.

Tokens e extensões

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

Os scripts de conteúdo são tratados de maneira diferente. Expor um recurso a um mundo pode ser confuso e pouco intuitivo. Em vez de usar o trial_token do manifesto, adicione o token na página inserindo um cabeçalho usando declarativeNetRequest ou de forma programática diretamente no script de conteúdo. Lembre-se de que os tokens são vinculados a domínios específicos. Assim, convém registrar um para o domínio no qual o script de conteúdo está sendo executado, em vez do seu ID de extensão.

Para registrar sua extensão para 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 aviso por e-mail informando que precisa renovar o registro e fornecer um novo token para cada origem inscrita julgamento.

  1. Acesse Meus registros. página.

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

  3. Copie o novo token e disponibilize-o para todas as páginas que devem permanecer inscritos no teste. É possível fornecer vários tokens, se necessário: 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 uma página no Painel Aplicativo no Chrome DevTools (em inglês).

Teste de origem informações 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 do teste de origem, mostrando valores decodificados do teste.

Demonstrações de testes de origem

Saiba mais