Retour aux guides

Web NFC : lire et écrire des tags NFC directement depuis Chrome

Chrome pour Android peut dialoguer avec des tags NFC directement depuis une page web, sans installer d'appli. Voici comment fonctionne vraiment l'API Web NFC, son modèle de sécurité et les vraies différences entre un onglet de navigateur et une appli NFC dédiée.

Publié

Réponse rapide

Chrome pour Android peut lire et écrire des tags NFC directement depuis une page web, grâce à l'interface NDEFReader de l'API Web NFC, sans installer d'appli. Le bémol, c'est la portée : cela ne fonctionne que dans Chrome sur Android, uniquement avec des tags au format NDEF, et reste loin de ce qu'une appli dédiée sait faire. Il n'y a pas de Web NFC dans Chrome sur ordinateur, ni dans Safari sur iOS : consultez les différences réelles entre les piles NFC de chaque plateforme si vous hésitez entre iOS et Android pour un projet.

Pas à pas

Lire un tag avec NDEFReader

Vous créez un lecteur, vous appelez scan(), puis vous écoutez l'événement reading :

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

scan() déclenche la demande d'autorisation « nfc » de Chrome la première fois qu'une page l'appelle. L'appel doit provenir d'un vrai toucher ou clic, pas du chargement de la page. Une fois l'autorisation accordée, chaque tag qui passe à portée déclenche un événement reading contenant son numéro de série ainsi que ses enregistrements NDEF : texte, URL, smart poster, type MIME et quelques autres types d'enregistrements standard. Commencez par détecter la fonctionnalité avec 'NDEFReader' in window, et gérez readingerror pour les tags qui ne répondent pas.

Écrire sur un tag en toute sécurité

C'est la même interface pour l'écriture, mais avec un schéma différent. L'approche documentée consiste à scanner puis écrire, et non à écrire à l'aveugle : appelez scan(), attendez un événement reading pour confirmer quel tag est réellement présent, puis appelez write(). C'est ce qui évite d'écraser un tag que vous ne vouliez pas toucher.

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

write() accepte une option overwrite pour éviter d'écraser un tag qui contient déjà des données, et depuis Chrome 100, makeReadOnly() verrouille définitivement un tag contre toute écriture future. Ce verrouillage est irréversible : considérez-le comme une porte à sens unique.

Là où le modèle de sécurité se durcit

Web NFC ne fonctionne que dans un contexte sécurisé (HTTPS) et uniquement dans un cadre de premier niveau : une iframe intégrée ne peut pas y accéder. Chaque appel à scan(), write() ou makeReadOnly() doit provenir d'un geste de l'utilisateur, et Chrome ajoute une règle de visibilité au premier plan : la puce NFC est bloquée dès que l'écran est éteint ou verrouillé, et la page doit être visible au moment où vous approchez le tag.

Cette combinaison (HTTPS, geste, premier plan uniquement) exclut tout scan discret depuis un service en arrière-plan. Vous savez toujours qu'une page Web NFC est en train de lire ou d'écrire, puisque c'est vous qui approchez votre téléphone du tag.

Problèmes courants et solutions

« NDEFReader is undefined. » Vous n'êtes pas sur Chrome pour Android : c'est la vraie limite de plateforme de Web NFC, pas un bug. Pour iOS, Safari ou un ordinateur, il vous faut une appli native ou une appli dédiée de lecture/écriture NFC plutôt qu'une page web.

La demande d'autorisation n'apparaît jamais, ou scan() est rejeté immédiatement. Vérifiez que l'appel est bien relié à un gestionnaire de clic ou de toucher, et non à un code exécuté au chargement de la page : Chrome refuse les appels sans geste de l'utilisateur.

L'écriture semble réussie, mais rien n'a changé. Soit le tag n'était pas formaté en NDEF, soit il est sorti du champ du téléphone en pleine écriture. Web NFC ne comprend que le NDEF, sans solution de repli pour d'autres formats.

Le faire avec NFCore

Tout ce que Web NFC ne sait pas faire (pas de commandes ISO-DEP brutes, pas de peer-to-peer, pas d'émulation de carte (HCE), et aucun moyen de définir un mot de passe sur un tag au-delà du verrouillage irréversible makeReadOnly()) est précisément là où une appli native prend le relais. NFCore lit et écrit les mêmes tags NDEF sur iOS et sur Android, et ajoute les opérations de plus bas niveau qu'un onglet de navigateur ne peut pas atteindre : écritures par lot sur une pile de tags, modèles d'écriture réutilisables, un inspecteur de tag complet pour vérifier les octets de verrouillage et la structure de la mémoire avant d'écrire quoi que ce soit. Vous avez dépassé les limites d'un onglet de navigateur ? Tout est expliqué plus en détail ici. Téléchargez NFCore sur l'App Store ou Google Play quand vous avez besoin de cette portée supplémentaire.

Foire aux questions

Web NFC fonctionne-t-il sur iPhone ou dans Safari ?

Non. Web NFC (l'API NDEFReader) n'existe que dans Chrome pour Android. Safari sur iOS ne prend pas en charge Web NFC, et rien n'indique publiquement que cela va changer : l'accès NFC proposé par Apple aux développeurs tiers passe par Core NFC, en natif, et non par le navigateur.

Faut-il installer quelque chose pour utiliser Web NFC ?

Aucune installation : cela fonctionne dans Chrome pour Android sur une simple page en HTTPS. La contrepartie, c'est la portée : vous obtenez la lecture/écriture NDEF et rien de plus bas niveau, et la page doit être ouverte et visible quand vous approchez le tag.

Un site web peut-il lire n'importe quel tag NFC avec Web NFC ?

Seulement les tags formatés en NDEF, et uniquement après que vous avez explicitement accordé l'autorisation « nfc » et approché le tag alors que la page est ouverte et visible. Il n'y a pas de scan en arrière-plan ni d'accès aux formats non NDEF, comme les secteurs bruts d'un MIFARE Classic.

Que ne peut pas faire Web NFC qu'une appli NFC native sait faire ?

Il ne peut pas envoyer de commandes ISO-DEP/APDU brutes, ni faire du NFC peer-to-peer ou de l'émulation de carte (HCE), et il n'offre aucun moyen de définir un mot de passe sur un tag ni de restreindre l'accès en lecture/écriture : la seule option de protection est makeReadOnly(), qui est définitive. Une appli native comme NFCore couvre cet ensemble de commandes plus complet sur iOS et sur Android.

Conclusion

Web NFC est un moyen concret, sans installation, de lire et d'écrire des tags NDEF depuis une page web, dans les limites d'un modèle de sécurité strict (premier plan et autorisation) et d'une portée réservée au NDEF. Pour tout le reste (autres plateformes, commandes brutes sur les tags, ou protection réelle d'un tag que vous avez écrit), c'est une appli dédiée qui prend le relais.