catamphetamine/libphonenumber-js

Health v2 · maintenance only

Adoption not part of the score

2991 stars · 212 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A smaller, simpler JavaScript/TypeScript rewrite of Google's libphonenumber library for parsing, validating, and formatting phone numbers. It offers selectable metadata sets to reduce bundle size compared to the official port.

Use cases

• validate phone numbers in a web form
• format phone numbers in international format
• parse user-entered phone numbers into country code and national number
• extract phone numbers from free text
• detect the country of a phone number
• reduce bundle size vs google libphonenumber javascript port

When to choose

• you need phone number parsing/formatting in JavaScript or TypeScript
• bundle size matters and the 550 kB official port is too heavy
• you need TypeScript definitions out of the box
• you need to search for phone numbers within text

When to avoid

• you need the full feature set of Google's libphonenumber including carrier or timezone metadata
• you're working outside JavaScript/TypeScript
• you need a ready-made UI input component (use react-phone-number-input instead)

Facets

library · maturity stable

parser serialization internationalization web-development frontend developer-tools browser cross-platform phone-numbers phone-number-validation phone-number-formatting libphonenumber form-validation nodejs javascript typescript

Member repositories

For agents

markdown · JSON · MCP: product_card(name="catamphetamine/libphonenumber-js")