Naivete Precedes Misrepresentation

npm

Ready to take your JavaScript development to the next level? Meet npm Enterprise - the ultimate in enterprise JavaScript.Learn more »

nativescript-telephony

1.0.4 • Public • Published

NativeScript-Telephony

This is a Nativescript plugin to get data from the SIM card like the carrier name, mcc, mnc and country code and other system dependent additional info.

Contributors

Peter Bakondy for his work on cordova-plugin-sim. Basically this is his plugin. I followed his source code as a guide.

Supported Platforms

  • Android
  • iOS

Installation

tns plugin add nativescript-telephony

Usage

Typescript

import {Telephony} from 'nativescript-telephony';
 
Telephony().then(function(resolved) {
    console.log('resolved >', resolved)
    console.dir(resolved);
}).catch(function(error) {
    console.error('error >', error)
    console.dir(error);
})

ES6 Promises

If you are unfamiliar with Promises, read up on these:

iOS Quirks

Promise.Resolves

{
  "carrierName": String,
  "countryCode": String,
  "mcc": String,
  "mnc": String,
  "allowsVOIP": Boolean,
}

Sadly there's nothing more we can get here.

Promise.Rejects

When using an emulator or a sim card does not exist.

Android Quirks

All permission dialogues are built into the Telephony function.

Promise.Resolves

When Permission is DENIED to READ_PHONE_STATE
{
    "countryCode": String,
    "simOperator": String,
    "carrierName": String,
    "callState": Number,
    "dataActivity": Number,
    "networkType": Number,
    "phoneType": Number,
    "simState": Number,
    "isNetworkRoaming": Boolean,
    "mcc": String,
    "mnc": String,
}
When Permission is GRANTED to READ_PHONE_STATE
{
    // START GRANTED PERMISSIONS
    "phoneNumber": String,
    "deviceId": String,
    "deviceSoftwareVersion": String,
    "simSerialNumber": String,
    "subscriberId": String,
    // END GRANTED PERMISSIONS
    "countryCode": String,
    "simOperator": String,
    "carrierName": String,
    "callState": Number,
    "dataActivity": Number,
    "networkType": Number,
    "phoneType": Number,
    "simState": Number,
    "isNetworkRoaming": Boolean,
    "mcc": String,
    "mnc": String,
}

Promise.Rejects

Never.

Demo

npm run setup
# iOS 
npm run demo.ios
# Android 
npm run demo.android

License

This plugin is licensed under the MITlicense by Rob Laverty

install

npm i nativescript-telephony

Downloadsweekly downloads

34

version

1.0.4

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability