Tanzanian Phone Number Validation

A simple npm package for validating Tanzanian phone numbers using regular expressions.

Installation

You can install this package via npm:

npm i tanzanian-phone-validator

Example

You can check an example of this library Here.

Here is how it look like:

Usage

Use the isValidPhoneNumber function to validate a phone number. It returns true if the phone number is valid and false otherwise.

Use the getPhoneNumberDetails function to get information about a phone number. It returns an object various information about the phone number as shown below:

const results = {
  isValid: true,
  telecomCompanyDetails: {
    prefix: 76,
    company: "Vodacom Tanzania Limited",
    brand: "Vodacom",
    operational: "yes",
  },
};

Usage with validation libraries

Here are some usage examples with different validation libraries:

Using Yup

const yup = require("yup");
import { isValidPhoneNumber } from "tanzanian-phone-validator";

const schema = yup.object({
  phoneNumber: yup
    .string()
    .test("is-tanzanian", "Invalid Tanzanian phone number", (value) => {
      return isValidPhoneNumber(value);
    }),
});

// Example usage
const data = {
  phoneNumber: "+255761234567",
};

schema
  .validate(data)
  .then((validatedData) => {
    console.log("Validation succeeded:", validatedData);
  })
  .catch((error) => {
    console.error("Validation failed:", error.message);
  });

Using Zod

const { z } = require("zod");
import { validateTanzanianPhoneNumber } from "tanzanian-phone-validator";

const schema = z.object({
  phoneNumber: z.string().refine(
    (value) => {
      return isValidPhoneNumber(value);
    },
    {
      message: "Invalid Tanzanian phone number",
    }
  ),
});

// Example usage
const data = {
  phoneNumber: "+255761234567",
};

try {
  const validatedData = schema.parse(data);
  console.log("Validation succeeded:", validatedData);
} catch (error) {
  console.error("Validation failed:", error.message);
}

Direct usage (Node Js)

You can also directly use the isValidPhoneNumber function:

import { validateTanzanianPhoneNumber } from "tanzanian-phone-validator";

const phoneNumber = "+255761234567";

if (isValidPhoneNumber(phoneNumber)) {
  console.log("Valid Tanzanian phone number.");
} else {
  console.log("Invalid Tanzanian phone number.");
}

List of Tanzanian mobile network operators and their prefixes

This table was used to used to create this package. IT can be found in wikipedia (Click here).. Note : this package does not validate for Operators which are not in Operation nor on this table.

| Prefix | Operator | Trading as | Operational[1] | | ------ | ------------------------------------------------- | ---------- | -------------- | | 61 | Viettel Tanzania Limited | halotel | yes | | 62 | Viettel Tanzania Limited | halotel | yes | | 63 | Mkulima African Telecommunication Company Limited | Amotel | no | | 64 | Wiafrica Tanzania Limited | CooTel | no | | 65 | MIC Tanzania Limited | tiGo | yes | | 66 | Smile Communications Tanzania Limited | smile | yes | | 67 | MIC Tanzania Limited | tiGo | yes | | 68 | Airtel Tanzania Limited | airtel | yes | | 69 | Airtel Tanzania Limited | airtel | yes | | 71 | MIC Tanzania Limited | tiGo | yes | | 72 | MO Mobile Holding Limited | | no | | 73 | Tanzania Telecommunications Company Ltd | TTCL | yes | | 74 | Vodacom Tanzania Limited | Vodacom | yes | | 75 | Vodacom Tanzania Limited | Vodacom | yes | | 76 | Vodacom Tanzania Limited | Vodacom | yes | | 77 | MIC Tanzania Limited | tiGo | yes | | 78 | Airtel Tanzania Limited | airtel | yes | | 79 | Benson Informatics Ltd | Smart | no |

License This package is licensed under the MIT License. See the LICENSE..