You can not select more than 25 topics
			Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
		
		
		
		
		
			
		
			
				
					
					
						
							396 lines
						
					
					
						
							14 KiB
						
					
					
				
			
		
		
	
	
							396 lines
						
					
					
						
							14 KiB
						
					
					
				| import isValidNumber from '../validate_.js'
 | |
| import parseDigits from '../helpers/parseDigits.js'
 | |
| 
 | |
| import {
 | |
| 	startsWith,
 | |
| 	endsWith
 | |
| } from './util.js'
 | |
| 
 | |
| /**
 | |
|  * Leniency when finding potential phone numbers in text segments
 | |
|  * The levels here are ordered in increasing strictness.
 | |
|  */
 | |
| export default
 | |
| {
 | |
| 	/**
 | |
| 	 * Phone numbers accepted are "possible", but not necessarily "valid".
 | |
| 	 */
 | |
| 	POSSIBLE(number, candidate, metadata)
 | |
| 	{
 | |
| 		return true
 | |
| 	},
 | |
| 
 | |
| 	/**
 | |
| 	 * Phone numbers accepted are "possible" and "valid".
 | |
| 	 * Numbers written in national format must have their national-prefix
 | |
| 	 * present if it is usually written for a number of this type.
 | |
| 	 */
 | |
| 	VALID(number, candidate, metadata)
 | |
| 	{
 | |
| 		if (!isValidNumber(number, undefined, metadata) ||
 | |
| 			!containsOnlyValidXChars(number, candidate.toString(), metadata))
 | |
| 		{
 | |
| 			return false
 | |
| 		}
 | |
| 
 | |
|     // Skipped for simplicity.
 | |
| 		// return isNationalPrefixPresentIfRequired(number, metadata)
 | |
|     return true
 | |
|   },
 | |
| 
 | |
| 	/**
 | |
| 	 * Phone numbers accepted are "valid" and
 | |
| 	 * are grouped in a possible way for this locale. For example, a US number written as
 | |
| 	 * "65 02 53 00 00" and "650253 0000" are not accepted at this leniency level, whereas
 | |
| 	 * "650 253 0000", "650 2530000" or "6502530000" are.
 | |
| 	 * Numbers with more than one '/' symbol in the national significant number
 | |
| 	 * are also dropped at this level.
 | |
| 	 *
 | |
| 	 * Warning: This level might result in lower coverage especially for regions outside of
 | |
| 	 * country code "+1". If you are not sure about which level to use,
 | |
| 	 * email the discussion group libphonenumber-discuss@googlegroups.com.
 | |
| 	 */
 | |
| 	STRICT_GROUPING(number, candidate, metadata, regExpCache)
 | |
| 	{
 | |
| 		const candidateString = candidate.toString()
 | |
| 
 | |
| 		if (!isValidNumber(number, undefined, metadata)
 | |
| 			|| !containsOnlyValidXChars(number, candidateString, metadata)
 | |
| 			|| containsMoreThanOneSlashInNationalNumber(number, candidateString)
 | |
| 			|| !isNationalPrefixPresentIfRequired(number, metadata))
 | |
| 		{
 | |
| 			return false
 | |
| 		}
 | |
| 
 | |
| 		return checkNumberGroupingIsValid
 | |
| 		(
 | |
| 			number,
 | |
| 			candidate,
 | |
| 			metadata,
 | |
| 			allNumberGroupsRemainGrouped,
 | |
| 			regExpCache
 | |
| 		)
 | |
|   },
 | |
| 
 | |
| 	/**
 | |
| 	 * Phone numbers accepted are {@linkplain PhoneNumberUtil#isValidNumber(PhoneNumber) valid} and
 | |
| 	 * are grouped in the same way that we would have formatted it, or as a single block. For
 | |
| 	 * example, a US number written as "650 2530000" is not accepted at this leniency level, whereas
 | |
| 	 * "650 253 0000" or "6502530000" are.
 | |
| 	 * Numbers with more than one '/' symbol are also dropped at this level.
 | |
| 	 * <p>
 | |
| 	 * Warning: This level might result in lower coverage especially for regions outside of country
 | |
| 	 * code "+1". If you are not sure about which level to use, email the discussion group
 | |
| 	 * libphonenumber-discuss@googlegroups.com.
 | |
| 	 */
 | |
| 	EXACT_GROUPING(number, candidate, metadata, regExpCache)
 | |
| 	{
 | |
| 		const candidateString = candidate.toString()
 | |
| 
 | |
| 		if (!isValidNumber(number, undefined, metadata)
 | |
| 			|| !containsOnlyValidXChars(number, candidateString, metadata)
 | |
| 			|| containsMoreThanOneSlashInNationalNumber(number, candidateString)
 | |
| 			|| !isNationalPrefixPresentIfRequired(number, metadata))
 | |
| 		{
 | |
| 			return false
 | |
| 		}
 | |
| 
 | |
| 		return checkNumberGroupingIsValid
 | |
| 		(
 | |
| 			number,
 | |
| 			candidate,
 | |
| 			metadata,
 | |
| 			allNumberGroupsAreExactlyPresent,
 | |
| 			regExpCache
 | |
| 		)
 | |
| 	}
 | |
| }
 | |
