As solicitações de permissão são o principal mecanismo da Web para proteger recursos poderosos que podem ser perigosos para a privacidade e a segurança dos usuários. Com as solicitações de permissão, os navegadores garantem que o usuário possa permitir que o site solicitante acesse o recurso em questão. As solicitações de permissão são usadas para várias APIs, incluindo captura de mídia (câmera e microfone), geolocalização, acesso ao armazenamento, MIDI e notificações. Consulte a documentação da API Permissions no MDN para mais informações.
Este guia descreve as práticas recomendadas para mostrar solicitações de permissão aos usuários com base nas estatísticas de uso do Chrome e na pesquisa de usuários. Ao seguir essas práticas recomendadas, os usuários encontrarão menos comandos desnecessários, o que vai fazer com que os desenvolvedores tomem menos decisões de "bloqueio". O artigo termina com alguns padrões de código para trabalhar com APIs com permissão e práticas recomendadas para ajudar os usuários a sair de um estado bloqueado.
Práticas recomendadas para a solicitação
Você precisa pedir permissão após uma interação do usuário, em um momento em que os usuários possam entender por que você está pedindo e qual benefício eles vão receber ao permitir. Sempre que possível, permita que os usuários utilizem um meio alternativo para realizar a mesma funcionalidade. Como regra geral, pedir permissão com menos frequência escolhendo os momentos em que você pede com cuidado reduz as chances de os usuários ficarem em um estado bloqueado difícil de recuperar. As práticas recomendadas a seguir oferecem mais detalhes sobre cada uma dessas sugestões.
Nunca perguntar no carregamento da página ou sem interação do usuário
Pedir permissão aos usuários no carregamento da página é equivalente a pedir uma informação sensível a um cliente quando ele entra em uma loja física. Ver uma permissão (talvez entre várias outras para inscrição em newsletter e consentimento de cookies) é uma experiência muito desagradável. Os usuários não vão entender por que estão sendo solicitados e como vão se beneficiar.
Mesmo que seu aplicativo da Web não possa funcionar sem acesso a um determinado recurso, você deve dar aos usuários uma chance de entender por que ele é necessário. Por exemplo, coloque uma solicitação de permissão com uma solicitação sua que explique a necessidade e dê aos usuários uma escolha. Por exemplo, sempre que possível, forneça meios alternativos para realizar a mesma funcionalidade. Se você não consegue pensar em um momento melhor para pedir permissão do que no carregamento da página, há alguns exemplos mais adiante neste guia.
Uma situação igualmente ruim para pedir permissão é sem uma interação anterior do usuário (também conhecida como ativação temporária do usuário). A telemetria do Chrome mostra que 77% das solicitações de permissão no Chrome para computador são mostradas sem um indicador muito básico da intenção do usuário. Consequentemente, apenas 12% dessas solicitações são permitidas. Após uma interação do usuário, permita que as taxas aumentem para 30%. Portanto, só peça permissão depois que o usuário interagir com a página de algum formato.
Só faça perguntas quando os usuários entenderem por que você está perguntando
As decisões de permissão geralmente são decisões de privacidade. Com base no framework de integridade contextual, sabemos que as decisões de privacidade são altamente contextuais. Entender por que um acesso é necessário pode ser considerado um aspecto importante disso. Portanto, solicite apenas os recursos necessários para oferecer valor aos usuários (e em que os usuários provavelmente concordarão que vão receber valor). Além disso, peça a permissão em um momento em que fique claro para o usuário por que o recurso é útil. O objetivo é facilitar ao máximo que os usuários entendam o contexto de uso.
Nossa pesquisa de usuários mostra que os usuários têm muito mais chances de permitir o acesso quando entendem por que um site está pedindo acesso e também percebem um benefício. Também descobrimos que os usuários esperam explorar sites desconhecidos primeiro para entender melhor o valor que podem receber ao permitir o acesso. Eles geralmente dispensam ou ignoram solicitações de permissão nesse meio tempo. Com permissões únicas, eles podem permitir uma única visita primeiro. O aplicativo precisa oferecer suporte a esses comportamentos.
Fornecer meios alternativos para realizar a mesma funcionalidade sempre que possível.
O resultado de alguns recursos pode não ser útil para os usuários. Por exemplo, a geolocalização de um dispositivo de computador sem um sensor de GPS pode retornar o local errado porque a pessoa está conectada a uma VPN. Outros usuários podem não querer fornecer acesso à área de transferência porque preferem manter o controle e acionar esses eventos manualmente com combinações de teclas. Em situações como essas, é importante oferecer uma alternativa para alcançar os mesmos resultados. Por exemplo, se você estiver solicitando permissão de geolocalização, ofereça um campo de texto em que os usuários possam inserir um CEP ou endereço. Com a área de transferência, verifique se os elementos a serem copiados também podem ser selecionados e copiados por uma combinação de teclas ou pelo menu de contexto. Com as notificações, ofereça a opção de receber e-mails em vez de notificações push.
Um padrão útil é usar a interface alternativa também como uma explicação do motivo pelo qual o acesso pode ser benéfico. Os usuários que veem a opção de inserir um local ao lado de um botão que aciona a API de geolocalização se sentirão no controle do que acontecerá, porque entendem que também podem simplesmente digitar o endereço. Da mesma forma, se houver uma escolha entre receber notificações por push ou e-mail ou participar de uma reunião sem permitir o acesso à câmera e ao microfone, os usuários vão entender de forma mais natural as trocas que estão fazendo.
Não fique em um estado bloqueado, é difícil se recuperar
Depois que um usuário decide não permitir o acesso permanente a um recurso com permissão restringida, os navegadores respeitam essa decisão. Se fosse possível continuar solicitando o acesso, sites mal-intencionados continuariam bombardeando os usuários com solicitações. Portanto, a recuperação do estado bloqueado de um capability exige um pouco de esforço do usuário. Portanto, evite pedir permissão aos usuários em situações em que muitos deles provavelmente não vão permitir o acesso.
Uma maneira comum de fazer isso é usar um pré-prompt, em que você explica aos usuários o que está prestes a acontecer e por que o app precisa da capacidade que você vai solicitar. Só quando os usuários reagirem afirmativamente a esse pré-prompt, você poderá acionar a solicitação de permissão do navegador. Há situações em que os usuários podem precisar se recuperar desse estado. Consulte a seção Ajudar os usuários a se recuperar de um estado bloqueado para mais informações.
Preste atenção ao conteúdo de terceiros
Há uma origem inesperada de solicitações de permissão. Se você incluir scripts de terceiros no seu site, eles poderão acionar solicitações de permissão que você não pretendia mostrar. Isso pode afetar a experiência dos usuários no seu site, especialmente se essas solicitações não seguirem as práticas recomendadas já detalhados. Para manter o controle das experiências dos usuários, leia com atenção a documentação de todas as bibliotecas e scripts de terceiros que você adicionar ao seu código.
Quando pedir permissão
Confira alguns exemplos de momentos que funcionam bem para pedir permissão, seguindo as práticas recomendadas já descritas:
- Depois que um usuário clica em um botão que diz "Usar meu local" ao lado de um campo de formulário para inserir um endereço manualmente.
- Depois que um usuário se inscreveu em um canal de vídeo ou postagens e clicou em um botão de confirmação em uma caixa de diálogo que descreve que as atualizações podem ser enviadas como e-mails ou notificações para o smartphone ou computador.
- Depois que um usuário chega a uma página que o prepara para participar de uma videochamada e responde afirmativamente que quer ser visto e ouvido em uma solicitação prévia (consulte este estudo de caso do Google Meet).
Padrões de código para solicitar permissão
A permissão para usar uma API é concedida de maneiras diferentes, dependendo da
API. Algumas APIs (geralmente mais antigas) usam um modelo em que o navegador solicita automaticamente
a permissão na primeira vez que você tenta usar a API. Um exemplo é a
API Geolocation ao chamar
navigator.geolocation.getCurrentPosition()
.
try {
navigator.geolocation.getCurrentPosition((pos) => console.log(pos));
} catch (error) {
console.error(error);
}
Outras APIs usam um modelo em que você precisa solicitar explicitamente a permissão primeiro
usando um método estático. Um bom exemplo é o
Notification.requestPermission()
,
para permitir notificações, ou o método menos comum
DeviceOrientationEvent.requestPermission()
,
que faz parte da API Device Orientation Events. Alguns navegadores podem
conceder permissão automaticamente para determinadas APIs. Por exemplo, o Chrome sempre permite
o acesso à orientação de um dispositivo, enquanto o Safari mostra uma solicitação.
const result = await DeviceOrientationEvent.requestPermission();
console.log(`The user's decision when prompted to use the Device Orientation
Events API was: ${result}.`);
if (result === 'granted') {
/* Use the API. */
}
Como verificar o estado das permissões
Para verificar se você pode usar uma determinada API, use o método
navigator.permissions.query()
da API Permissions.
const result = await navigator.permissions.query({ name: 'geolocation' });
console.log(`The result of querying for the Geolocation API is:
${result.state}.`);
if (result.state === 'granted') {
// Use the API.
}
Ajudar os usuários a sair de um estado bloqueado
Para ajudar os usuários a resolver problemas de acesso, detecte que eles bloquearam o acesso usando a API Permissions e ofereça um guia sobre como mudar as configurações. Por exemplo, quando os usuários interagem com elementos da interface associados a um recurso com permissão, use o padrão descrito na seção anterior e abra uma caixa de diálogo de solução de problemas. As etapas exatas para alterar o estado de permissão variam de acordo com o navegador. Por isso, talvez seja melhor oferecer descrições correspondentes com base na string do user agent e nos navegadores mais usados no seu produto.
No Chrome, os usuários precisam acessar os Controles do site clicando no ícone "sintonizar" no lado esquerdo da barra de endereço. Aqui, eles podem ativar a permissão respectiva. Em alguns casos, pode ser necessário recarregar a página antes de usar o recurso. Nesse caso, uma barra de mensagens vai aparecer na parte de cima da janela e oferecer a opção de recarregar ao clicar no botão correspondente.
Há interfaces semelhantes para controlar permissões em outros navegadores (por exemplo, veja como isso funciona no Firefox).