Compartilhar via

Utilizar avaliações de origem no Microsoft Edge

  • Artigo

Utilize as avaliações de origem para experimentar APIs experimentais no seu próprio site em direto durante um período de tempo limitado. Ao utilizar as avaliações de origem, os utilizadores do Microsoft Edge que visitam o seu site podem executar código que utiliza APIs experimentais.

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

Pode fornecer feedback aos engenheiros de funcionalidades do browser e à comunidade de padrões Web sobre a conceção da API da funcionalidade, os seus casos de utilização ou a sua experiência com a utilização da API da funcionalidade, através do separador Problemas no repositório da funcionalidade do browser.

Como funciona o token de avaliação de origem

O mecanismo origin-trials permite que um utilizador da sua página Web utilize a API de funcionalidade experimental da versão de origem no browser Microsoft Edge, apesar do estado off-by-default da funcionalidade. O browser Microsoft Edge do utilizador deteta o token da versão de avaliação de origem e, em seguida, ativa automaticamente o sinalizador de funcionalidade do browser que corresponde à versão de avaliação de origem para a qual o token é válido. O utilizador não precisa de definir nenhum edge://flags no Microsoft Edge.

Para suportar a utilização de APIs experimentais de uma avaliação de origem no seu site:

  1. Registe o domínio de origem no qual pretende utilizar a funcionalidade experimental (por exemplo, ) e, em seguida, https://example.comé gerado um token de avaliação de origem automaticamente.

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

  3. Quando um utilizador do Microsoft Edge visita a sua página Web e o browser encontra um token de avaliação de origem, o browser ativa a funcionalidade de avaliação de origem associada.

Registar-se numa versão de avaliação de origem