| 
 | |
| function containsOnlyValidXChars(number, candidate, metadata)
 | |
| {
 | |
|   // The characters 'x' and 'X' can be (1) a carrier code, in which case they always precede the
 | |
|   // national significant number or (2) an extension sign, in which case they always precede the
 | |
|   // extension number. We assume a carrier code is more than 1 digit, so the first case has to
 | |
|   // have more than 1 consecutive 'x' or 'X', whereas the second case can only have exactly 1 'x'
 | |
|   // or 'X'. We ignore the character if it appears as the last character of the string.
 | |
|   for (let index = 0; index < candidate.length - 1; index++)
 | |
|   {
 | |
|     const charAtIndex = candidate.charAt(index)
 | |
| 
 | |
|     if (charAtIndex === 'x' || charAtIndex === 'X')
 | |
|     {
 | |
|       const charAtNextIndex = candidate.charAt(index + 1)
 | |
| 
 | |
|       if (charAtNextIndex === 'x' || charAtNextIndex === 'X')
 | |
|       {
 | |
|         // This is the carrier code case, in which the 'X's always precede the national
 | |
|         // significant number.
 | |
|         index++
 | |
|         if (util.isNumberMatch(number, candidate.substring(index)) != MatchType.NSN_MATCH)
 | |
|         {
 | |
|           return false
 | |
|         }
 | |
| 	      // This is the extension sign case, in which the 'x' or 'X' should always precede the
 | |
| 	      // extension number.
 | |
|       }
 | |
|       else if (parseDigits(candidate.substring(index)) !== number.ext)
 | |
|       {
 | |
|         return false
 | |
|       }
 | |
|     }
 | |
|   }
 | |
| 
 | |
|   return true
 | |
| }
 | |
| 
 | |
| function isNationalPrefixPresentIfRequired(number, _metadata)
 | |
