MozNFC.getNFCTag()

The getNFCTag() method of the MozNFC interface returns an NDEF tag interface (MozNFCTag object) used to interact with NFC Tags.

It currently only supports NFC Data Exchange Format (NDEF) compatible NFC tag types, but its functionality will be expanded soon.

Syntax

<span id="idl-def-IDBIndex" class="idlInterface"><span id="idl-def-MediaRecorder" class="idlInterface"><span class="idlMethod">MozNFCTag getNFCTag(DOMString sessionId);</span></span></span>

Example

This example gives an idea of how you can set your activity handler function, then receive a session token from the activity when the function runs and get the NFC tag by passing it to getNFCTag():

navigator.mozSetMessageHandler('activity', ndefDiscoveredHandler);

function ndefDiscoveredHandler(activity) {
  var data = activity.source.data;
  var tag = navigator.mozNfc.getNFCTag(data.sessionToken);
  console.log(tag instanceof MozNFCTag); // should print true
}

Parameters

sessionToken: The session token associates the web application with the NFC hardware. It's found in the incoming Web Activity's data.sessionToken property, as seen in the above example.

Returns

A MozNFCTag object.

Errors

If an invalid session token is passed to getNFCTag(), it throws the error "Unable to create NFCTag object, Reason:  Bad SessionToken".

Specifications

The NFC implementation in Gecko follows the NFC Forum specifications.

Browser compatibility

[1] Available in privileged apps as of Firefox OS 2.2; certified-only before that.

See also

• Using the NFC API
• Using the NFC emulator
• Related W3C APIs:
  • NFCPeer spec
  • NFCTag spec