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.
Rascunho  

Compatibilidade com navegadores

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung InternetNode.js
Basic supportChrome Full support 34Edge Full support YesFirefox Full support 31IE No support NoOpera Full support YesSafari Full support 10WebView Android No support NoChrome Android Full support 34Edge Mobile Full support YesFirefox Android Full support 31Opera Android Full support YesSafari iOS Full support 10Samsung Internet Android Full support Yesnodejs Full support 0.12

Legend

Full support  
Full support
No support  
No support

Veja também

Etiquetas do documento e colaboradores

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