| {
 | |
|   // First, check how we deduced the country code. If it was written in international format, then
 | |
|   // the national prefix is not required.
 | |
|   if (number.getCountryCodeSource() != 'FROM_DEFAULT_COUNTRY')
 | |
|   {
 | |
|     return true
 | |
|   }
 | |
| 
 | |
|   const phoneNumberRegion = util.getRegionCodeForCountryCode(number.getCountryCode())
 | |
| 
 | |
|   const metadata = util.getMetadataForRegion(phoneNumberRegion)
 | |
|   if (metadata == null)
 | |
|   {
 | |
|     return true
 | |
|   }
 | |
| 
 | |
|   // Check if a national prefix should be present when formatting this number.
 | |
|   const nationalNumber = util.getNationalSignificantNumber(number)
 | |
|   const formatRule = util.chooseFormattingPatternForNumber(metadata.numberFormats(), nationalNumber)
 | |
| 
 | |
|   // To do this, we check that a national prefix formatting rule was present
 | |
|   // and that it wasn't just the first-group symbol ($1) with punctuation.
 | |
|   if (formatRule && formatRule.getNationalPrefixFormattingRule().length > 0)
 | |
|   {
 | |
|     if (formatRule.getNationalPrefixOptionalWhenFormatting())
 | |
|     {
 | |
|       // The national-prefix is optional in these cases, so we don't need to check if it was
 | |
|       // present.
 | |
|       return true
 | |
|     }
 | |
| 
 | |
|     if (PhoneNumberUtil.formattingRuleHasFirstGroupOnly(
 | |
|         formatRule.getNationalPrefixFormattingRule()))
 | |
|     {
 | |
|       // National Prefix not needed for this number.
 | |
|       return true
 | |
|     }
 | |
| 
 | |
|     // Normalize the remainder.
 | |
|     const rawInputCopy = PhoneNumberUtil.normalizeDigitsOnly(number.getRawInput())
 | |
| 
 | |
|     // Check if we found a national prefix and/or carrier code at the start of the raw input, and
 | |
|     // return the result.
 | |
|     return util.maybeStripNationalPrefixAndCarrierCode(rawInputCopy, metadata, null)
 | |
|   }
 | |
| 
 | |
|   return true
 | |
| }
 | |
| 
 | |
| export function containsMoreThanOneSlashInNationalNumber(number, candidate)
 | |
| {
 | |
|   const firstSlashInBodyIndex = candidate.indexOf('/')
 | |
|   if (firstSlashInBodyIndex < 0)
 | |
|   {
 | |
|     // No slashes, this is okay.
 | |
|     return false
 | |
|   }
 | |
| 
 | |
|   // Now look for a second one.
 | |
|   const secondSlashInBodyIndex = candidate.indexOf('/', firstSlashInBodyIndex + 1)
 | |
|   if (secondSlashInBodyIndex < 0)
 | |
|   {
 | |
|     // Only one slash, this is okay.
 | |
|     return false
 | |
|   }
 | |
| 
 | |
|   // If the first slash is after the country calling code, this is permitted.
 | |
|   const candidateHasCountryCode =
 | |
|       (number.getCountryCodeSource() === CountryCodeSource.FROM_NUMBER_WITH_PLUS_SIGN
 | |
|        || number.getCountryCodeSource() === CountryCodeSource.FROM_NUMBER_WITHOUT_PLUS_SIGN)
 | |
| 
 | |
|   if (candidateHasCountryCode
 | |
|       && PhoneNumberUtil.normalizeDigitsOnly(candidate.substring(0, firstSlashInBodyIndex))
 | |
|           === String(number.getCountryCode()))
 | |
|   {
 | |
|     // Any more slashes and this is illegal.
 | |
|     return candidate.slice(secondSlashInBodyIndex + 1).indexOf('/') >= 0
 | |
|   }
 | |
| 
 | |
|   return true
 | |
| }
 | |
| 
 | |
