blob: 9ce9ee0321620183354754ab092302a345c2816c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
---
title: String.prototype.normalize()
slug: Web/JavaScript/Reference/Global_Objects/String/normalize
tags:
- Cadena
- ECMAScript 2015
- JavaScript
- Prototipo
- Referencia
- String
- Unicode
- metodo
translation_of: Web/JavaScript/Reference/Global_Objects/String/normalize
original_slug: Web/JavaScript/Referencia/Objetos_globales/String/normalize
---
<div>{{JSRef}}</div>
<p>El método <strong><code>normalize()</code></strong> retorna la Forma de Normalización Unicode de la cadena dada (si el valor no es una cadena, primero será convertido a ese tipo).</p>
<h2 id="Sintaxis">Sintaxis</h2>
<pre class="syntaxbox"><code><var>str</var>.normalize([<var>form</var>])</code></pre>
<h3 id="Parámetros">Parámetros</h3>
<dl>
<dt><code>form</code></dt>
<dd>Uno de<code>"NFC"</code>, <code>"NFD"</code>, <code>"NFKC"</code>, o <code>"NFKD"</code>, especificando la Forma de Normalización Unicode. Si es omitida o {{jsxref("undefined")}}, se utiliza <code>"NFC"</code>.
<ul>
<li><code>NFC</code> — Forma de Normalización de Composición Canónica.</li>
<li><code>NFD</code> — Forma de Normalización de Descomposición Canónica.</li>
<li><code>NFKC</code> — Forma de Normalización de Composición de Compatibilidad.</li>
<li><code>NFKD</code> — Forma de Normalización de Descomposición de Compatibilidad.</li>
</ul>
</dd>
</dl>
<h3 id="Valor_de_retorno">Valor de retorno</h3>
<p>Una cadena que contiene la Forma de Normalización Unicode de la cadena dada.</p>
<h3 id="Errores_lanzados">Errores lanzados</h3>
<dl>
<dt>{{jsxref("RangeError")}}</dt>
<dd>Un error {{jsxref("RangeError")}} es lanzado si <code>form</code> no es uno de los valores especificados arriba.</dd>
</dl>
<h2 id="Descripción">Descripción</h2>
<p>El método <code>normalize()</code> retorna la Forma de Normalización Unicode de una cadena. No afecta el valor de la cadena en sí misma.</p>
<h2 id="Ejemplos">Ejemplos</h2>
<h3 id="Uso_de_normalize()">Uso de <code>normalize()</code></h3>
<pre class="brush: js">// Cadena inicial
// U+1E9B: LETRA S LATINA MINÚSCULA CON PUNTO ARRIBA
// U+0323: COMBINACIÓN CON PUNTO ABAJO
var str = '\u1E9B\u0323';
// Forma compuesta canónicamente (NFC)
// U+1E9B: LETRA S LATINA MINÚSCULA CON PUNTO ARRIBA
// U+0323: COMBINACIÓN CON PUNTO ABAJO
str.normalize('NFC'); // '\u1E9B\u0323'
str.normalize(); // lo mismo que arriba
// Forma canónicamente descompuesta (NFD)
// U+017F: LETRA S LATINA MINÚSCULA
// U+0323: COMBINACIÓN CON PUNTO ABAJO
// U+0307: COMBINACIÓN CON PUNTO ARRIBA
str.normalize('NFD'); // '\u017F\u0323\u0307'
// Compuesta con compatibilidad (NFKC)
// U+1E69: LETRA S LATINA MINÚSCULA CON PUNTO ARRIBA Y ABAJO
str.normalize('NFKC'); // '\u1E69'
// Descompuesta con compatibilidad (NFKD)
// U+0073: LETRA S LATINA MINÚSCULA
// U+0323: COMBINACIÓN CON PUNTO ABAJO
// U+0307: COMBINACIÓN CON PUNTO ARRIBA
str.normalize('NFKD'); // '\u0073\u0323\u0307'
</pre>
<h2 id="Especificaciones">Especificaciones</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Especificación</th>
<th scope="col">Estado</th>
<th scope="col">Comentario</th>
</tr>
<tr>
<td>{{SpecName('ES2015', '#sec-string.prototype.normalize', 'String.prototype.normalize')}}</td>
<td>{{Spec2('ES2015')}}</td>
<td>Definición inicial.</td>
</tr>
<tr>
<td>{{SpecName('ESDraft', '#sec-string.prototype.normalize', 'String.prototype.normalize')}}</td>
<td>{{Spec2('ESDraft')}}</td>
<td> </td>
</tr>
</tbody>
</table>
<h2 id="Compatibilidad_de_Navegadores">Compatibilidad de Navegadores</h2>
<p>{{Compat("javascript.builtins.String.normalize")}}</p>
<h2 id="Vea_también">Vea también</h2>
<ul>
<li><a href="http://www.unicode.org/reports/tr15/">Anexo del Estándar Unicode #15, Formas de Normalización Unicode</a></li>
<li><a href="http://en.wikipedia.org/wiki/Unicode_equivalence">Equivalencia Unicode</a></li>
</ul>
|
