55 lines
2.1 KiB
JavaScript
55 lines
2.1 KiB
JavaScript
import { parseDigit } from './helpers/parseDigits.js'
|
|
|
|
/**
|
|
* Parses phone number characters from a string.
|
|
* Drops all punctuation leaving only digits and the leading `+` sign (if any).
|
|
* Also converts wide-ascii and arabic-indic numerals to conventional numerals.
|
|
* E.g. in Iraq they don't write `+442323234` but rather `+٤٤٢٣٢٣٢٣٤`.
|
|
* @param {string} string
|
|
* @return {string}
|
|
* @example
|
|
* ```js
|
|
* // Outputs '8800555'.
|
|
* parseIncompletePhoneNumber('8 (800) 555')
|
|
* // Outputs '+7800555'.
|
|
* parseIncompletePhoneNumber('+7 800 555')
|
|
* ```
|
|
*/
|
|
export default function parseIncompletePhoneNumber(string) {
|
|
let result = ''
|
|
// Using `.split('')` here instead of normal `for ... of`
|
|
// because the importing application doesn't neccessarily include an ES6 polyfill.
|
|
// The `.split('')` approach discards "exotic" UTF-8 characters
|
|
// (the ones consisting of four bytes) but digits
|
|
// (including non-European ones) don't fall into that range
|
|
// so such "exotic" characters would be discarded anyway.
|
|
for (const character of string.split('')) {
|
|
result += parsePhoneNumberCharacter(character, result) || ''
|
|
}
|
|
return result
|
|
}
|
|
|
|
/**
|
|
* Parses next character while parsing phone number digits (including a `+`)
|
|
* from text: discards everything except `+` and digits, and `+` is only allowed
|
|
* at the start of a phone number.
|
|
* For example, is used in `react-phone-number-input` where it uses
|
|
* [`input-format`](https://gitlab.com/catamphetamine/input-format).
|
|
* @param {string} character - Yet another character from raw input string.
|
|
* @param {string?} prevParsedCharacters - Previous parsed characters.
|
|
* @param {object} meta - Optional custom use-case-specific metadata.
|
|
* @return {string?} The parsed character.
|
|
*/
|
|
export function parsePhoneNumberCharacter(character, prevParsedCharacters) {
|
|
// Only allow a leading `+`.
|
|
if (character === '+') {
|
|
// If this `+` is not the first parsed character
|
|
// then discard it.
|
|
if (prevParsedCharacters) {
|
|
return
|
|
}
|
|
return '+'
|
|
}
|
|
// Allow digits.
|
|
return parseDigit(character)
|
|
} |