| function checkNumberGroupingIsValid(
 | |
|   number,
 | |
|   candidate,
 | |
|   metadata,
 | |
|   checkGroups,
 | |
|   regExpCache
 | |
| ) {
 | |
|   const normalizedCandidate = normalizeDigits(candidate, true /* keep non-digits */)
 | |
|   let formattedNumberGroups = getNationalNumberGroups(metadata, number, null)
 | |
|   if (checkGroups(metadata, number, normalizedCandidate, formattedNumberGroups)) {
 | |
|     return true
 | |
|   }
 | |
| 
 | |
|   // If this didn't pass, see if there are any alternate formats that match, and try them instead.
 | |
|   const alternateFormats = MetadataManager.getAlternateFormatsForCountry(number.getCountryCode())
 | |
|   const nationalSignificantNumber = util.getNationalSignificantNumber(number)
 | |
| 
 | |
|   if (alternateFormats) {
 | |
|     for (const alternateFormat of alternateFormats.numberFormats()) {
 | |
|       if (alternateFormat.leadingDigitsPatterns().length > 0) {
 | |
|         // There is only one leading digits pattern for alternate formats.
 | |
|         const leadingDigitsRegExp = regExpCache.getPatternForRegExp('^' + alternateFormat.leadingDigitsPatterns()[0])
 | |
|         if (!leadingDigitsRegExp.test(nationalSignificantNumber)) {
 | |
|           // Leading digits don't match; try another one.
 | |
|           continue
 | |
|         }
 | |
|       }
 | |
|       formattedNumberGroups = getNationalNumberGroups(metadata, number, alternateFormat)
 | |
|       if (checkGroups(metadata, number, normalizedCandidate, formattedNumberGroups)) {
 | |
|         return true
 | |
|       }
 | |
|     }
 | |
|   }
 | |
| 
 | |
|   return false
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * Helper method to get the national-number part of a number, formatted without any national
 | |
|  * prefix, and return it as a set of digit blocks that would be formatted together following
 | |
|  * standard formatting rules.
 | |
|  */
 | |
| function getNationalNumberGroups(
 | |
| 	metadata,
 | |
| 	number,
 | |
| 	formattingPattern
 | |
| ) {
 | |
|   if (formattingPattern) {
 | |
|     // We format the NSN only, and split that according to the separator.
 | |
|     const nationalSignificantNumber = util.getNationalSignificantNumber(number)
 | |
|     return util.formatNsnUsingPattern(nationalSignificantNumber,
 | |
|                                       formattingPattern, 'RFC3966', metadata).split('-')
 | |
| 	}
 | |
| 
 | |
|   // This will be in the format +CC-DG1-DG2-DGX;ext=EXT where DG1..DGX represents groups of digits.
 | |
|   const rfc3966Format = formatNumber(number, 'RFC3966', metadata)
 | |
| 
 | |
|   // We remove the extension part from the formatted string before splitting it into different
 | |
|   // groups.
 | |
|   let endIndex = rfc3966Format.indexOf(';')
 | |
|   if (endIndex < 0) {
 | |
|     endIndex = rfc3966Format.length
 | |
|   }
 | |
| 
 | |
|   // The country-code will have a '-' following it.
 | |
|   const startIndex = rfc3966Format.indexOf('-') + 1
 | |
|   return rfc3966Format.slice(startIndex, endIndex).split('-')
 | |
| }
 | |
| 
 | |
| function allNumberGroupsAreExactlyPresent
 | |
| (
 | |
| 	metadata,
 | |
| 	number,
 | |
| 	normalizedCandidate,
 | |
| 	formattedNumberGroups
 | |
| )
 | |
| {
 | |
|   const candidateGroups = normalizedCandidate.split(NON_DIGITS_PATTERN)
 | |
| 
 | |
|   // Set this to the last group, skipping it if the number has an extension.
 | |
|   let candidateNumberGroupIndex =
 | |
|       number.hasExtension() ? candidateGroups.length - 2 : candidateGroups.length - 1
 | |
| 
 | |
|   // First we check if the national significant number is formatted as a block.
 | |
|   // We use contains and not equals, since the national significant number may be present with
 | |
|   // a prefix such as a national number prefix, or the country code itself.
 | |
|   if (candidateGroups.length == 1
 | |
|       || candidateGroups[candidateNumberGroupIndex].contains(
 | |
|           util.getNationalSignificantNumber(number)))
 | |
|   {
 | |
|     return true
 | |
|   }
 | |
| 
 | |
|   // Starting from the end, go through in reverse, excluding the first group, and check the
 | |
|   // candidate and number groups are the same.
 | |
|   let formattedNumberGroupIndex = (formattedNumberGroups.length - 1)
 | |
|   while (formattedNumberGroupIndex > 0 && candidateNumberGroupIndex >= 0)
 | |
|   {
 | |
|     if (candidateGroups[candidateNumberGroupIndex] !== formattedNumberGroups[formattedNumberGroupIndex])
 | |
|     {
 | |
|       return false
 | |
|     }
 | |
|     formattedNumberGroupIndex--
 | |
|     candidateNumberGroupIndex--
 | |
|   }
 | |
| 
 | |
|   // Now check the first group. There may be a national prefix at the start, so we only check
 | |
|   // that the candidate group ends with the formatted number group.
 | |
|   return (candidateNumberGroupIndex >= 0
 | |
|       && endsWith(candidateGroups[candidateNumberGroupIndex], formattedNumberGroups[0]))
 | |
| }
 | |
| 
 | |
| 
 | |
| function allNumberGroupsRemainGrouped
 | |
| (
 | |
| 	metadata,
 | |
| 	number,
 | |
| 	normalizedCandidate,
 | |
| 	formattedNumberGroups
 | |
| )
 | |
| {
 | |
|   let fromIndex = 0
 | |
|   if (number.getCountryCodeSource() !== CountryCodeSource.FROM_DEFAULT_COUNTRY)
 | |
|   {
 | |
|     // First skip the country code if the normalized candidate contained it.
 | |
|     const countryCode = String(number.getCountryCode())
 | |
|     fromIndex = normalizedCandidate.indexOf(countryCode) + countryCode.length()
 | |
|   }
 | |
| 
 | |
|   // Check each group of consecutive digits are not broken into separate groupings in the
 | |
|   // {@code normalizedCandidate} string.
 | |
|   for (let i = 0; i < formattedNumberGroups.length; i++)
 | |
|   {
 | |
|     // Fails if the substring of {@code normalizedCandidate} starting from {@code fromIndex}
 | |
|     // doesn't contain the consecutive digits in formattedNumberGroups[i].
 | |
|     fromIndex = normalizedCandidate.indexOf(formattedNumberGroups[i], fromIndex)
 | |
|     if (fromIndex < 0) {
 | |
|       return false
 | |
|     }
 | |
|     // Moves {@code fromIndex} forward.
 | |
|     fromIndex += formattedNumberGroups[i].length()
 | |
|     if (i == 0 && fromIndex < normalizedCandidate.length())
 | |
|     {
 | |
|       // We are at the position right after the NDC. We get the region used for formatting
 | |
|       // information based on the country code in the phone number, rather than the number itself,
 | |
|       // as we do not need to distinguish between different countries with the same country
 | |
|       // calling code and this is faster.
 | |
|       const region = util.getRegionCodeForCountryCode(number.getCountryCode())
 | |
|       if (util.getNddPrefixForRegion(region, true) != null
 | |
|           && Character.isDigit(normalizedCandidate.charAt(fromIndex))) {
 | |
|         // This means there is no formatting symbol after the NDC. In this case, we only
 | |
|         // accept the number if there is no formatting symbol at all in the number, except
 | |
|         // for extensions. This is only important for countries with national prefixes.
 | |
|         const nationalSignificantNumber = util.getNationalSignificantNumber(number)
 | |
|         return startsWith
 | |
|         (
 | |
|       	  normalizedCandidate.slice(fromIndex - formattedNumberGroups[i].length),
 | |
|            nationalSignificantNumber
 | |
|         )
 | |
|       }
 | |
|     }
 | |
|   }
 | |
| 
 | |
|   // The check here makes sure that we haven't mistakenly already used the extension to
 | |
|   // match the last group of the subscriber number. Note the extension cannot have
 | |
|   // formatting in-between digits.
 | |
|   return normalizedCandidate.slice(fromIndex).contains(number.getExtension())
 | |
| } |