Validation BR1.6.4 (legacy)

Telefone ​

Confira telefones brasileiros com a função isPhone em JavaScript.

A função valida números de telefone brasileiros, fixos ou celulares, com ou sem DDD e com ou sem máscara. Esta página documenta a API de funções soltas (isPhone, mask, fake...) da versão 1.x da validation-br, biblioteca JavaScript para Node.js e navegador. As funções abaixo cobrem validação, máscara, normalização e criação de telefones fake para testes. Para projetos novos, veja a versão 2.0, com API orientada a classes.

Exemplos (API) ​

js
// Importação direta
import { isPhone } from 'validation-br';

isPhone('(71) 9 4961-2604'); // -> true

// Importação de submódulo
import { validate, validateOrFail, mask, normalize, fake } from 'validation-br/dist/phone';

validate('71949612604'); // -> true
validateOrFail('71949612604'); // -> true (lança ValidationBRError se inválido)
mask('71949612604'); // -> '(71) 9 4961-2604'
normalize('(71) 9 4961-2604'); // -> '71949612604'
fake(); // -> telefone fake válido, sem máscara
fake(true); // -> telefone fake válido, com máscara

Regras de validação ​

  • Após remover os caracteres não numéricos, o número deve ter entre 8 e 11 dígitos.
  • Com DDD (10 ou 11 dígitos), os 2 primeiros dígitos não podem conter o algarismo 0.
  • Telefone fixo: número local de 8 dígitos, começando entre 2 e 8.
  • Celular: número local de 9 dígitos, começando obrigatoriamente com 9.
  • Sequências com todos os dígitos iguais (ex.: 11111111) são rejeitadas.

A máscara aplicada por mask() depende do tamanho do número informado:

DígitosMáscara
80000-0000
90 0000-0000
10(00) 0000-0000
11(00) 0 0000-0000

Integrações ​