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
			| 
											3 years ago
										 | 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()) | ||
|  | } |