libphonenumber-js

What it does

Bundle size

The README compares its 145 kB full build (65 kB code plus 80 kB metadata) with 550 kB for Google’s library.checked 8 Oct 2001

Input caveat

The “As You Type” formatter accepts digits and an initial plus sign, ignores other punctuation, and does not support entering extensions.checked 8 Oct 2001

Live formatting

Its “As You Type” formatter parses and formats complete or incomplete phone-number input.checked 8 Oct 2001

Metadata options

Developers can choose min, max, mobile, or custom metadata to balance supported checks and bundle size.checked 8 Oct 2001

Notable limits

It does not handle emergency numbers, short codes, alphabetic numbers, or geolocation, among other special cases described in the README.checked 8 Oct 2001

Purpose

A smaller JavaScript/TypeScript rewrite of Google Android’s libphonenumber for parsing and formatting personal phone numbers.checked 8 Oct 2001

React integration

The README directs developers building a React phone-number component to the separate react-phone-number-input project.checked 8 Oct 2001

Repository status

The README identifies GitLab as the primary repository and says GitHub is used as a backup.checked 8 Oct 2001

Support

The README says issues can be reported on GitHub or GitLab and gives instructions for reporting behavior differences from Google’s library.checked 8 Oct 2001

Text search

The library can find complete phone numbers in text, including numbers with extensions.checked 8 Oct 2001

Validation

It can check whether a number is possible by length and whether it is valid by checking its digits against phone-number rules.checked 8 Oct 2001

Validation caveat

The README cautions that strict digit validation can become stale as numbering plans change and recommends considering length-only validation for some applications.checked 8 Oct 2001

Web distribution

The package can be installed with npm or included in a web page through a script tag or npm CDN service such as unpkg or jsDelivr.checked 8 Oct 2001