Voltar aos guias

Web NFC: leia e grave tags direto do Chrome

O Chrome para Android fala com tags NFC direto de uma página web, sem instalar app. Veja como a API Web NFC realmente funciona, seu modelo de segurança e as diferenças reais entre uma aba do navegador e um app NFC dedicado.

Publicado

Resposta rápida

O Chrome para Android consegue ler e gravar tags NFC diretamente de uma página web, usando a interface NDEFReader da API Web NFC, sem precisar instalar nenhum app. O porém é o escopo: isso só funciona no Chrome para Android, apenas com tags formatadas em NDEF, e fica bem aquém do que um app dedicado consegue fazer. Não existe Web NFC no Chrome para desktop, nem no Safari do iOS. Veja como a pilha de NFC de cada plataforma realmente difere se você está comparando iOS e Android para um projeto.

Passo a passo

Lendo uma tag com NDEFReader

Você cria um leitor, chama scan() e escuta o evento reading:

const ndef = new NDEFReader();
ndef.scan().then(() => {
  ndef.onreading = (event) => {
    for (const record of event.message.records) {
      console.log("Record type:", record.recordType);
    }
  };
});

Na primeira vez que uma página chama scan(), o Chrome exibe o pedido de permissão "nfc". Essa chamada precisa partir de um toque ou clique real, e não do carregamento da página. Com a permissão concedida, cada tag que chega ao alcance dispara um evento reading com o número de série e os registros NDEF: texto, URL, smart poster, tipo MIME e alguns outros tipos de registro padrão. Antes de tudo, faça a detecção de recurso com 'NDEFReader' in window e trate o evento readingerror para tags que não respondem.

Gravando uma tag com segurança

A interface é a mesma para gravar, mas o padrão muda. A abordagem documentada é ler e depois gravar, não gravar às cegas: chame scan(), espere um evento reading para confirmar qual tag está de fato presente e só então chame write(). Isso evita que você sobrescreva uma tag que nunca pretendeu alterar.

const ndef = new NDEFReader();
await ndef.scan();
await ndef.write({ records: [{ recordType: "url", data: "https://example.com" }] });

write() aceita a opção overwrite para evitar apagar uma tag que já tem conteúdo e, desde o Chrome 100, makeReadOnly() trava a tag permanentemente contra qualquer gravação futura. Esse bloqueio não pode ser desfeito, então trate-o como uma porta de mão única.

Onde o modelo de segurança fica rígido

O Web NFC só funciona em contexto seguro (HTTPS) e somente em um frame de nível superior: um iframe incorporado não consegue usá-lo. Toda chamada a scan(), write() ou makeReadOnly() precisa vir de um gesto do usuário, e o Chrome ainda acrescenta uma regra de visibilidade em primeiro plano: o rádio NFC fica bloqueado sempre que a tela está desligada ou bloqueada, e a página precisa estar visível no momento em que você encosta a tag.

Essa combinação (HTTPS, gesto e apenas em primeiro plano) impede a leitura escondida por um serviço em segundo plano. Você sempre sabe quando uma página com Web NFC está lendo ou gravando, porque é você quem está aproximando o celular da tag.

Problemas comuns e soluções

"NDEFReader is undefined". Você não está no Chrome para Android. Esse é o limite real de plataforma do Web NFC, não um bug. Para iOS, Safari ou desktop, você precisa de um app nativo ou de um app dedicado para ler e gravar NFC, em vez de uma página web.

O pedido de permissão nunca aparece, ou scan() é rejeitado na hora. Verifique se a chamada está ligada a um manipulador de clique ou toque de verdade, e não a algo que roda no carregamento da página. O Chrome recusa chamadas sem gesto do usuário.

A gravação parece ter funcionado, mas nada mudou. Ou a tag não estava formatada em NDEF, ou ela saiu do campo do celular no meio da gravação. O Web NFC só fala NDEF, sem alternativa para outros formatos.

Fazendo isso especificamente no NFCore

Tudo o que o Web NFC não alcança (comandos ISO-DEP brutos, peer-to-peer, Host Card Emulation e qualquer senha de tag além do bloqueio de mão única do makeReadOnly()) é justamente onde um app nativo assume. O NFCore lê e grava as mesmas tags NDEF no iOS e no Android, além de operações de mais baixo nível que uma aba do navegador não alcança: gravação em lote em uma pilha de tags, modelos de gravação reutilizáveis e um inspetor de tags completo para conferir bytes de bloqueio e layout de memória antes de gravar qualquer coisa. Já passou do que uma aba do navegador consegue fazer? Há mais detalhes aqui. Baixe o NFCore na App Store ou no Google Play quando precisar desse alcance extra.

Perguntas frequentes

O Web NFC funciona no iPhone ou no Safari?

Não. O Web NFC (a API NDEFReader) só está disponível no Chrome para Android. O Safari no iOS não tem suporte a Web NFC, e não há nenhum sinal público de que isso vá mudar. O acesso da Apple ao NFC para terceiros passa pelo Core NFC nativo, e não pelo navegador.

Preciso instalar alguma coisa para usar o Web NFC?

Não precisa instalar nada: ele roda no Chrome para Android em uma página HTTPS comum. A contrapartida é o escopo: você tem leitura e gravação NDEF e nada de mais baixo nível, e a página precisa estar aberta e visível quando você encostar a tag.

Um site consegue ler qualquer tag NFC com o Web NFC?

Somente tags formatadas em NDEF, e apenas depois de você conceder explicitamente a permissão "nfc" e encostar a tag com a página aberta e visível. Não há leitura em segundo plano nem acesso a formatos que não sejam NDEF, como setores brutos de MIFARE Classic.

O que o Web NFC não faz e um app NFC nativo faz?

Ele não envia comandos ISO-DEP/APDU brutos, não faz NFC peer-to-peer nem Host Card Emulation, e não tem como definir uma senha na tag ou restringir o acesso de leitura e gravação. A única opção de proteção é o makeReadOnly(), que é permanente. Um app nativo como o NFCore cobre esse conjunto maior de comandos tanto no iOS quanto no Android.

Conclusão

O Web NFC é uma forma real, sem instalação, de ler e gravar tags NDEF a partir de uma página web, limitada por um modelo de segurança estrito (primeiro plano e permissão) e por um escopo apenas NDEF. Para qualquer coisa além disso, como outras plataformas, comandos brutos de tag ou proteger de fato uma tag que você gravou, é aí que um app dedicado assume.