langip

Detect language with IP address [Updated Jun 2022]

Demo

---

✔️ Free & No registration

✔️ Fast & No HTTP connection

✔️ Zero dependency & No limit

✔️ Ip2Location database & configable build

✔️ Includeds Arabic, Persian, Chinese, Spanish, French, Turkish, Korean as default

---

Install

• Npm

npm install langip --save

/* As multi language detector */
const langip = require("langip")

/* As specific language (recommended) */
const isAr = require("langip/language/Ar")
const isFa = require("langip/language/Fa")
const isZh = require("langip/language/Zh")
const isEs = require("langip/language/Es")
const isFr = require("langip/language/Fr")
const isTr = require("langip/language/Tr")
const isKo = require("langip/language/Ko")

• CDN

<!-- As multi language detector  -->
<script src="https://unpkg.com/langip@latest/dist/index.js"></script>

<!-- As specific language (recommended) -->
<script src="https://unpkg.com/langip@latest/dist/Ar.js"></script>
<script src="https://unpkg.com/langip@latest/dist/Fa.js"></script>
<script src="https://unpkg.com/langip@latest/dist/Zh.js"></script>
<script src="https://unpkg.com/langip@latest/dist/Es.js"></script>
<script src="https://unpkg.com/langip@latest/dist/Fr.js"></script>
<script src="https://unpkg.com/langip@latest/dist/Tr.js"></script>
<script src="https://unpkg.com/langip@latest/dist/Ko.js"></script>

---

Usage

• As multi language detector

/*
    detect(
        ip,         (String)
                    (Required)

        fallback,   (String)
                    (Optional)
                    (Default:"En")

        target,     (Array)
                    (Optional)
                    (Priority)
                    (Default:["Ar", "Fa", "Zh", "Es", "Fr", "Tr", "Ko"])
    )
*/

/* async await */
var detect = async () => {
    let lang = await langip.detect("8.8.8.8") /* detect(ip, fallback, target) */
    console.log(lang) /* En */
}

/* promise */
langip.detect("103.127.119.132").then((lang) => {
    console.log(lang) /* Fa */
})

• As specific language (recommended)
• Arabic (Ar)

/*
    Arabic [Ar]
    Countries [SA, IQ, KW, BH, AE, QA, OM, EG, SD]
*/

/* async await */
var check = async () => {
    let status = await isAr("194.31.220.14") /* isAr(ip) */
    console.log(status) /* true */
}

/* promise */
isAr("1.1.1.1").then((status) => {
    console.log(status) /* false */
})

• Persian (Fa)

/*
    Persian [Fa]
    Countries [IR, AF, TJ]
*/

/* async await */
var check = async () => {
    let status = await isFa("8.8.8.8") /* isFa(ip) */
    console.log(status) /* false */
}

/* promise */
isFa("103.127.119.132").then((status) => {
    console.log(status) /* true */
})

• Chinese (Zh)

/*
    Chinese [Zh]
    Countries [CN, SG, TW]
*/

/* async await */
var check = async () => {
    let status = await isZh("8.8.8.8") /* isZh(ip) */
    console.log(status) /* false */
}

/* promise */
isZh("103.70.53.52").then((status) => {
    console.log(status) /* true */
})

• Spanish (Es)

/*
    Spanish [Es]
    Countries [ES, MX]
*/

/* async await */
var check = async () => {
    let status = await isEs("8.8.8.8") /* isEs(ip) */
    console.log(status) /* false */
}

/* promise */
isEs("192.148.167.205").then((status) => {
    console.log(status) /* true */
})

• French (Fr)

/*
    French [Fr]
    Countries [FR, CD]
*/

/* async await */
var check = async () => {
    let status = await isFr("8.8.8.8") /* isFr(ip) */
    console.log(status) /* false */
}

/* promise */
isFr("188.115.112.51").then((status) => {
    console.log(status) /* true */
})

• Turkish (Tr)

/*
    Turkish [Tr]
    Countries [TR]
*/

/* async await */
var check = async () => {
    let status = await isTr("8.8.8.8") /* isTr(ip) */
    console.log(status) /* false */
}

/* promise */
isTr("217.195.200.161").then((status) => {
    console.log(status) /* true */
})

• Korean (Ko)

/*
    Korean [Ko]
    Countries [KR]
*/

/* async await */
var check = async () => {
    let status = await isKo("8.8.8.8") /* isKo(ip) */
    console.log(status) /* false */
}

