libphonenumber-js 终极指南：JavaScript 电话号码处理完整教程

libphonenumber-js 终极指南：JavaScript 电话号码处理完整教程

【免费下载链接】libphonenumber-js A simpler (and smaller) rewrite of Google Android's libphonenumber library in javascript 项目地址: https://gitcode.com/gh_mirrors/li/libphonenumber-js

在现代 Web 应用中，电话号码处理是一个常见且重要的功能需求。libphonenumber-js 作为 Google Android 平台 libphonenumber 库的轻量级重写版，为开发者提供了强大的电话号码格式化、解析和验证能力。这个 JavaScript 库不仅保持了核心功能，还大幅优化了包体积，使其成为前端开发中的理想选择。

🚀 为什么选择这个电话号码处理库？

传统的电话号码处理往往面临诸多挑战：国际号码格式复杂、不同国家规则各异、用户输入格式不统一等。libphonenumber-js 通过以下优势解决了这些问题：

核心优势对比

• 体积优化：完整版仅 145 kB，相比原版 550 kB 大幅缩减
• 功能专注：专注于个人电话号码处理，去除不必要的特殊案例
• TypeScript 支持：内置类型定义，开发体验更佳

快速上手：5分钟完成集成

安装步骤

通过 npm 或 yarn 快速安装：

# 使用 npm
npm install libphonenumber-js --save

# 使用 yarn  
yarn add libphonenumber-js

基础使用示例

解析电话号码

import parsePhoneNumber from 'libphonenumber-js'

const phoneNumber = parsePhoneNumber('+1 213 373 4253')

if (phoneNumber) {
  console.log(phoneNumber.country) // 'US'
  console.log(phoneNumber.number) // '+12133734253'
}

格式化电话号码

const phoneNumber = parsePhoneNumber('+12133734253')

phoneNumber.formatInternational() // '+1 213 373 4253'
phoneNumber.formatNational() // '(213) 373-4253'

核心功能详解

1. 实时输入格式化

AsYouType 功能让用户在输入电话号码时获得即时格式化反馈：

import { AsYouType } from 'libphonenumber-js'

const formatter = new AsYouType('US')
formatter.input('2133734') // 返回: '(213) 373-4'

2. 智能验证系统

import {
  isPossiblePhoneNumber,
  isValidPhoneNumber,
  validatePhoneNumberLength
} from 'libphonenumber-js'

// 基础验证
isPossiblePhoneNumber('+18005553535') // true
isValidPhoneNumber('+18005553535') // true

// 详细长度验证
validatePhoneNumberLength('+1800555') // 'TOO_SHORT'

3. 文本搜索功能

在长文本中自动识别和提取电话号码：

import { findPhoneNumbersInText } from 'libphonenumber-js'

const text = `联系技术支持：+7 (800) 555-35-35`
const results = findPhoneNumbersInText(text, 'US')

模块化设计：按需选择

libphonenumber-js 提供三种不同规模的元数据包：

min 版本 (默认)

• 大小：约 80 kB
• 适用场景：仅需基础验证功能

max 版本

• 大小：约 145 kB
• 适用场景：需要完整验证和类型检测

mobile 版本

• 大小：约 95 kB
• 适用场景：专注于移动号码处理

实际应用场景

表单验证集成

在用户注册、联系方式收集等场景中，确保电话号码格式正确性。

数据清洗

处理从不同来源导入的电话号码数据，统一格式标准。

国际化支持

为多语言应用提供统一的电话号码处理方案。

最佳实践建议

1. 选择合适的版本：根据项目需求选择 min、max 或 mobile 版本
2. 错误处理：始终检查解析结果是否为 null
3. 用户体验：结合实时格式化提升用户输入体验

通过本指南，您应该已经掌握了 libphonenumber-js 的核心概念和使用方法。这个轻量级解决方案将大大简化您的电话号码处理工作流程。

【免费下载链接】libphonenumber-js A simpler (and smaller) rewrite of Google Android's libphonenumber library in javascript 项目地址: https://gitcode.com/gh_mirrors/li/libphonenumber-js