README.md

hkid

Generate and Validate HKID

Installation

yarn add hkid

Usage

import * as hkid from "hkid";

random()

generate valid HKID randomly

console.log(hkid.random()); // H3497811

validate(candidate: string, option?: { checkPrefix?: boolean})

validate HKID

• checkPrefix: check candidate against the known prefix list. If the prefix of candidate is not in the list, consider it as validation failure. (default: false)

  Note: the known prefix list may be incomplete, so false negative may be returned if checkPrefix is set to true.

console.log(hkid.validate("H3497811")); // true
console.log(hkid.validate("h3497811")); // true
console.log(hkid.validate("H349781(1)")); // true

console.log(hkid.validate("H3497810")); // false

console.log(hkid.validate("YK1597716")); // true
console.log(hkid.validate("YK1597716", { checkPrefix: false })); // true
console.log(hkid.validate("YK1597716", { checkPrefix: true })); // false

CodeSandbox

References

• 有關香港身份證號碼的特殊英文字頭所代表的意思和發出時間

License