Testar APIs e recursos experimentais usando avaliações de origem

Use as avaliações de origem para experimentar APIs experimentais (recursos) em seu próprio site ativo por um período limitado. Ao usar avaliações de origem, os usuários do Microsoft Edge que visitam seu site podem executar código que usa APIs experimentais.

Conteúdo detalhado:

Introdução

Para ver uma lista das avaliações de origem disponíveis e registrar sua origem para experimentar qualquer uma das avaliações de origem, consulte Avaliações de origem do Microsoft Edge. Para avaliar a adequação do uso das APIs experimentais em seu site, marque os requisitos mínimos de versão do Microsoft Edge e marque a data de expiração da avaliação.

Você pode fornecer comentários aos engenheiros de recursos do navegador e à comunidade de padrões da Web sobre o design da API do recurso, seus casos de uso ou sua experiência com o uso da API do recurso, usando a guia Issues no repositório do recurso do navegador.

Como funciona o token de teste de origem

O mecanismo de avaliações de origem permite que um usuário da página da Web use a API do recurso experimental da avaliação de origem no navegador Microsoft Edge, apesar do estado desativado por padrão do recurso. O navegador Microsoft Edge do usuário detecta o token da avaliação de origem e, em seguida, ativa automaticamente o sinalizador de recurso do navegador que corresponde à avaliação de origem para a qual o token é válido. O usuário não precisa definir nenhum edge://flags no Microsoft Edge.

