Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

NFC Information

The NFC API enables the ability to leverage the near field communication (NFC) capabilities of the Blackberry platform. NFC support was introduced in the BlackBerry development platform starting with BlackBerry 7. This extension allows WebWorks applications to read supported NDEF record types.


Tested On

  • BlackBerry Bold 9900 7.1 b1698

Requires: BlackBerry WebWorks SDK (for Smartphone) v2.2 or higher and BlackBerry handheld code 7.0+

Have a problem with this extension? Log an Issue

How To Configure The Extension For Use

  1. Locate your BlackBerry WebWorks SDK for Smartphone extensions directory using your File Explorer. Example path is C:\Program Files\Research In Motion\BlackBerry WebWorks SDK\ext

  2. Create a new blackberry.nfc.ndef directory in the ext directory

  3. Download the source from this repository and unzip it to a location on your computer

  4. Using File Explorer browse to this extension's downloaded source code Smartphone\NFC

  5. Copy the library.xml file from the downloaded Smartphone\NFC directory to your new ext\blackberry.nfc.ndef directory

  6. Copy the downloaded Smartphone\NFC\src\blackberry directory to the new ext\blackberry.nfc.ndef\blackberry directory

NOTE: Be sure to back-up this ext\blackberry.nfc.ndef directory in your WebWorks SDK extensions directory before performing a WebWorks SDK upgrade. Simply copy it back into the ext directory after you have completed your SDK upgrade.


Required Feature ID

Whenever you use the below feature id in any of your WebWorks applications this extension will be loaded for use.

<feature id="blackberry.nfc" />


  • blackberry.nfc

    static Object isNFCAvailable();
    static Object isNFCSupported();
  • blackberry.nfc.ndef

    static Object init_logging();
    static Object register_ndef(onScan : function, onError : function, record_type : Object);
    static Object unregister_ndef(record_type : Object);

Supported Record Types

Any type allowed by the underlying OS.

Usage Information

The source for a sample application is contained in sampleSrc.