Método localeCompare() da String JavaScript

definição e uso

localeCompare() o método compara duas strings no ambiente de idioma atual.

localeCompare() o método retorna a ordem de classificação -1e1 ou 0（representando antes, depois ou igual).

O ambiente de idioma atual é baseado nas configurações de idioma do navegador.

Exemplo

Exemplo 1

Comparar "ab" e "cd":

let text1 = "ab";
let text2 = "cd";
let result = text1.localeCompare(text2);

Experimente você mesmo

Exemplo 2

let text1 = "cd";
let text2 = "ab";
let result = text1.localeCompare(text2);

Experimente você mesmo

Exemplo 3

let text1 = "ab";
let text2 = "ab";
let result = text1.localeCompare(text2);

Exemplo 4

Experimente você mesmo

let text1 = "A";
let text2 = "a";
let result = text1.localeCompare(text2);

Experimente você mesmo

sintaxe

string.localeCompare(target)

parâmetro

parâmetro descrição
target obrigatório. A string a ser comparada.

valor de retorno

tipo descrição
número

um dos 3 valores:

  • -1, se a string for ordenada antes do target
  • 　0, se as duas strings forem iguais
  • 　1, se a string for ordenada após o target

detalhes técnicos

valor de retorno

retorna o número que descreve o resultado da comparação.

se string menor targetentão localeCompare() retorna um número menor que 0.

se string maior targetentão o método retorna um número maior que 0.

Se duas strings forem iguais ou não diferirem de acordo com as regras de ordenação local, o método retorna 0.

esclarecimento

colocar < e > Os operadores aplicados a strings usam apenas a codificação Unicode dos caracteres para comparar strings, sem considerar as regras de ordenação local. A ordem gerada dessa maneira pode não ser correta. Por exemplo, no espanhol, os caracteres “ch” geralmente são ordenados entre os caracteres “c” e “d”.

localeCompare() O método fornecido compara strings considerando as regras de ordenação local padrão. O padrão ECMAscript não define como realizar operações de comparação específicas da localidade, ele apenas determina que a função deve usar as regras de ordenação fornecidas pelo sistema operacional subjacente.

suporte do navegador

localeCompare() é uma característica do ECMAScript1 (ES1).

Todos os navegadores suportam completamente o ES1 (JavaScript de 1997):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Suporte Suporte Suporte Suporte Suporte Suporte

Páginas relacionadas

String JavaScript

Métodos da String JavaScript

Pesquisa de String JavaScript