Para dar suporte ao uso de APIs experimentais de uma avaliação de origem em seu site:

  1. Registre o domínio de origem no qual você deseja usar o recurso experimental (por exemplo, https://example.com), e um token de avaliação de origem será gerado para você.

  2. Copie o token para sua página da Web em um <head>/<meta> elemento ou em um cabeçalho de Origin-Trial resposta do servidor HTTP.

  3. Quando um usuário do Microsoft Edge visita sua página da Web e o navegador encontra um token de avaliação de origem, o navegador ativa o recurso de avaliação de origem associado.

Registrando-se para uma avaliação de origem

Para se registrar para uma avaliação de origem:

  1. Vá para Microsoft Edge Origin Trials.

  2. Selecione uma avaliação ativa.

  3. Clique no botão Aceito os Termos de Uso .

  4. Se for solicitado, entre. Por exemplo, entre no GitHub e autorize a página de Avaliações de Origem do Microsoft Edge a usar a entrada da conta.

    O formulário de registro do teste New Origin é aberto:

    Formulário de registro da avaliação do New Origin

  5. Na caixa de texto Domínio , digite uma URL de domínio (como https://example.com) ou uma URL de subdomínio (como https://beta.example.com).

    Você pode configurar o token de avaliação de origem para dar suporte a qualquer um dos seguintes:

    • Um único domínio, como https://example.com, sem oferecer suporte a seus subdomínios.
    • Um único subdomínio, como https://beta.example.com.
    • Um domínio, como https://example.com, e seus subdomínios, como https://beta.example.com.

    Não há suporte para caminhos à direita e parâmetros de consulta. Se for inserido um URI que tenha um caminho à direita ou um parâmetro de consulta, como https://example.com/path/new-feature, o domínio raiz (como https://example.com) ou subdomínio será registrado, ignorando qualquer caminho à direita ou parâmetros de consulta.

  6. Definir a opção Ativar token para subdomínios? alternar.

    • Para habilitar o uso da avaliação de origem em um domínio (como https://example.com) sem dar suporte a seus subdomínios (como https://beta.example.com), verifique se a opção Habilitar token para subdomínios? está desativada.

    • Para habilitar o uso da avaliação de origem somente em um subdomínio específico (como https://beta.example.com), verifique se a opção Habilitar token para subdomínios? está desativada.

    • Para habilitar o uso da avaliação de origem em um domínio (como https://example.com) e seus subdomínios (como https://beta.example.com), ative a opção Habilitar token para subdomínios? .

  7. Clique no botão Enviar .

    Um token de teste de origem é gerado e exibido na seção Registros próximo ao formulário Registro de Teste de Nova Origem :

    O token gerado exibido na seção Registro

  8. Clique no botão Copiar e cole o token de avaliação de origem em um local seguro, anotando a qual domínio ele se destina. Você também pode exibir essas informações nesta página da Web posteriormente.

Usar o token de avaliação de origem em seu site

Use o token em seu site de uma das seguintes maneiras:

Opção 1: uma <metatag> dentro do <elemento de cabeçalho> de uma página da Web

Dentro do <head> elemento de uma página da Web, inclua a seguinte <meta> tag:

<meta http-equiv="origin-trial" content="EXAMPLE_TOKEN">

Substitua EXAMPLE_TOKEN pelo token.

Opção 2: um cabeçalho HTTP na resposta do servidor HTTP

Na resposta do servidor HTTP, adicione o seguinte cabeçalho HTTP:

Origin-Trial: EXAMPLE_TOKEN

Substitua EXAMPLE_TOKEN pelo token.

Recusando participar de um experimento de avaliação de origem

Para desativar um experimento (teste de origem) no qual você está inscrito, remova o token de teste de origem da <meta> marca ou dos cabeçalhos de resposta do servidor.

Executando a detecção de recursos e fornecendo fallback normal

Trate os testes de origem como experimentais. Como prática recomendada, no código do site, execute a detecção de recursos e forneça fallback normal para estes casos:

  • Se a API do recurso experimental não estiver disponível no navegador do usuário.
  • Se o token de avaliação de origem expirar.
  • Se a equipe de recursos do Microsoft Edge encerrar a avaliação de origem.

Consulte Implementando a detecção de recursos no MDN.

Testar um teste de origem em localhost

Para testar um recurso de avaliação de origem em localhost, acesse edge://flags e ative o sinalizador de recurso apropriado.

O mecanismo que detecta e usa tokens de teste de origem do Microsoft Edge só tem suporte para domínios habilitados para SSL, não para localhost.

Renovar um token de avaliação de origem

Os tokens de teste do Origin expiram em 6 semanas, por padrão. Quando o token de avaliação de origem expirar, você deverá renová-lo, o que significa gerar um token novo e novo para essa avaliação de origem. Você pode renovar o token antes que ele expire.

Para renovar um token de avaliação de origem:

  1. Vá para Microsoft Edge Origin Trials.

  2. Na seção Minhas avaliações registradas , selecione uma avaliação de origem.

  3. Na seção Registros , em uma linha de token que contém um selo Expirado , clique no botão Renovar :

    UI para renovar um token

    Um novo token é gerado e exibido.

  4. Na linha que contém o novo token, clique no botão Copiar e cole o novo token em seu código.

Duração de um teste de origem

Um teste de origem pode durar até a data de expiração planejada ou pode terminar mais cedo.

Data de expiração agendada

Depois de se registrar para uma avaliação, seu token permanece válido até a data de expiração da avaliação mostrada no card informativo da avaliação de origem. Após a data de expiração da avaliação de origem, o token não funcionará mais e o recurso associado à avaliação de origem será considerado pronto para ser enviado ou o recurso será retido para desenvolvimento posterior.

Término antecipado

Uma equipe de recursos do Microsoft Edge pode decidir encerrar um experimento antecipadamente, antes da data de expiração da avaliação; Por exemplo:

  • Se um incidente de segurança for causado pelo recurso.
  • Se a equipe de recursos coletou comentários suficientes e concluiu que a API proposta atualmente não atende às necessidades dos desenvolvedores da Web, uma grande reformulação precisa acontecer.

Se um experimento terminar mais cedo, a equipe de recursos proprietária da avaliação de origem enviará emails para todos os desenvolvedores inscritos no experimento.

Fornecendo comentários sobre uma avaliação de origem

Forneça comentários sobre o recurso experimental. A guia Issues do repositório GitHub do recurso permite o discurso público sobre a usabilidade e a estabilidade do recurso.

Para fornecer comentários sobre uma avaliação de origem:

  1. Vá para Microsoft Edge Origin Trials.

  2. Selecione uma avaliação ativa.

  3. Clique no botão Comentários . A guia Issues do repositório GitHub do produto é aberta.

  4. Veja os problemas.

  5. Se um novo problema for necessário, clique no botão Novo problema .

Consulte também

Externo:

  • Last updated on