-// Copyright (C) 2010 Google Inc.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS-IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+/**
+ * @license
+ * Copyright (C) 2010 The Libphonenumber Authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
/**
* @fileoverview A formatter which formats phone numbers as they are entered.
* (based on the java implementation).
*
- * An AsYouTypeFormatter could be created by new AsYouTypeFormatter(). After
- * that digits could be added by invoking the inputDigit method on the formatter
+ * <p>An AsYouTypeFormatter can be created by new AsYouTypeFormatter(). After
+ * that, digits can be added by invoking {@link #inputDigit} on the formatter
* instance, and the partially formatted phone number will be returned each time
- * a digit is added. The clear method should be invoked before a new number
- * needs to be formatted.
+ * a digit is added. {@link #clear} can be invoked before formatting a new
+ * number.
*
- * See testAsYouTypeFormatterUS(), testAsYouTestFormatterGB() and
- * testAsYouTypeFormatterDE() in asyoutypeformatter_test.js for more details
- * on how the formatter is to be used.
+ * <p>See the unittests for more details on how the formatter is to be used.
*
* @author Nikolaos Trogkanis
*/
goog.require('i18n.phonenumbers.PhoneNumberUtil');
goog.require('i18n.phonenumbers.metadata');
+
+
/**
- * Constructs a light-weight formatter which does no formatting, but outputs
- * exactly what is fed into the inputDigit method.
+ * Constructs an AsYouTypeFormatter for the specific region.
*
- * @param {string} regionCode the country/region where the phone number is being
- * entered.
+ * @param {string} regionCode the ISO 3166-1 two-letter region code that denotes
+ * the region where the phone number is being entered.
* @constructor
*/
i18n.phonenumbers.AsYouTypeFormatter = function(regionCode) {
/**
- * @type {boolean}
+ * The digits that have not been entered yet will be represented by a \u2008,
+ * the punctuation space.
+ * @const
+ * @type {string}
* @private
*/
- this.ableToFormat_ = true;
+ this.DIGIT_PLACEHOLDER_ = '\u2008';
/**
- * @type {boolean}
+ * @type {RegExp}
* @private
*/
- this.isInternationalFormatting_ = false;
+ this.DIGIT_PATTERN_ = new RegExp(this.DIGIT_PLACEHOLDER_);
/**
- * @type {i18n.phonenumbers.PhoneNumberUtil}
+ * @type {string}
* @private
*/
- this.phoneUtil_ = i18n.phonenumbers.PhoneNumberUtil.getInstance();
- // The digits that have not been entered yet will be represented by a \u2008,
- // the punctuation space.
+ this.currentOutput_ = '';
/**
+ * @type {!goog.string.StringBuffer}
+ * @private
+ */
+ this.formattingTemplate_ = new goog.string.StringBuffer();
+ /**
+ * The pattern from numberFormat that is currently used to create
+ * formattingTemplate.
* @type {string}
* @private
*/
- this.digitPlaceholder_ = '\u2008';
+ this.currentFormattingPattern_ = '';
/**
- * @type {RegExp}
+ * @type {!goog.string.StringBuffer}
* @private
*/
- this.digitPattern_ = new RegExp(this.digitPlaceholder_);
+ this.accruedInput_ = new goog.string.StringBuffer();
/**
- * @type {number}
+ * @type {!goog.string.StringBuffer}
* @private
*/
- this.lastMatchPosition_ = 0;
+ this.accruedInputWithoutFormatting_ = new goog.string.StringBuffer();
+ /**
+ * This indicates whether AsYouTypeFormatter is currently doing the
+ * formatting.
+ * @type {boolean}
+ * @private
+ */
+ this.ableToFormat_ = true;
+ /**
+ * Set to true when users enter their own formatting. AsYouTypeFormatter will
+ * do no formatting at all when this is set to true.
+ * @type {boolean}
+ * @private
+ */
+ this.inputHasFormatting_ = false;
+ /**
+ * This is set to true when we know the user is entering a full national
+ * significant number, since we have either detected a national prefix or an
+ * international dialing prefix. When this is true, we will no longer use
+ * local number formatting patterns.
+ * @type {boolean}
+ * @private
+ */
+ this.isCompleteNumber_ = false;
+ /**
+ * @type {boolean}
+ * @private
+ */
+ this.isExpectingCountryCallingCode_ = false;
+ /**
+ * @type {i18n.phonenumbers.PhoneNumberUtil}
+ * @private
+ */
+ this.phoneUtil_ = i18n.phonenumbers.PhoneNumberUtil.getInstance();
/**
- * The position of a digit upon which inputDigitAndRememberPosition is most
- * recently invoked, as found in the current output.
* @type {number}
* @private
*/
- this.positionRemembered_ = 0;
+ this.lastMatchPosition_ = 0;
/**
* The position of a digit upon which inputDigitAndRememberPosition is most
* recently invoked, as found in the original sequence of characters the user
*/
this.originalPosition_ = 0;
/**
- * A pattern that is used to match character classes in regular expressions.
- * An example of a character class is [1-4].
- * @type {RegExp}
- * @private
- */
- this.CHARACTER_CLASS_PATTERN_ = /\[([^\[\]])*\]/g;
- /**
- * Any digit in a regular expression that actually denotes a digit. For
- * example, in the regular expression 80[0-2]\d{6,10}, the first 2 digits
- * (8 and 0) are standalone digits, but the rest are not.
- * Two look-aheads are needed because the number following \\d could be a
- * two-digit number, since the phone number can be as long as 15 digits.
- * @type {RegExp}
+ * The position of a digit upon which inputDigitAndRememberPosition is most
+ * recently invoked, as found in accruedInputWithoutFormatting.
+ * entered.
+ * @type {number}
* @private
*/
- this.STANDALONE_DIGIT_PATTERN_ = /\d(?=[^,}][^,}])/g;
+ this.positionToRemember_ = 0;
/**
+ * This contains anything that has been entered so far preceding the national
+ * significant number, and it is formatted (e.g. with space inserted). For
+ * example, this can contain IDD, country code, and/or NDD, etc.
* @type {!goog.string.StringBuffer}
* @private
*/
- this.accruedInput_ = new goog.string.StringBuffer();
+ this.prefixBeforeNationalNumber_ = new goog.string.StringBuffer();
/**
- * @type {!goog.string.StringBuffer}
+ * @type {boolean}
* @private
*/
- this.accruedInputWithoutFormatting_ = new goog.string.StringBuffer();
+ this.shouldAddSpaceAfterNationalPrefix_ = false;
/**
- * @type {!goog.string.StringBuffer}
+ * This contains the national prefix that has been extracted. It contains only
+ * digits without formatting.
+ * @type {string}
* @private
*/
- this.currentOutput_ = new goog.string.StringBuffer();
+ this.extractedNationalPrefix_ = '';
/**
* @type {!goog.string.StringBuffer}
* @private
*/
- this.prefixBeforeNationalNumber_ = new goog.string.StringBuffer();
+ this.nationalNumber_ = new goog.string.StringBuffer();
/**
- * @type {!goog.string.StringBuffer}
+ * @type {Array.<i18n.phonenumbers.NumberFormat>}
* @private
*/
- this.nationalNumber_ = new goog.string.StringBuffer();
+ this.possibleFormats_ = [];
/**
- * @type {string}
+ * @type {string}
* @private
*/
this.defaultCountry_ = regionCode;
- this.initializeCountrySpecificInfo_(this.defaultCountry_);
+ this.currentMetadata_ = this.getMetadataForRegion_(this.defaultCountry_);
/**
* @type {i18n.phonenumbers.PhoneMetadata}
* @private
*/
- this.defaultMetaData_ = this.currentMetaData_;
+ this.defaultMetadata_ = this.currentMetadata_;
};
+
+/**
+ * Character used when appropriate to separate a prefix, such as a long NDD or a
+ * country calling code, from the national number.
+ * @const
+ * @type {string}
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.SEPARATOR_BEFORE_NATIONAL_NUMBER_ = ' ';
+
+
/**
- * @param {string} regionCode
+ * @const
+ * @type {i18n.phonenumbers.PhoneMetadata}
* @private
*/
-i18n.phonenumbers.AsYouTypeFormatter.prototype.initializeCountrySpecificInfo_ =
- function(regionCode) {
+i18n.phonenumbers.AsYouTypeFormatter.EMPTY_METADATA_ =
+ new i18n.phonenumbers.PhoneMetadata();
+i18n.phonenumbers.AsYouTypeFormatter.EMPTY_METADATA_
+ .setInternationalPrefix('NA');
+
+/**
+ * A pattern that is used to match character classes in regular expressions.
+ * An example of a character class is [1-4].
+ * @const
+ * @type {RegExp}
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.CHARACTER_CLASS_PATTERN_ =
+ /\[([^\[\]])*\]/g;
+
+
+/**
+ * Any digit in a regular expression that actually denotes a digit. For
+ * example, in the regular expression 80[0-2]\d{6,10}, the first 2 digits
+ * (8 and 0) are standalone digits, but the rest are not.
+ * Two look-aheads are needed because the number following \\d could be a
+ * two-digit number, since the phone number can be as long as 15 digits.
+ * @const
+ * @type {RegExp}
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.STANDALONE_DIGIT_PATTERN_ =
+ /\d(?=[^,}][^,}])/g;
+
+
+/**
+ * A pattern that is used to determine if a numberFormat under availableFormats
+ * is eligible to be used by the AYTF. It is eligible when the format element
+ * under numberFormat contains groups of the dollar sign followed by a single
+ * digit, separated by valid phone number punctuation. This prevents invalid
+ * punctuation (such as the star sign in Israeli star numbers) getting into the
+ * output of the AYTF.
+ * @const
+ * @type {RegExp}
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.ELIGIBLE_FORMAT_PATTERN_ = new RegExp(
+ '^[' + i18n.phonenumbers.PhoneNumberUtil.VALID_PUNCTUATION + ']*' +
+ '(\\$\\d[' + i18n.phonenumbers.PhoneNumberUtil.VALID_PUNCTUATION + ']*)+$');
+
+
+/**
+ * A set of characters that, if found in a national prefix formatting rules, are
+ * an indicator to us that we should separate the national prefix from the
+ * number when formatting.
+ * @const
+ * @type {RegExp}
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.NATIONAL_PREFIX_SEPARATORS_PATTERN_ =
+ /[- ]/;
+
+
+/**
+ * This is the minimum length of national number accrued that is required to
+ * trigger the formatter. The first element of the leadingDigitsPattern of
+ * each numberFormat contains a regular expression that matches up to this
+ * number of digits.
+ * @const
+ * @type {number}
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.MIN_LEADING_DIGITS_LENGTH_ = 3;
+
+
+/**
+ * The metadata needed by this class is the same for all regions sharing the
+ * same country calling code. Therefore, we return the metadata for "main"
+ * region for this country calling code.
+ * @param {string} regionCode an ISO 3166-1 two-letter region code.
+ * @return {i18n.phonenumbers.PhoneMetadata} main metadata for this region.
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.prototype.getMetadataForRegion_ =
+ function(regionCode) {
+
+ /** @type {number} */
+ var countryCallingCode = this.phoneUtil_.getCountryCodeForRegion(regionCode);
+ /** @type {string} */
+ var mainCountry =
+ this.phoneUtil_.getRegionCodeForCountryCode(countryCallingCode);
/** @type {i18n.phonenumbers.PhoneMetadata} */
- this.currentMetaData_ = this.phoneUtil_.getMetadataForRegion(regionCode);
- /** @type {RegExp} */
- this.nationalPrefixForParsing_ = new RegExp('^(' + this.currentMetaData_
- .getNationalPrefixForParsing() + ')');
- /** @type {RegExp} */
- this.internationalPrefix_ = new RegExp('^(' + '\\+|' +
- this.currentMetaData_.getInternationalPrefix() + ')');
+ var metadata = this.phoneUtil_.getMetadataForRegion(mainCountry);
+ if (metadata != null) {
+ return metadata;
+ }
+ // Set to a default instance of the metadata. This allows us to function with
+ // an incorrect region code, even if formatting only works for numbers
+ // specified with '+'.
+ return i18n.phonenumbers.AsYouTypeFormatter.EMPTY_METADATA_;
};
+
/**
- * @param {string} leadingFourDigitsOfNationalNumber
+ * @return {boolean} true if a new template is created as opposed to reusing the
+ * existing template.
* @private
*/
-i18n.phonenumbers.AsYouTypeFormatter.prototype.chooseFormatAndCreateTemplate_ =
- function(leadingFourDigitsOfNationalNumber) {
+i18n.phonenumbers.AsYouTypeFormatter.prototype.maybeCreateNewTemplate_ =
+ function() {
- /** @type {Array.<i18n.phonenumbers.NumberFormat>} */
- var formatList = this.getAvailableFormats_(leadingFourDigitsOfNationalNumber);
- if (formatList.length < 1) {
- this.ableToFormat_ = false;
- } else {
- // When there are multiple available formats, the formatter uses the first
- // format.
+ // When there are multiple available formats, the formatter uses the first
+ // format where a formatting template could be created.
+ /** @type {number} */
+ var possibleFormatsLength = this.possibleFormats_.length;
+ for (var i = 0; i < possibleFormatsLength; ++i) {
/** @type {i18n.phonenumbers.NumberFormat} */
- var format = formatList[0];
- if (!this.createFormattingTemplate_(format)) {
- this.ableToFormat_ = false;
- } else {
- this.currentOutput_ =
- new goog.string.StringBuffer(this.formattingTemplate_);
+ var numberFormat = this.possibleFormats_[i];
+ /** @type {string} */
+ var pattern = numberFormat.getPatternOrDefault();
+ if (this.currentFormattingPattern_ == pattern) {
+ return false;
+ }
+ if (this.createFormattingTemplate_(numberFormat)) {
+ this.currentFormattingPattern_ = pattern;
+ this.shouldAddSpaceAfterNationalPrefix_ =
+ i18n.phonenumbers.AsYouTypeFormatter.
+ NATIONAL_PREFIX_SEPARATORS_PATTERN_.test(
+ numberFormat.getNationalPrefixFormattingRule());
+ // With a new formatting template, the matched position using the old
+ // template needs to be reset.
+ this.lastMatchPosition_ = 0;
+ return true;
}
}
+ this.ableToFormat_ = false;
+ return false;
};
+
/**
- * @param {string} leadingFourDigits
- * @return {Array.<i18n.phonenumbers.NumberFormat>}
+ * @param {string} leadingDigits leading digits of entered number.
* @private
*/
i18n.phonenumbers.AsYouTypeFormatter.prototype.getAvailableFormats_ =
- function(leadingFourDigits) {
+ function(leadingDigits) {
/** @type {Array.<i18n.phonenumbers.NumberFormat>} */
- var matchedList = [];
- /** @type {Array.<i18n.phonenumbers.NumberFormat>} */
- var formatList = (this.isInternationalFormatting_ && this.currentMetaData_
- .intlNumberFormatCount() > 0) ? this.currentMetaData_
- .intlNumberFormatArray() : this.currentMetaData_.numberFormatArray();
+ var formatList =
+ (this.isCompleteNumber_ &&
+ this.currentMetadata_.intlNumberFormatCount() > 0) ?
+ this.currentMetadata_.intlNumberFormatArray() :
+ this.currentMetadata_.numberFormatArray();
/** @type {number} */
var formatListLength = formatList.length;
for (var i = 0; i < formatListLength; ++i) {
/** @type {i18n.phonenumbers.NumberFormat} */
var format = formatList[i];
- if (format.hasLeadingDigits()) {
- /** @type {RegExp} */
- var leadingDigitsPattern =
- new RegExp('^(' + format.getLeadingDigits() + ')');
- if (leadingDigitsPattern.test(leadingFourDigits)) {
- matchedList.push(format);
+ /** @type {boolean} */
+ var nationalPrefixIsUsedByCountry =
+ this.currentMetadata_.hasNationalPrefix();
+ if (!nationalPrefixIsUsedByCountry || this.isCompleteNumber_ ||
+ format.getNationalPrefixOptionalWhenFormatting() ||
+ this.phoneUtil_.formattingRuleHasFirstGroupOnly(
+ format.getNationalPrefixFormattingRuleOrDefault())) {
+ if (this.isFormatEligible_(format.getFormatOrDefault())) {
+ this.possibleFormats_.push(format);
}
- } else {
- matchedList.push(format);
}
}
- return matchedList;
+ this.narrowDownPossibleFormats_(leadingDigits);
+};
+
+
+/**
+ * @param {string} format
+ * @return {boolean}
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.prototype.isFormatEligible_ =
+ function(format) {
+ return i18n.phonenumbers.AsYouTypeFormatter.ELIGIBLE_FORMAT_PATTERN_
+ .test(format);
};
+
+/**
+ * @param {string} leadingDigits
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.prototype.narrowDownPossibleFormats_ =
+ function(leadingDigits) {
+
+ /** @type {Array.<i18n.phonenumbers.NumberFormat>} */
+ var possibleFormats = [];
+ /** @type {number} */
+ var indexOfLeadingDigitsPattern =
+ leadingDigits.length -
+ i18n.phonenumbers.AsYouTypeFormatter.MIN_LEADING_DIGITS_LENGTH_;
+ /** @type {number} */
+ var possibleFormatsLength = this.possibleFormats_.length;
+ for (var i = 0; i < possibleFormatsLength; ++i) {
+ /** @type {i18n.phonenumbers.NumberFormat} */
+ var format = this.possibleFormats_[i];
+ if (format.leadingDigitsPatternCount() == 0) {
+ // Keep everything that isn't restricted by leading digits.
+ possibleFormats.push(this.possibleFormats_[i]);
+ continue;
+ }
+ /** @type {number} */
+ var lastLeadingDigitsPattern = Math.min(
+ indexOfLeadingDigitsPattern, format.leadingDigitsPatternCount() - 1);
+ /** @type {string} */
+ var leadingDigitsPattern = /** @type {string} */
+ (format.getLeadingDigitsPattern(lastLeadingDigitsPattern));
+ if (leadingDigits.search(leadingDigitsPattern) == 0) {
+ possibleFormats.push(this.possibleFormats_[i]);
+ }
+ }
+ this.possibleFormats_ = possibleFormats;
+};
+
+
/**
* @param {i18n.phonenumbers.NumberFormat} format
* @return {boolean}
* @private
*/
i18n.phonenumbers.AsYouTypeFormatter.prototype.createFormattingTemplate_ =
- function(format) {
+ function(format) {
/** @type {string} */
- var numberFormat = format.getFormatOrDefault();
- /** @type {string} */
var numberPattern = format.getPatternOrDefault();
// The formatter doesn't format numbers when numberPattern contains '|', e.g.
}
// Replace anything in the form of [..] with \d
- numberPattern = numberPattern.replace(this.CHARACTER_CLASS_PATTERN_, '\\d');
+ numberPattern = numberPattern.replace(
+ i18n.phonenumbers.AsYouTypeFormatter.CHARACTER_CLASS_PATTERN_, '\\d');
// Replace any standalone digit (not the one in d{}) with \d
- numberPattern = numberPattern.replace(this.STANDALONE_DIGIT_PATTERN_, '\\d');
-
- this.formattingTemplate_ = this.getFormattingTemplate_(numberPattern,
- numberFormat);
- return true;
+ numberPattern = numberPattern.replace(
+ i18n.phonenumbers.AsYouTypeFormatter.STANDALONE_DIGIT_PATTERN_, '\\d');
+ this.formattingTemplate_.clear();
+ /** @type {string} */
+ var tempTemplate = this.getFormattingTemplate_(numberPattern,
+ format.getFormatOrDefault());
+ if (tempTemplate.length > 0) {
+ this.formattingTemplate_.append(tempTemplate);
+ return true;
+ }
+ return false;
};
+
/**
- * Gets a formatting template which could be used to efficiently format a
+ * Gets a formatting template which can be used to efficiently format a
* partial number where digits are added one by one.
*
* @param {string} numberPattern
* @private
*/
i18n.phonenumbers.AsYouTypeFormatter.prototype.getFormattingTemplate_ =
- function(numberPattern, numberFormat) {
+ function(numberPattern, numberFormat) {
// Creates a phone number consisting only of the digit 9 that matches the
// numberPattern by applying the pattern to the longestPhoneNumber string.
// this match will always succeed
/** @type {string} */
var aPhoneNumber = m[0];
+ // No formatting template can be created if the number of digits entered so
+ // far is longer than the maximum the current formatting rule can accommodate.
+ if (aPhoneNumber.length < this.nationalNumber_.getLength()) {
+ return '';
+ }
// Formats the number according to numberFormat
/** @type {string} */
var template = aPhoneNumber.replace(new RegExp(numberPattern, 'g'),
numberFormat);
- // Replaces each digit with character digitPlaceholder
- template = template.replace(new RegExp('9', 'g'), this.digitPlaceholder_);
+ // Replaces each digit with character DIGIT_PLACEHOLDER
+ template = template.replace(new RegExp('9', 'g'), this.DIGIT_PLACEHOLDER_);
return template;
};
+
/**
- * Clears the internal state of the formatter, so it could be reused.
+ * Clears the internal state of the formatter, so it can be reused.
*/
i18n.phonenumbers.AsYouTypeFormatter.prototype.clear = function() {
+ this.currentOutput_ = '';
this.accruedInput_.clear();
this.accruedInputWithoutFormatting_.clear();
- this.currentOutput_.clear();
+ this.formattingTemplate_.clear();
this.lastMatchPosition_ = 0;
+ this.currentFormattingPattern_ = '';
this.prefixBeforeNationalNumber_.clear();
+ this.extractedNationalPrefix_ = '';
this.nationalNumber_.clear();
this.ableToFormat_ = true;
- this.positionRemembered_ = 0;
+ this.inputHasFormatting_ = false;
+ this.positionToRemember_ = 0;
this.originalPosition_ = 0;
- this.isInternationalFormatting_ = false;
- if (this.currentMetaData_ != this.defaultMetaData_) {
- this.initializeCountrySpecificInfo_(this.defaultCountry_);
+ this.isCompleteNumber_ = false;
+ this.isExpectingCountryCallingCode_ = false;
+ this.possibleFormats_ = [];
+ this.shouldAddSpaceAfterNationalPrefix_ = false;
+ if (this.currentMetadata_ != this.defaultMetadata_) {
+ this.currentMetadata_ = this.getMetadataForRegion_(this.defaultCountry_);
}
};
+
/**
* Formats a phone number on-the-fly as each digit is entered.
*
* @param {string} nextChar the most recently entered digit of a phone number.
- * Formatting characters are allowed, but they are removed from the result.
+ * Formatting characters are allowed, but as soon as they are encountered
+ * this method formats the number as entered and not 'as you type' anymore.
+ * Full width digits and Arabic-indic digits are allowed, and will be shown
+ * as they are.
* @return {string} the partially formatted phone number.
*/
i18n.phonenumbers.AsYouTypeFormatter.prototype.inputDigit = function(nextChar) {
- return this.inputDigitWithOptionToRememberPosition_(nextChar, false);
+ this.currentOutput_ =
+ this.inputDigitWithOptionToRememberPosition_(nextChar, false);
+ return this.currentOutput_;
};
+
/**
- * Same as inputDigit, but remembers the position where nextChar is inserted, so
- * that it could be retrieved later by using getRememberedPosition(). The
- * remembered position will be automatically adjusted if additional formatting
- * characters are later inserted/removed in front of nextChar.
+ * Same as {@link #inputDigit}, but remembers the position where
+ * {@code nextChar} is inserted, so that it can be retrieved later by using
+ * {@link #getRememberedPosition}. The remembered position will be automatically
+ * adjusted if additional formatting characters are later inserted/removed in
+ * front of {@code nextChar}.
*
* @param {string} nextChar
* @return {string}
*/
i18n.phonenumbers.AsYouTypeFormatter.prototype.inputDigitAndRememberPosition =
- function(nextChar) {
+ function(nextChar) {
- return this.inputDigitWithOptionToRememberPosition_(nextChar, true);
+ this.currentOutput_ =
+ this.inputDigitWithOptionToRememberPosition_(nextChar, true);
+ return this.currentOutput_;
};
+
/**
* @param {string} nextChar
* @param {boolean} rememberPosition
* @return {string}
+ * @private
*/
i18n.phonenumbers.AsYouTypeFormatter.prototype.
inputDigitWithOptionToRememberPosition_ = function(nextChar,
this.accruedInput_.append(nextChar);
if (rememberPosition) {
- this.positionRemembered_ = this.accruedInput_.getLength();
- this.originalPosition_ = this.positionRemembered_;
+ this.originalPosition_ = this.accruedInput_.getLength();
}
// We do formatting on-the-fly only when each character entered is either a
- // plus sign or a digit.
- if (!i18n.phonenumbers.PhoneNumberUtil.VALID_START_CHAR_PATTERN
- .test(nextChar)) {
+ // digit, or a plus sign (accepted at the start of the number only).
+ if (!this.isDigitOrLeadingPlusSign_(nextChar)) {
this.ableToFormat_ = false;
+ this.inputHasFormatting_ = true;
+ } else {
+ nextChar = this.normalizeAndAccrueDigitsAndPlusSign_(nextChar,
+ rememberPosition);
}
if (!this.ableToFormat_) {
- this.resetPositionOnFailureToFormat_();
+ // When we are unable to format because of reasons other than that
+ // formatting chars have been entered, it can be due to really long IDDs or
+ // NDDs. If that is the case, we might be able to do formatting again after
+ // extracting them.
+ if (this.inputHasFormatting_) {
+ return this.accruedInput_.toString();
+ } else if (this.attemptToExtractIdd_()) {
+ if (this.attemptToExtractCountryCallingCode_()) {
+ return this.attemptToChoosePatternWithPrefixExtracted_();
+ }
+ } else if (this.ableToExtractLongerNdd_()) {
+ // Add an additional space to separate long NDD and national significant
+ // number for readability. We don't set shouldAddSpaceAfterNationalPrefix_
+ // to true, since we don't want this to change later when we choose
+ // formatting templates.
+ this.prefixBeforeNationalNumber_.append(
+ i18n.phonenumbers.AsYouTypeFormatter.
+ SEPARATOR_BEFORE_NATIONAL_NUMBER_);
+ return this.attemptToChoosePatternWithPrefixExtracted_();
+ }
return this.accruedInput_.toString();
}
- nextChar = this.normalizeAndAccrueDigitsAndPlusSign_(nextChar);
-
- // We start to attempt to format only when at least 6 digits (the plus sign is
- // counted as a digit as well for this purpose) have been entered.
+ // We start to attempt to format only when at least MIN_LEADING_DIGITS_LENGTH
+ // digits (the plus sign is counted as a digit as well for this purpose) have
+ // been entered.
switch (this.accruedInputWithoutFormatting_.getLength()) {
- case 0: // this is the case where the first few inputs are neither digits nor
- // the plus sign.
- case 1:
- case 2:
- case 3:
- case 4:
- case 5:
- return this.accruedInput_.toString();
- case 6:
- if (!this.extractIddAndValidCountryCode_()) {
- this.ableToFormat_ = false;
+ case 0:
+ case 1:
+ case 2:
return this.accruedInput_.toString();
- }
- this.removeNationalPrefixFromNationalNumber_();
- return this.attemptToChooseFormattingPattern_(rememberPosition);
- default:
- if (this.nationalNumber_.getLength() > 4) {
- // The formatting pattern is already chosen.
+ case 3:
+ if (this.attemptToExtractIdd_()) {
+ this.isExpectingCountryCallingCode_ = true;
+ } else {
+ // No IDD or plus sign is found, might be entering in national format.
+ this.extractedNationalPrefix_ =
+ this.removeNationalPrefixFromNationalNumber_();
+ return this.attemptToChooseFormattingPattern_();
+ }
+ default:
+ if (this.isExpectingCountryCallingCode_) {
+ if (this.attemptToExtractCountryCallingCode_()) {
+ this.isExpectingCountryCallingCode_ = false;
+ }
+ return this.prefixBeforeNationalNumber_.toString() +
+ this.nationalNumber_.toString();
+ }
+ if (this.possibleFormats_.length > 0) {
+ // The formatting patterns are already chosen.
+ /** @type {string} */
+ var tempNationalNumber = this.inputDigitHelper_(nextChar);
+ // See if the accrued digits can be formatted properly already. If not,
+ // use the results from inputDigitHelper, which does formatting based on
+ // the formatting pattern chosen.
+ /** @type {string} */
+ var formattedNumber = this.attemptToFormatAccruedDigits_();
+ if (formattedNumber.length > 0) {
+ return formattedNumber;
+ }
+ this.narrowDownPossibleFormats_(this.nationalNumber_.toString());
+ if (this.maybeCreateNewTemplate_()) {
+ return this.inputAccruedNationalNumber_();
+ }
+ return this.ableToFormat_ ?
+ this.appendNationalNumber_(tempNationalNumber) :
+ this.accruedInput_.toString();
+ } else {
+ return this.attemptToChooseFormattingPattern_();
+ }
+ }
+};
+
+
+/**
+ * @return {string}
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.prototype.
+ attemptToChoosePatternWithPrefixExtracted_ = function() {
+
+ this.ableToFormat_ = true;
+ this.isExpectingCountryCallingCode_ = false;
+ this.possibleFormats_ = [];
+ this.lastMatchPosition_ = 0;
+ this.formattingTemplate_.clear();
+ this.currentFormattingPattern_ = '';
+ return this.attemptToChooseFormattingPattern_();
+};
+
+
+/**
+ * @return {string}
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.prototype.getExtractedNationalPrefix_ =
+ function() {
+ return this.extractedNationalPrefix_;
+};
+
+
+/**
+ * Some national prefixes are a substring of others. If extracting the shorter
+ * NDD doesn't result in a number we can format, we try to see if we can extract
+ * a longer version here.
+ * @return {boolean}
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.prototype.ableToExtractLongerNdd_ =
+ function() {
+ if (this.extractedNationalPrefix_.length > 0) {
+ // Put the extracted NDD back to the national number before attempting to
+ // extract a new NDD.
+ /** @type {string} */
+ var nationalNumberStr = this.nationalNumber_.toString();
+ this.nationalNumber_.clear();
+ this.nationalNumber_.append(this.extractedNationalPrefix_);
+ this.nationalNumber_.append(nationalNumberStr);
+ // Remove the previously extracted NDD from prefixBeforeNationalNumber. We
+ // cannot simply set it to empty string because people sometimes incorrectly
+ // enter national prefix after the country code, e.g. +44 (0)20-1234-5678.
+ /** @type {string} */
+ var prefixBeforeNationalNumberStr =
+ this.prefixBeforeNationalNumber_.toString();
+ /** @type {number} */
+ var indexOfPreviousNdd = prefixBeforeNationalNumberStr.lastIndexOf(
+ this.extractedNationalPrefix_);
+ this.prefixBeforeNationalNumber_.clear();
+ this.prefixBeforeNationalNumber_.append(
+ prefixBeforeNationalNumberStr.substring(0, indexOfPreviousNdd));
+ }
+ return this.extractedNationalPrefix_ !=
+ this.removeNationalPrefixFromNationalNumber_();
+};
+
+
+/**
+ * @param {string} nextChar
+ * @return {boolean}
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.prototype.isDigitOrLeadingPlusSign_ =
+ function(nextChar) {
+ return i18n.phonenumbers.PhoneNumberUtil.CAPTURING_DIGIT_PATTERN
+ .test(nextChar) ||
+ (this.accruedInput_.getLength() == 1 &&
+ i18n.phonenumbers.PhoneNumberUtil.PLUS_CHARS_PATTERN.test(nextChar));
+};
+
+
+/**
+ * Check to see if there is an exact pattern match for these digits. If so, we
+ * should use this instead of any other formatting template whose
+ * leadingDigitsPattern also matches the input.
+ * @return {string}
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.prototype.attemptToFormatAccruedDigits_ =
+ function() {
+
+ /** @type {string} */
+ var nationalNumber = this.nationalNumber_.toString();
+ /** @type {number} */
+ var possibleFormatsLength = this.possibleFormats_.length;
+ for (var i = 0; i < possibleFormatsLength; ++i) {
+ /** @type {i18n.phonenumbers.NumberFormat} */
+ var numberFormat = this.possibleFormats_[i];
+ /** @type {string} */
+ var pattern = numberFormat.getPatternOrDefault();
+ /** @type {RegExp} */
+ var patternRegExp = new RegExp('^(?:' + pattern + ')$');
+ if (patternRegExp.test(nationalNumber)) {
+ this.shouldAddSpaceAfterNationalPrefix_ =
+ i18n.phonenumbers.AsYouTypeFormatter.
+ NATIONAL_PREFIX_SEPARATORS_PATTERN_.test(
+ numberFormat.getNationalPrefixFormattingRule());
/** @type {string} */
- var temp = this.inputDigitHelper_(nextChar, rememberPosition);
- return this.ableToFormat_ ?
- this.prefixBeforeNationalNumber_.toString() + temp : temp;
- } else {
- return this.attemptToChooseFormattingPattern_(rememberPosition);
+ var formattedNumber = nationalNumber.replace(new RegExp(pattern, 'g'),
+ numberFormat.getFormat());
+ return this.appendNationalNumber_(formattedNumber);
}
}
+ return '';
};
+
/**
+ * Combines the national number with any prefix (IDD/+ and country code or
+ * national prefix) that was collected. A space will be inserted between them if
+ * the current formatting template indicates this to be suitable.
+ * @param {string} nationalNumber The number to be appended.
+ * @return {string} The combined number.
* @private
*/
-i18n.phonenumbers.AsYouTypeFormatter.prototype.resetPositionOnFailureToFormat_ =
- function() {
-
- if (this.positionRemembered_ > 0) {
- this.positionRemembered_ = this.originalPosition_;
- this.currentOutput_.clear();
+i18n.phonenumbers.AsYouTypeFormatter.prototype.appendNationalNumber_ =
+ function(nationalNumber) {
+ /** @type {number} */
+ var prefixBeforeNationalNumberLength =
+ this.prefixBeforeNationalNumber_.getLength();
+ if (this.shouldAddSpaceAfterNationalPrefix_ &&
+ prefixBeforeNationalNumberLength > 0 &&
+ this.prefixBeforeNationalNumber_.toString().charAt(
+ prefixBeforeNationalNumberLength - 1) !=
+ i18n.phonenumbers.AsYouTypeFormatter.SEPARATOR_BEFORE_NATIONAL_NUMBER_) {
+ // We want to add a space after the national prefix if the national prefix
+ // formatting rule indicates that this would normally be done, with the
+ // exception of the case where we already appended a space because the NDD
+ // was surprisingly long.
+ return this.prefixBeforeNationalNumber_ +
+ i18n.phonenumbers.AsYouTypeFormatter.SEPARATOR_BEFORE_NATIONAL_NUMBER_ +
+ nationalNumber;
+ } else {
+ return this.prefixBeforeNationalNumber_ + nationalNumber;
}
};
+
/**
* Returns the current position in the partially formatted phone number of the
* character which was previously passed in as the parameter of
- * inputDigitAndRememberPosition().
+ * {@link #inputDigitAndRememberPosition}.
*
* @return {number}
*/
i18n.phonenumbers.AsYouTypeFormatter.prototype.getRememberedPosition =
- function() {
+ function() {
- return this.positionRemembered_;
+ if (!this.ableToFormat_) {
+ return this.originalPosition_;
+ }
+ /** @type {number} */
+ var accruedInputIndex = 0;
+ /** @type {number} */
+ var currentOutputIndex = 0;
+ /** @type {string} */
+ var accruedInputWithoutFormatting =
+ this.accruedInputWithoutFormatting_.toString();
+ /** @type {string} */
+ var currentOutput = this.currentOutput_.toString();
+ while (accruedInputIndex < this.positionToRemember_ &&
+ currentOutputIndex < currentOutput.length) {
+ if (accruedInputWithoutFormatting.charAt(accruedInputIndex) ==
+ currentOutput.charAt(currentOutputIndex)) {
+ accruedInputIndex++;
+ }
+ currentOutputIndex++;
+ }
+ return currentOutputIndex;
};
+
/**
* Attempts to set the formatting template and returns a string which contains
* the formatted version of the digits entered so far.
*
- * @param {boolean} rememberPosition
* @return {string}
* @private
*/
i18n.phonenumbers.AsYouTypeFormatter.prototype.
- attemptToChooseFormattingPattern_ = function(rememberPosition) {
+ attemptToChooseFormattingPattern_ = function() {
/** @type {string} */
var nationalNumber = this.nationalNumber_.toString();
- /** @type {number} */
- var nationalNumberLength = nationalNumber.length;
- // We start to attempt to format only when as least 4 digits of national
- // number (excluding national prefix) have been entered.
- if (nationalNumberLength >= 4) {
- this.chooseFormatAndCreateTemplate_(nationalNumber.substring(0, 4));
- return this.inputAccruedNationalNumber_(rememberPosition);
- } else {
- if (rememberPosition) {
- this.positionRemembered_ =
- this.prefixBeforeNationalNumber_.length() + nationalNumberLength;
+ // We start to attempt to format only when at least MIN_LEADING_DIGITS_LENGTH
+ // digits of national number (excluding national prefix) have been entered.
+ if (nationalNumber.length >=
+ i18n.phonenumbers.AsYouTypeFormatter.MIN_LEADING_DIGITS_LENGTH_) {
+ this.getAvailableFormats_(nationalNumber);
+ // See if the accrued digits can be formatted properly already.
+ var formattedNumber = this.attemptToFormatAccruedDigits_();
+ if (formattedNumber.length > 0) {
+ return formattedNumber;
}
- return this.prefixBeforeNationalNumber_.toString() +
- this.nationalNumber_.toString();
+ return this.maybeCreateNewTemplate_() ?
+ this.inputAccruedNationalNumber_() : this.accruedInput_.toString();
+ } else {
+ return this.appendNationalNumber_(nationalNumber);
}
};
+
/**
* Invokes inputDigitHelper on each digit of the national number accrued, and
* returns a formatted string in the end.
*
- * @param {boolean} rememberPosition
* @return {string}
* @private
*/
i18n.phonenumbers.AsYouTypeFormatter.prototype.inputAccruedNationalNumber_ =
- function(rememberPosition) {
+ function() {
+ /** @type {string} */
+ var nationalNumber = this.nationalNumber_.toString();
/** @type {number} */
- var lengthOfNationalNumber = this.nationalNumber_.getLength();
+ var lengthOfNationalNumber = nationalNumber.length;
if (lengthOfNationalNumber > 0) {
- // The positionRemembered should be only adjusted once in the loop that
- // follows.
- /** @type {boolean} */
- var positionAlreadyAdjusted = false;
/** @type {string} */
var tempNationalNumber = '';
for (var i = 0; i < lengthOfNationalNumber; i++) {
tempNationalNumber =
- this.inputDigitHelper_(this.nationalNumber_.toString().charAt(i),
- rememberPosition);
- if (!positionAlreadyAdjusted &&
- this.positionRemembered_ -
- this.prefixBeforeNationalNumber_.getLength() == i + 1) {
- this.positionRemembered_ =
- this.prefixBeforeNationalNumber_.getLength() +
- tempNationalNumber.length;
- positionAlreadyAdjusted = true;
- }
+ this.inputDigitHelper_(nationalNumber.charAt(i));
}
return this.ableToFormat_ ?
- this.prefixBeforeNationalNumber_.toString() + tempNationalNumber :
- tempNationalNumber;
+ this.appendNationalNumber_(tempNationalNumber) :
+ this.accruedInput_.toString();
} else {
- if (rememberPosition) {
- this.positionRemembered_ = this.prefixBeforeNationalNumber_.length();
- }
return this.prefixBeforeNationalNumber_.toString();
}
};
+
+/**
+ * @return {boolean} true if the current country is a NANPA country and the
+ * national number begins with the national prefix.
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.prototype.
+ isNanpaNumberWithNationalPrefix_ = function() {
+ // For NANPA numbers beginning with 1[2-9], treat the 1 as the national
+ // prefix. The reason is that national significant numbers in NANPA always
+ // start with [2-9] after the national prefix. Numbers beginning with 1[01]
+ // can only be short/emergency numbers, which don't need the national prefix.
+ if (this.currentMetadata_.getCountryCode() != 1) {
+ return false;
+ }
+ /** @type {string} */
+ var nationalNumber = this.nationalNumber_.toString();
+ return (nationalNumber.charAt(0) == '1') &&
+ (nationalNumber.charAt(1) != '0') &&
+ (nationalNumber.charAt(1) != '1');
+};
+
+
/**
+ * Returns the national prefix extracted, or an empty string if it is not
+ * present.
+ * @return {string}
* @private
*/
i18n.phonenumbers.AsYouTypeFormatter.prototype.
- removeNationalPrefixFromNationalNumber_ = function() {
+ removeNationalPrefixFromNationalNumber_ = function() {
/** @type {string} */
var nationalNumber = this.nationalNumber_.toString();
/** @type {number} */
var startOfNationalNumber = 0;
- if (this.currentMetaData_.getCountryCode() == 1 &&
- nationalNumber.charAt(0) == '1') {
+ if (this.isNanpaNumberWithNationalPrefix_()) {
startOfNationalNumber = 1;
- this.prefixBeforeNationalNumber_.append('1 ');
- // Since a space is inserted after the national prefix in this case, we
- // increase the remembered position by 1 for anything that is after the
- // national prefix.
- if (this.positionRemembered_ >
- this.prefixBeforeNationalNumber_.getLength() - 1) {
- this.positionRemembered_++;
- }
- } else if (this.currentMetaData_.hasNationalPrefix()) {
+ this.prefixBeforeNationalNumber_.append('1').append(
+ i18n.phonenumbers.AsYouTypeFormatter.SEPARATOR_BEFORE_NATIONAL_NUMBER_);
+ this.isCompleteNumber_ = true;
+ } else if (this.currentMetadata_.hasNationalPrefixForParsing()) {
+ /** @type {RegExp} */
+ var nationalPrefixForParsing = new RegExp(
+ '^(?:' + this.currentMetadata_.getNationalPrefixForParsing() + ')');
/** @type {Array.<string>} */
- var m = nationalNumber.match(this.nationalPrefixForParsing_);
+ var m = nationalNumber.match(nationalPrefixForParsing);
+ // Since some national prefix patterns are entirely optional, check that a
+ // national prefix could actually be extracted.
if (m != null && m[0] != null && m[0].length > 0) {
+ // When the national prefix is detected, we use international formatting
+ // rules instead of national ones, because national formatting rules could
+ // contain local formatting rules for numbers entered without area code.
+ this.isCompleteNumber_ = true;
startOfNationalNumber = m[0].length;
this.prefixBeforeNationalNumber_.append(nationalNumber.substring(0,
startOfNationalNumber));
}
this.nationalNumber_.clear();
this.nationalNumber_.append(nationalNumber.substring(startOfNationalNumber));
+ return nationalNumber.substring(0, startOfNationalNumber);
};
+
/**
- * Extracts IDD, plus sign and country code to prefixBeforeNationalNumber when
- * they are available, and places the remaining input into nationalNumber.
+ * Extracts IDD and plus sign to prefixBeforeNationalNumber when they are
+ * available, and places the remaining input into nationalNumber.
*
- * @return {boolean} false when accruedInputWithoutFormatting begins with the
- * plus sign or valid IDD for defaultCountry, but the sequence of digits
- * after that does not form a valid country code. It returns true for all
- * other cases.
+ * @return {boolean} true when accruedInputWithoutFormatting begins with the
+ * plus sign or valid IDD for defaultCountry.
* @private
*/
-i18n.phonenumbers.AsYouTypeFormatter.prototype.extractIddAndValidCountryCode_ =
- function() {
+i18n.phonenumbers.AsYouTypeFormatter.prototype.attemptToExtractIdd_ =
+ function() {
/** @type {string} */
var accruedInputWithoutFormatting =
this.accruedInputWithoutFormatting_.toString();
- this.nationalNumber_.clear();
+ /** @type {RegExp} */
+ var internationalPrefix = new RegExp(
+ '^(?:' + '\\' + i18n.phonenumbers.PhoneNumberUtil.PLUS_SIGN + '|' +
+ this.currentMetadata_.getInternationalPrefix() + ')');
/** @type {Array.<string>} */
- var m = accruedInputWithoutFormatting.match(this.internationalPrefix_);
+ var m = accruedInputWithoutFormatting.match(internationalPrefix);
if (m != null && m[0] != null && m[0].length > 0) {
- this.isInternationalFormatting_ = true;
- /** @type {number} */
- var startOfCountryCode = m[0].length;
- /** @type {!goog.string.StringBuffer} */
- var numberIncludeCountryCode = new goog.string.StringBuffer(
- accruedInputWithoutFormatting.substring(startOfCountryCode));
+ this.isCompleteNumber_ = true;
/** @type {number} */
- var countryCode = this.phoneUtil_.extractCountryCode(
- numberIncludeCountryCode, this.nationalNumber_);
- if (countryCode == 0) {
- return false;
- } else {
- /** @type {string} */
- var newRegionCode =
- this.phoneUtil_.getRegionCodeForCountryCode(countryCode);
- if (newRegionCode != this.defaultCountry_) {
- this.initializeCountrySpecificInfo_(newRegionCode);
- }
- this.prefixBeforeNationalNumber_.append(accruedInputWithoutFormatting
- .substring(0, startOfCountryCode));
- if (accruedInputWithoutFormatting.charAt(0) !=
- i18n.phonenumbers.PhoneNumberUtil.PLUS_SIGN) {
- if (this.positionRemembered_ >
- this.prefixBeforeNationalNumber_.getLength()) {
- // Since a space will be inserted in front of the country code in this
- // case, we increase the remembered position by 1.
- this.positionRemembered_++;
- }
- this.prefixBeforeNationalNumber_.append(' ');
- }
- /** @type {string} */
- var countryCodeString = '' + countryCode;
- if (this.positionRemembered_ >
- this.prefixBeforeNationalNumber_.getLength() +
- countryCodeString.length) {
- // Since a space will be inserted after the country code in this case,
- // we increase the remembered position by 1.
- this.positionRemembered_++;
- }
- this.prefixBeforeNationalNumber_.append(countryCodeString).append(' ');
- }
- } else {
+ var startOfCountryCallingCode = m[0].length;
this.nationalNumber_.clear();
- this.nationalNumber_.append(accruedInputWithoutFormatting);
+ this.nationalNumber_.append(
+ accruedInputWithoutFormatting.substring(startOfCountryCallingCode));
+ this.prefixBeforeNationalNumber_.clear();
+ this.prefixBeforeNationalNumber_.append(
+ accruedInputWithoutFormatting.substring(0, startOfCountryCallingCode));
+ if (accruedInputWithoutFormatting.charAt(0) !=
+ i18n.phonenumbers.PhoneNumberUtil.PLUS_SIGN) {
+ this.prefixBeforeNationalNumber_.append(
+ i18n.phonenumbers.AsYouTypeFormatter.
+ SEPARATOR_BEFORE_NATIONAL_NUMBER_);
+ }
+ return true;
+ }
+ return false;
+};
+
+
+/**
+ * Extracts the country calling code from the beginning of nationalNumber to
+ * prefixBeforeNationalNumber when they are available, and places the remaining
+ * input into nationalNumber.
+ *
+ * @return {boolean} true when a valid country calling code can be found.
+ * @private
+ */
+i18n.phonenumbers.AsYouTypeFormatter.prototype.
+ attemptToExtractCountryCallingCode_ = function() {
+
+ if (this.nationalNumber_.getLength() == 0) {
+ return false;
+ }
+ /** @type {!goog.string.StringBuffer} */
+ var numberWithoutCountryCallingCode = new goog.string.StringBuffer();
+ /** @type {number} */
+ var countryCode = this.phoneUtil_.extractCountryCode(
+ this.nationalNumber_, numberWithoutCountryCallingCode);
+ if (countryCode == 0) {
+ return false;
}
+ this.nationalNumber_.clear();
+ this.nationalNumber_.append(numberWithoutCountryCallingCode.toString());
+ /** @type {string} */
+ var newRegionCode = this.phoneUtil_.getRegionCodeForCountryCode(countryCode);
+ if (i18n.phonenumbers.PhoneNumberUtil.REGION_CODE_FOR_NON_GEO_ENTITY ==
+ newRegionCode) {
+ this.currentMetadata_ =
+ this.phoneUtil_.getMetadataForNonGeographicalRegion(countryCode);
+ } else if (newRegionCode != this.defaultCountry_) {
+ this.currentMetadata_ = this.getMetadataForRegion_(newRegionCode);
+ }
+ /** @type {string} */
+ var countryCodeString = '' + countryCode;
+ this.prefixBeforeNationalNumber_.append(countryCodeString).append(
+ i18n.phonenumbers.AsYouTypeFormatter.SEPARATOR_BEFORE_NATIONAL_NUMBER_);
+ // When we have successfully extracted the IDD, the previously extracted NDD
+ // should be cleared because it is no longer valid.
+ this.extractedNationalPrefix_ = '';
return true;
};
+
/**
* Accrues digits and the plus sign to accruedInputWithoutFormatting for later
* use. If nextChar contains a digit in non-ASCII format (e.g. the full-width
* version of digits), it is first normalized to the ASCII version. The return
* value is nextChar itself, or its normalized version, if nextChar is a digit
- * in non-ASCII format.
+ * in non-ASCII format. This method assumes its input is either a digit or the
+ * plus sign.
*
* @param {string} nextChar
+ * @param {boolean} rememberPosition
* @return {string}
* @private
*/
i18n.phonenumbers.AsYouTypeFormatter.prototype.
- normalizeAndAccrueDigitsAndPlusSign_ = function(nextChar) {
+ normalizeAndAccrueDigitsAndPlusSign_ = function(nextChar,
+ rememberPosition) {
+ /** @type {string} */
+ var normalizedChar;
if (nextChar == i18n.phonenumbers.PhoneNumberUtil.PLUS_SIGN) {
+ normalizedChar = nextChar;
this.accruedInputWithoutFormatting_.append(nextChar);
+ } else {
+ normalizedChar = i18n.phonenumbers.PhoneNumberUtil.DIGIT_MAPPINGS[nextChar];
+ this.accruedInputWithoutFormatting_.append(normalizedChar);
+ this.nationalNumber_.append(normalizedChar);
}
-
- if (nextChar in i18n.phonenumbers.PhoneNumberUtil.DIGIT_MAPPINGS) {
- nextChar = i18n.phonenumbers.PhoneNumberUtil.DIGIT_MAPPINGS[nextChar];
- this.accruedInputWithoutFormatting_.append(nextChar);
- this.nationalNumber_.append(nextChar);
+ if (rememberPosition) {
+ this.positionToRemember_ = this.accruedInputWithoutFormatting_.getLength();
}
- return nextChar;
+ return normalizedChar;
};
+
/**
* @param {string} nextChar
- * @param {boolean} rememberPosition
* @return {string}
* @private
*/
i18n.phonenumbers.AsYouTypeFormatter.prototype.inputDigitHelper_ =
- function(nextChar, rememberPosition) {
+ function(nextChar) {
- if (!(nextChar in i18n.phonenumbers.PhoneNumberUtil.DIGIT_MAPPINGS)) {
- return this.currentOutput_.toString();
- }
-
- /** @type {string} */
- var currentOutput = this.currentOutput_.toString();
/** @type {string} */
- var currentOutput2 = currentOutput.substring(this.lastMatchPosition_);
- /** @type {number} */
- var digitPatternStart = currentOutput2.search(this.digitPattern_);
- if (digitPatternStart >= 0) {
- this.currentOutput_ = new goog.string.StringBuffer(
- currentOutput.substring(0, this.lastMatchPosition_) +
- currentOutput2.replace(this.digitPattern_, nextChar));
- this.lastMatchPosition_ += digitPatternStart;
- if (rememberPosition) {
- this.positionRemembered_ = this.prefixBeforeNationalNumber_.getLength() +
- this.lastMatchPosition_ + 1;
- }
- return this.currentOutput_.toString()
- .substring(0, this.lastMatchPosition_ + 1);
+ var formattingTemplate = this.formattingTemplate_.toString();
+ if (formattingTemplate.substring(this.lastMatchPosition_)
+ .search(this.DIGIT_PATTERN_) >= 0) {
+ /** @type {number} */
+ var digitPatternStart = formattingTemplate.search(this.DIGIT_PATTERN_);
+ /** @type {string} */
+ var tempTemplate =
+ formattingTemplate.replace(this.DIGIT_PATTERN_, nextChar);
+ this.formattingTemplate_.clear();
+ this.formattingTemplate_.append(tempTemplate);
+ this.lastMatchPosition_ = digitPatternStart;
+ return tempTemplate.substring(0, this.lastMatchPosition_ + 1);
} else {
- // More digits are entered than we could handle.
- this.currentOutput_.append(nextChar);
- this.ableToFormat_ = false;
- this.resetPositionOnFailureToFormat_();
+ if (this.possibleFormats_.length == 1) {
+ // More digits are entered than we could handle, and there are no other
+ // valid patterns to try.
+ this.ableToFormat_ = false;
+ } // else, we just reset the formatting pattern.
+ this.currentFormattingPattern_ = '';
return this.accruedInput_.toString();
}
};