JavaScript Guidebook

JavaScript 完全知识体系

String.prototype.localCompare()

localCompare() 方法返回一个数字来指示一个参考字符串是否在排序顺序前面或之后或与给定字符串相同。

语法

语法:

str.localCompare( compareString [, locales [, options ]])

类型声明:

interface String {
localeCompare(that: string): number;
localeCompare(that: string, locales?: string | string[], options?: Intl.CollatorOptions): number;
}

参数说明:

参数说明类型
compareString用于比较的字符串string
locales可选,用于表示一种或多种语言或区域的符合 BCP 47 标准的字符串或字符串数组。string
optionsobject

代码示例

检查浏览器对扩展参数的支持

localesoptions 参数还没有被所有浏览器所支持。检查是否被支持,使用 i 参数判断是否有异常 RangeError 抛出:

function localeCompareSupportsLocales() {
try {
'foo'.localeCompare('bar', 'i');
} catch (e) {
return e.name === 'RangeError';
}
return false;
}

参考资料