Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

O métodonormalize() retorna a Forma de Normalização Unicode (Unicode Normalization Form) de uma dada string (se o valor não é uma string, ele será convertido para uma primeiramente).

Sintaxe

str.normalize([form])

Parâmetros

form
Um dentre os seguintes valores: "NFC", "NFD", "NFKC", ou "NFKD", especificando o formato de normalização. Se o valor for omitido ou  undefined, "NFC" é utilizado.
  • NFC — Formato de Normalização Canônico de Composição. 
  • NFD — Formato de Normalização Canônico de Decomposição.
  • NFKC — Formato de Normalização de Compatibilidade de Composição.
  • NFKD — Formato de Normalização de Compatibilidade de Decomposição.

Retorno

Uma string contendo a Forma de Normalização Unicode da string dada.

Erros lançados

RangeError
Em erro RangeError é lançado seform não é um dos valores especificados acima.

Descrição

O métodonormalize() retorna a Forma de Normalização Unicode (Unicode Normalization Form) de uma dada string. Este método não afeta o conteúdo da string.

Examples

Utilizando normalize()

// String Inicial

// U+1E9B: CARACTERE LATINO - LETRA S COMPRIDA COM PONTO ACIMA
// U+0323: COMBINANDO PONTO ABAIXO
var str = '\u1E9B\u0323';


// Formato de Normalização Canônico de Composição (NFC)

// U+1E9B: CARACTERE LATINO - LETRA S COMPRIDA COM PONTO ACIMA 
// U+0323: COMBINANDO PONTO ABAIXO
str.normalize('NFC'); // '\u1E9B\u0323'
str.normalize();      // igual à linha de cima


// Formato de Normalização Canônico de Decomposição (NFD)

// U+017F: CARACTERE LATINO - LETRA S COMPRIDA
// U+0323: COMBINANDO PONTO ABAIXO
// U+0307: COMBINANDO PONTO ACIMA
str.normalize('NFD'); // '\u017F\u0323\u0307'


// Formato de Normalização de Compatibilidade de Composição. (NFKC)

// U+1E69: CARACTERE LATINO - LETRA S COMPRIDA COM PONTO ACIMA E ABAIXO
str.normalize('NFKC'); // '\u1E69'


// Formato de Normalização de Compatibilidade de Decomposição (NFKD)

// U+0073: CARACTERE LATINO - LETRA S COMPRIDA
// U+0323: COMBINANDO PONTO ABAIXO 
// U+0307: COMBINANDO PONTO ACIMA
str.normalize('NFKD'); // '\u0073\u0323\u0307'

Especificações

Especificação Status Comentário
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'String.prototype.normalize' in that specification.
Padrão Definição inicial.
ECMAScript Latest Draft (ECMA-262)
The definition of 'String.prototype.normalize' in that specification.
Padrão em tempo real  

Compatibilidade com navegadores

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic Support34 (Yes)31 No (Yes)10
FeatureAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic Support No34 (Yes) No No (Yes)10

Veja também

Etiquetas do documento e colaboradores

 Colaboradores desta página: andrefranca92
 Última atualização por: andrefranca92,