String.prototype.normalize()

Você está lendo a versão em inglês deste conteúdo porque ainda não há uma tradução para este idioma. Ajude-nos 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 AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
normalizeChrome Full support 34Edge Full support 12Firefox Full support 31IE No support NoOpera Full support YesSafari Full support 10WebView Android No support NoChrome Android Full support 34Firefox Android Full support 31Opera Android Full support YesSafari iOS Full support 10Samsung Internet Android Full support 2.0nodejs Full support 0.12

Legend

Full support  
Full support
No support  
No support

Veja também