/* promise */
isKo("134.75.232.150").then((status) => {
    console.log(status) /* true */
})

---

Utility

const { utility } = require("langip")

/* ipTolong(ip) */
let long = utility.ipTolong("2.16.158.255")
console.log(long) /* 34643711 */

/* longToip(long) */
let ip = utility.longToip(42991616)
console.log(ip) /* 2.144.0.0 */

---

Build

To update IP2Location database or add a new language detector

• config file in build/config.json

  • ISO 639-1 Language Code(upperCaseFirst)
  • ISO 3161 Country Code (upperCase)
  • List of official languages

{
    "file": "IP2LOCATION-LITE-DB1.CSV",
    "languages": {
        "Ar": ["SA", "IQ", "KW", "BH", "AE", "QA", "OM", "EG", "SD"],
        "Fa": ["IR", "AF", "TJ"],
        "Zh": ["CN", "SG", "TW"],
        "Es": ["ES", "MX"],
        "Fr": ["FR", "CD"],
        "Tr": ["TR"],
        "Ko": ["KR"]
    }
}

• Download latest database

npm run download

• Convert IP2Location database to small chunk files

npm run build

---

Test

npm run test

• Detect

 PASS  test/detect.test.js
  √ detect [195.16.171.140] => [Ar] (16 ms)
  √ detect [109.122.208.134] => [Fa] (4 ms)
  √ detect [103.70.53.52] => [Zh] (2 ms)
  √ detect [192.148.167.205] => [Es] (3 ms)
  √ detect [188.115.112.51] => [Fr] (3 ms)
  √ detect [217.195.200.161] => [Tr] (2 ms)
  √ detect [134.75.232.150] => [Ko] (2 ms)
  √ detect fallback [0.0.0.0] => [En] (1 ms)
  √ detect custom fallback [Fa] [0.0.0.0] => [Fa] (1 ms)
  √ detect custom target [Ar, Fa] [185.141.135.87] => [Fa] (1 ms)
  √ detect custom target [Ar] [185.141.135.87] => [En] (1 ms)

• isAr

 PASS  test/isAr.test.js
  √ isAr [185.217.8.116] => [true] (3 ms)
  √ isAr [0.0.0.0] => [false]

• isFa

 PASS  test/isFa.test.js
  √ isFa [185.78.234.76] => [true] (4 ms)
  √ isFa [0.0.0.0] => [false] (1 ms)

• isZh

 PASS  test/isZh.test.js
  √ isZh [113.17.217.136] => [true] (16 ms)
  √ isZh [0.0.0.0] => [false] (1 ms)

• isEs

 PASS  test/isEs.test.js
  √ isEs [216.251.66.182] => [true] (7 ms)
  √ isEs [0.0.0.0] => [false] (1 ms)

• isFr

 PASS  test/isFr.test.js
  √ isFr [5.144.136.101] => [true] (9 ms)
  √ isFr [0.0.0.0] => [false] (2 ms)

• isTr

 PASS  test/isTr.test.js
  √ isTr [185.160.114.220] => [true] (4 ms)
  √ isTr [0.0.0.0] => [false] (6 ms)

• isKo

 PASS  test/isKo.test.js
  √ isKo [103.19.124.87] => [true] (9 ms)
  √ isKo [0.0.0.0] => [false] (1 ms)

• Utility

 PASS  test/utility.test.js
  √ utility [Ar] [34643456] => [2.16.158.0] (2 ms)
  √ utility [Ar] [2.16.158.255] => [34643711]
  √ utility [Fa] [42991616] => [2.144.0.0]
  √ utility [Fa] [2.147.255.255] => [43253759]
  √ utility [Zh] [16777472] => [1.0.1.0]
  √ utility [Zh] [1.0.3.255] => [16778239]
  √ utility [Es] [34605056] => [2.16.8.0]
  √ utility [Es] [2.16.8.255] => [34605311] (1 ms)
  √ utility [Fr] [33554432] => [2.0.0.0]
  √ utility [Fr] [2.15.255.255] => [34603007] (17 ms)
  √ utility [Tr] [34625536] => [2.16.88.0]
  √ utility [Tr] [2.16.88.255] => [34625791] (1 ms)
  √ utility [Ko] [17498112] => [1.11.0.0]
  √ utility [Ko] [1.11.255.255] => [17563647]

---

IP2Location

This package includes IP2Location LITE data