Para se registar numa versão de avaliação de origem:

  1. Aceda a Avaliações de Origem do Microsoft Edge.

    Para se inscrever na versão de avaliação da origem da API de Seleção de Anúncios, veja Inscrever-se na API de Seleção de Anúncios.

  2. Selecione uma avaliação ativa.

  3. Clique no botão Aceito os Termos de Utilização .

  4. Se lhe for pedido, inicie sessão. Por exemplo, inicie sessão no GitHub e, em seguida, autorize a página Avaliações de Origem do Microsoft Edge a utilizar o início de sessão da conta.

    O formulário Novo Registo de Avaliação de Origem é aberto:

    Novo formulário de Registo de Avaliação de Origem

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

    Pode configurar o token de avaliação de origem para suportar qualquer um dos seguintes:

    • Um único domínio, como https://example.com, sem suportar os respetivos subdomínios.
    • Um único subdomínio, como https://beta.example.com.
    • Um domínio, como https://example.com, e os respetivos subdomínios, como https://beta.example.com.

    Os caminhos à direita e os parâmetros de consulta não são suportados. Se for introduzido um URI com um caminho à direita ou um parâmetro de consulta, como https://example.com/path/new-feature, o domínio de raiz (como https://example.com) ou subdomínio será registado, ignorando qualquer caminho à direita ou parâmetros de consulta.

  6. Defina o botão de alternar Ativar token para subdomínios? .

    • Para ativar a utilização da versão de avaliação de origem num domínio (como https://example.com) sem suportar os respetivos subdomínios (como https://beta.example.com), certifique-se de que o botão ativar token para subdomínios? está desativado .

    • Para ativar a utilização da versão de avaliação de origem apenas num subdomínio específico (como https://beta.example.com), certifique-se de que o botão ativar token para subdomínios? está desativado .

    • Para ativar a utilização da versão de avaliação de origem num domínio (como https://example.com) e os respetivos subdomínios (como https://beta.example.com), ative o botão de alternar Ativar token para subdomínios?

  7. Clique no botão Submeter .

    É gerado um token de avaliação de origem e é apresentado na secção Registos junto ao formulário Novo Registo de Avaliação de Origem :

    O token gerado apresentado na secção Registo

  8. Clique no botão Copiar e, em seguida, cole o token de avaliação de origem num local seguro, observando para que domínio se trata. Também pode ver estas informações nesta página Web mais tarde.

Utilizar o token de avaliação de origem no seu site

Utilize o token no seu site de qualquer uma das seguintes formas:

Opção 1: uma <meta> tag no <elemento principal> de uma página Web

<head> No elemento de uma página Web, inclua a seguinte <meta> etiqueta:

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

Optar ativamente por não participar numa experimentação de avaliação de origem

Para optar ativamente por não participar numa experimentação (avaliação de origem) na qual está inscrito, remova o token de avaliação de origem <meta> da etiqueta ou dos cabeçalhos de resposta do servidor.

Realizar a deteção de funcionalidades e proporcionar uma contingência correta

Tratar os ensaios de origem como experimentais. Como melhor prática, no código do seu site, execute a deteção de funcionalidades e forneça uma contingência correta para estes casos:

  • Se a API de funcionalidade experimental não estiver disponível no browser do utilizador.
  • Se o token de avaliação de origem expirar.
  • Se a equipa de funcionalidades do Microsoft Edge terminar a avaliação de origem.

Veja Implementar a deteção de funcionalidades no MDN.

Testar uma versão de avaliação de origem em localhost

Para testar uma funcionalidade de avaliação de origem em localhost, aceda a edge://flags e ative o sinalizador de funcionalidade adequado.

O mecanismo que deteta e utiliza tokens de avaliação de origem do Microsoft Edge só é suportado para domínios compatíveis com SSL, não para localhost.

Renovar um token de avaliação de origem

Os tokens de avaliação de origem expiram dentro de 6 semanas, por predefinição. Quando o token de avaliação de origem expirar, tem de renovar o token, o que significa gerar um novo token para esta versão de avaliação de origem. Pode renovar o token antes de expirar.

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

  1. Aceda a Avaliações de Origem do Microsoft Edge.

    Para a versão de avaliação da origem da API de Seleção de Anúncios, veja Inscrever-se na API de Seleção de Anúncios.

  2. Na secção As Minhas Avaliações Registadas , selecione uma avaliação de origem.

  3. Na secção Registos , numa linha de token que contém um distintivo Expirado , clique no botão Renovar :

    IU para renovar um token

    É gerado e apresentado um token novo.

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

Duração de uma avaliação de origem

Uma avaliação de origem pode durar até à data de expiração planeada ou pode terminar mais cedo.

Data de expiração agendada

Depois de se registar numa avaliação, o token permanece válido até à data de expiração da versão de avaliação apresentada no card informativo da avaliação de origem. Após a data de expiração da avaliação de origem, o token deixará de funcionar e a funcionalidade associada à versão de avaliação de origem será considerada pronta para ser enviada ou a funcionalidade será retida para desenvolvimento adicional.

Fim antecipado

Uma equipa de funcionalidades do Microsoft Edge pode decidir terminar uma experimentação mais cedo, antes da data de expiração da avaliação; Por exemplo:

  • Se um incidente de segurança for causado pela funcionalidade.
  • Se a equipa de funcionalidades tiver recolhido feedback suficiente e tiver concluído que a API atualmente proposta não satisfaz as necessidades dos programadores Web e é necessário que ocorra uma remodelação importante.

Se uma experimentação terminar mais cedo, a equipa de funcionalidades proprietária da avaliação de origem envia e-mails a todos os programadores inscritos na experimentação.

Fornecer feedback sobre uma versão de avaliação de origem

Envie feedback sobre a funcionalidade experimental. O separador Problemas do repositório do GitHub da funcionalidade permite um discurso público sobre a usabilidade e a estabilidade da funcionalidade.

Para fornecer feedback sobre uma avaliação de origem:

  1. Aceda a Avaliações de Origem do Microsoft Edge.

  2. Selecione uma avaliação ativa.

  3. Clique no botão Feedback . É aberto o separador Problemas do repositório do GitHub do produto.

  4. Veja os problemas.

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

Para a versão de avaliação da origem da API de Seleção de Anúncios, veja Fornecer feedback sobre a versão de avaliação de origem em Inscrever-se na API de Seleção de Anúncios.

Consulte também

API de Seleção de Anúncios:

Externo: